@gpt-core/admin 0.8.11 → 0.8.20

package/README.md

@@ -8,6 +8,48 @@ The official TypeScript Admin SDK for the GPT Core Platform - platform administr
 
 ⚠️ **This SDK requires admin privileges and should only be used in secure server environments.**
 
+---
+
+<!-- AI_CONTEXT_START
+This SDK provides TypeScript bindings for GPT Core ADMIN operations.
+Use this for: webhooks, storage admin, account credits, bulk operations, API key management.
+NOT for: user-facing operations (use @gpt-core/client instead).
+SECURITY: Server-side only. Never expose admin tokens in client code.
+
+Quick patterns:
+- Initialize: new GptAdmin({ baseUrl, token, applicationId? })
+- Webhooks: admin.webhooks.configs.list() / .create(name, url, events, appId)
+- Storage: admin.storage.stats() / .buckets.list()
+- Accounts: admin.accounts.credit(id, amount, description)
+- Documents: admin.documents.bulkDelete(ids[])
+- API Keys: admin.apiKeys.allocate(id, amount) / .revoke(id) / .rotate(id)
+
+All methods return typed responses. Uses class-based API with namespaced methods.
+AI_CONTEXT_END -->
+
+## For AI Coding Assistants
+
+> **TL;DR for Claude, Cursor, Copilot, and other AI assistants:**
+>
+> ```typescript
+> import { GptAdmin } from '@gpt-core/admin';
+> const admin = new GptAdmin({ baseUrl: 'https://api.example.com', token: 'admin-jwt' });
+> ```
+>
+> **Common operations:**
+> | Task | Code |
+> |------|------|
+> | Storage stats | `await admin.storage.stats()` |
+> | List webhooks | `await admin.webhooks.configs.list()` |
+> | Create webhook | `await admin.webhooks.configs.create(name, url, events, appId)` |
+> | Credit account | `await admin.accounts.credit(id, amount, 'reason')` |
+> | Bulk delete docs | `await admin.documents.bulkDelete(ids)` |
+> | Rotate API key | `await admin.apiKeys.rotate(keyId)` |
+>
+> **See [llms.txt](llms.txt) for complete AI-readable SDK reference.**
+
+---
+
 ## Features
 
 ✅ **Fully Typed** - Complete TypeScript support with auto-generated types from OpenAPI specs
@@ -231,8 +273,6 @@ Available webhook events:
 - `workspace.created`
 - `user.registered`
 
-[See full webhook documentation](docs/WEBHOOKS.md)
-
 ## Bulk Operations
 
 All bulk operations support:
@@ -299,58 +339,6 @@ import type {
 } from '@gpt-core/admin';
 ```
 
-## Documentation
-
-### For ISV Developers
-
-- **[ISV Integration Guide](docs/ISV_GUIDE.md)** - Complete production-ready integration guide
-  - Environment setup and authentication
-  - Common workflows (webhooks, storage, billing, bulk ops)
-  - Production best practices and security
-  - Monitoring, observability, error handling
-  - Rate limiting and troubleshooting
-
-- **[AI-Assisted Integration](docs/AI_INTEGRATION_GUIDE.md)** - Quick-start for AI coding assistants
-  - Copy-paste integration patterns
-  - Ready-to-use code snippets for common use cases
-  - AI prompt templates for Cursor/Copilot/Claude
-
-### Topic Guides
-
-- **[Authentication](docs/AUTHENTICATION.md)** - Admin token management and security
-  - JWT token authentication
-  - Token refresh strategies
-  - Secret management integration (AWS, Vault, GCP)
-  - Multi-environment configuration
-
-- **[Error Handling](docs/ERROR_HANDLING.md)** - Comprehensive error handling strategies
-  - Validation errors (Zod)
-  - HTTP errors (401, 403, 404, 429, 500)
-  - Retry strategies (exponential backoff, jitter)
-  - Circuit breaker pattern
-  - Graceful degradation
-
-- **[Bulk Operations](docs/BULK_OPERATIONS.md)** - Efficient batch processing guide
-  - Document bulk delete and reprocess
-  - Webhook bulk enable/disable
-  - Batching strategies and performance optimization
-  - Progress tracking and monitoring
-  - Error handling for partial failures
-
-- **[Webhook Management](docs/WEBHOOKS.md)** - Webhook configuration and monitoring
-  - Creating and configuring webhooks
-  - Signature verification
-  - Event handling
-  - Monitoring deliveries
-  - Troubleshooting
-
-### For SDK Contributors
-
-- **[llms.txt](llms.txt)** - AI agent context for SDK maintenance
-  - SDK architecture and patterns
-  - Generated vs handwritten code
-  - Development workflows
-
 ## Testing
 
 ```bash