@dupecom/botcha 0.4.5 → 0.4.6
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/README.md +2 -83
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -19,15 +19,6 @@
|
|
|
19
19
|
📦 **npm:** [@dupecom/botcha](https://www.npmjs.com/package/@dupecom/botcha)
|
|
20
20
|
🔌 **OpenAPI:** [botcha.ai/openapi.json](https://botcha.ai/openapi.json)
|
|
21
21
|
|
|
22
|
-
## Packages
|
|
23
|
-
|
|
24
|
-
| Package | Description | Install |
|
|
25
|
-
|---------|-------------|---------|
|
|
26
|
-
| [`@dupecom/botcha`](https://www.npmjs.com/package/@dupecom/botcha) | Core library + Express middleware | `npm install @dupecom/botcha` |
|
|
27
|
-
| [`@dupecom/botcha-cli`](https://www.npmjs.com/package/@dupecom/botcha-cli) | CLI tool for testing & debugging | `npm install -g @dupecom/botcha-cli` |
|
|
28
|
-
| [`@dupecom/botcha-langchain`](https://www.npmjs.com/package/@dupecom/botcha-langchain) | LangChain integration for AI agents | `npm install @dupecom/botcha-langchain` |
|
|
29
|
-
| [`@dupecom/botcha-cloudflare`](./packages/cloudflare-workers) | Cloudflare Workers runtime | `npm install @dupecom/botcha-cloudflare` |
|
|
30
|
-
|
|
31
22
|
## Why?
|
|
32
23
|
|
|
33
24
|
CAPTCHAs ask "Are you human?" — **BOTCHA asks "Are you an AI?"**
|
|
@@ -189,30 +180,6 @@ const answers = botcha.solve([645234, 891023, 334521]);
|
|
|
189
180
|
6. ✅ Access granted
|
|
190
181
|
```
|
|
191
182
|
|
|
192
|
-
## Cloudflare Workers
|
|
193
|
-
|
|
194
|
-
For edge deployment, use the Cloudflare Workers package:
|
|
195
|
-
|
|
196
|
-
```bash
|
|
197
|
-
npm install @dupecom/botcha-cloudflare
|
|
198
|
-
```
|
|
199
|
-
|
|
200
|
-
```typescript
|
|
201
|
-
// Uses Hono + Web Crypto API (no Node.js dependencies)
|
|
202
|
-
import app from '@dupecom/botcha-cloudflare';
|
|
203
|
-
export default app;
|
|
204
|
-
```
|
|
205
|
-
|
|
206
|
-
Or deploy your own instance:
|
|
207
|
-
|
|
208
|
-
```bash
|
|
209
|
-
cd packages/cloudflare-workers
|
|
210
|
-
npm install
|
|
211
|
-
npm run deploy # Deploys to your Cloudflare account
|
|
212
|
-
```
|
|
213
|
-
|
|
214
|
-
The Workers package runs a v1 JWT-based flow and keeps legacy `/api/*` endpoints for backward compatibility. See [`packages/cloudflare-workers/README.md`](./packages/cloudflare-workers/README.md) for full docs.
|
|
215
|
-
|
|
216
183
|
## Philosophy
|
|
217
184
|
|
|
218
185
|
> "If a human writes a script to solve BOTCHA using an LLM... they've built an AI agent."
|
|
@@ -235,16 +202,6 @@ You can use the library freely, report issues, and discuss features. To contribu
|
|
|
235
202
|
|
|
236
203
|
**See [CONTRIBUTING.md](./.github/CONTRIBUTING.md) for complete guidelines, solver code examples, agent setup instructions, and detailed workflows.**
|
|
237
204
|
|
|
238
|
-
## License
|
|
239
|
-
|
|
240
|
-
MIT © [Ramin](https://github.com/i8ramin)
|
|
241
|
-
|
|
242
|
-
---
|
|
243
|
-
|
|
244
|
-
Built by [@i8ramin](https://dupe.com) and Choco 🐢
|
|
245
|
-
|
|
246
|
-
---
|
|
247
|
-
|
|
248
205
|
## Client SDK (for AI Agents)
|
|
249
206
|
|
|
250
207
|
If you're building an AI agent that needs to access BOTCHA-protected APIs, use the client SDK:
|
|
@@ -303,44 +260,6 @@ const answers = solveBotcha([123456, 789012]);
|
|
|
303
260
|
// Returns: ['a1b2c3d4', 'e5f6g7h8']
|
|
304
261
|
```
|
|
305
262
|
|
|
306
|
-
##
|
|
307
|
-
|
|
308
|
-
Test and debug BOTCHA-protected endpoints from the command line:
|
|
309
|
-
|
|
310
|
-
```bash
|
|
311
|
-
# Test an endpoint
|
|
312
|
-
npx @dupecom/botcha-cli test https://api.example.com/agent-only
|
|
313
|
-
|
|
314
|
-
# Benchmark performance
|
|
315
|
-
npx @dupecom/botcha-cli benchmark https://api.example.com/agent-only --iterations 100
|
|
316
|
-
|
|
317
|
-
# Check headers
|
|
318
|
-
npx @dupecom/botcha-cli headers https://api.example.com
|
|
319
|
-
```
|
|
320
|
-
|
|
321
|
-
See [`packages/cli/README.md`](./packages/cli/README.md) for full CLI documentation.
|
|
322
|
-
|
|
323
|
-
## LangChain Integration
|
|
324
|
-
|
|
325
|
-
Give your LangChain agents automatic BOTCHA-solving abilities:
|
|
326
|
-
|
|
327
|
-
```typescript
|
|
328
|
-
import { BotchaTool } from '@dupecom/botcha-langchain';
|
|
329
|
-
import { createReactAgent } from '@langchain/langgraph/prebuilt';
|
|
330
|
-
|
|
331
|
-
const agent = createReactAgent({
|
|
332
|
-
llm: new ChatOpenAI({ model: 'gpt-4' }),
|
|
333
|
-
tools: [
|
|
334
|
-
new BotchaTool({ baseUrl: 'https://api.botcha.ai' }),
|
|
335
|
-
// ... other tools
|
|
336
|
-
],
|
|
337
|
-
});
|
|
338
|
-
|
|
339
|
-
// Agent can now access BOTCHA-protected APIs automatically
|
|
340
|
-
await agent.invoke({
|
|
341
|
-
messages: [{ role: 'user', content: 'Access the bot-only API' }]
|
|
342
|
-
});
|
|
343
|
-
```
|
|
263
|
+
## License
|
|
344
264
|
|
|
345
|
-
|
|
346
|
-
# Test deployment with JWT_SECRET configured
|
|
265
|
+
MIT © [Dupe](https://dupe.com)
|