@ticktockbent/charlotte 0.1.0 → 0.1.1
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.
- package/CHANGELOG.md +11 -0
- package/README.md +23 -10
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,17 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to Charlotte will be documented in this file.
|
|
4
4
|
|
|
5
|
+
## [0.1.1] - 2026-02-22
|
|
6
|
+
|
|
7
|
+
### Added
|
|
8
|
+
|
|
9
|
+
- **`get_cookies`** — Retrieve cookies for the active page with optional URL filtering. Returns cookie name, value, domain, path, and security flags.
|
|
10
|
+
- **`clear_cookies`** — Clear cookies from the browser with optional name filtering. Supports clearing all cookies or specific cookies by name.
|
|
11
|
+
|
|
12
|
+
### Fixed
|
|
13
|
+
|
|
14
|
+
- Session integration tests now use HTTP URLs for cookie operations (CDP requires http/https for `Network.deleteCookies`).
|
|
15
|
+
|
|
5
16
|
## [0.1.0] - 2026-02-13
|
|
6
17
|
|
|
7
18
|
Initial release. All six implementation phases complete.
|
package/README.md
CHANGED
|
@@ -10,7 +10,7 @@ Charlotte maintains a persistent headless Chromium session and acts as a transla
|
|
|
10
10
|
|
|
11
11
|
```
|
|
12
12
|
┌─────────────┐ MCP Protocol ┌──────────────────┐
|
|
13
|
-
│ AI Agent
|
|
13
|
+
│ AI Agent │<───────────────────> │ Charlotte │
|
|
14
14
|
└─────────────┘ │ │
|
|
15
15
|
│ ┌────────────┐ │
|
|
16
16
|
│ │ Renderer │ │
|
|
@@ -34,7 +34,7 @@ Agents receive landmarks, headings, interactive elements with typed metadata, bo
|
|
|
34
34
|
|
|
35
35
|
**Interaction** — `click`, `type`, `select`, `toggle`, `submit`, `scroll`, `hover`, `key`, `wait_for` (async condition polling)
|
|
36
36
|
|
|
37
|
-
**Session Management** — `tabs`, `tab_open`, `tab_switch`, `tab_close`, `viewport` (device presets), `network` (throttling, URL blocking), `set_cookies`, `set_headers`, `configure`
|
|
37
|
+
**Session Management** — `tabs`, `tab_open`, `tab_switch`, `tab_close`, `viewport` (device presets), `network` (throttling, URL blocking), `set_cookies`, `get_cookies`, `clear_cookies`, `set_headers`, `configure`
|
|
38
38
|
|
|
39
39
|
**Development Mode** — `dev_serve` (static server + file watching with auto-reload), `dev_inject` (CSS/JS injection), `dev_audit` (a11y, performance, SEO, contrast, broken links)
|
|
40
40
|
|
|
@@ -49,15 +49,18 @@ Agents receive landmarks, headings, interactive elements with typed metadata, bo
|
|
|
49
49
|
|
|
50
50
|
### Installation
|
|
51
51
|
|
|
52
|
+
Charlotte is published on npm as [`@ticktockbent/charlotte`](https://www.npmjs.com/package/@ticktockbent/charlotte):
|
|
53
|
+
|
|
52
54
|
```bash
|
|
53
|
-
|
|
54
|
-
cd charlotte
|
|
55
|
-
npm install
|
|
55
|
+
npm install -g @ticktockbent/charlotte
|
|
56
56
|
```
|
|
57
57
|
|
|
58
|
-
|
|
58
|
+
Or install from source:
|
|
59
59
|
|
|
60
60
|
```bash
|
|
61
|
+
git clone https://github.com/ticktockbent/charlotte.git
|
|
62
|
+
cd charlotte
|
|
63
|
+
npm install
|
|
61
64
|
npm run build
|
|
62
65
|
```
|
|
63
66
|
|
|
@@ -66,6 +69,10 @@ npm run build
|
|
|
66
69
|
Charlotte communicates over stdio using the MCP protocol:
|
|
67
70
|
|
|
68
71
|
```bash
|
|
72
|
+
# If installed globally
|
|
73
|
+
charlotte
|
|
74
|
+
|
|
75
|
+
# If installed from source
|
|
69
76
|
npm start
|
|
70
77
|
```
|
|
71
78
|
|
|
@@ -78,8 +85,8 @@ Add Charlotte to your MCP client configuration. For Claude Code, create `.mcp.js
|
|
|
78
85
|
"mcpServers": {
|
|
79
86
|
"charlotte": {
|
|
80
87
|
"type": "stdio",
|
|
81
|
-
"command": "
|
|
82
|
-
"args": ["/
|
|
88
|
+
"command": "npx",
|
|
89
|
+
"args": ["@ticktockbent/charlotte"],
|
|
83
90
|
"env": {}
|
|
84
91
|
}
|
|
85
92
|
}
|
|
@@ -92,8 +99,8 @@ For Claude Desktop, add to `claude_desktop_config.json`:
|
|
|
92
99
|
{
|
|
93
100
|
"mcpServers": {
|
|
94
101
|
"charlotte": {
|
|
95
|
-
"command": "
|
|
96
|
-
"args": ["/
|
|
102
|
+
"command": "npx",
|
|
103
|
+
"args": ["@ticktockbent/charlotte"]
|
|
97
104
|
}
|
|
98
105
|
}
|
|
99
106
|
}
|
|
@@ -241,6 +248,12 @@ dev_serve({ path: "tests/sandbox" })
|
|
|
241
248
|
|
|
242
249
|
Four pages cover navigation, forms, interactive elements, delayed content, scroll containers, and more. See [docs/sandbox.md](docs/sandbox.md) for the full page reference and a tool-by-tool exercise checklist.
|
|
243
250
|
|
|
251
|
+
## Roadmap
|
|
252
|
+
|
|
253
|
+
**Screenshot Artifacts** — Save screenshots as persistent file artifacts rather than only returning inline data, enabling agents to reference and manage captured images across sessions.
|
|
254
|
+
|
|
255
|
+
**Video Recording** — Record interactions as video, capturing the full sequence of agent-driven navigation and manipulation for debugging, documentation, and review.
|
|
256
|
+
|
|
244
257
|
## Full Specification
|
|
245
258
|
|
|
246
259
|
See [docs/CHARLOTTE_SPEC.md](docs/CHARLOTTE_SPEC.md) for the complete specification including all tool parameters, the page representation format, element identity strategy, and architecture details.
|