@dupecom/botcha 0.4.5 → 0.5.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 (2) hide show
  1. package/README.md +2 -83
  2. 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
- ## CLI Tool
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
- See [`packages/langchain/README.md`](./packages/langchain/README.md) for full documentation.
346
- # Test deployment with JWT_SECRET configured
265
+ MIT © [Dupe](https://dupe.com)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dupecom/botcha",
3
- "version": "0.4.5",
3
+ "version": "0.5.0",
4
4
  "description": "Prove you're a bot. Humans need not apply. Reverse CAPTCHA for AI-only APIs.",
5
5
  "workspaces": [
6
6
  "packages/*"