@basedchef/contextkit 0.1.1 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 basedchef
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,30 +1,85 @@
-# contextkit TypeScript SDK
+# @basedchef/contextkit
 
-Typed SDK for ContextKit, the x402-powered context infrastructure API for AI agents.
+TypeScript SDK for ContextKit, a Bankr-hosted x402 context API for AI agents.
+
+Use it when you are building an advanced TypeScript integration that needs typed calls to ContextKit direct APIs, webhook verification, and optional x402 payment handling. For the simplest paid path, agents can call the Bankr-hosted x402 endpoints directly without this SDK.
+
+## Install
+
+```bash
+npm install @basedchef/contextkit
+```
+
+## What It Does
+
+- Summarize long agent conversations into compact continuation state.
+- Compress project context into reusable machine-optimized memory.
+- Generate agent-to-agent handoff payloads.
+- Extract durable user profile memory.
+- Estimate tokens for API-key workflows.
+- Verify signed ContextKit webhook deliveries.
+- Attach API keys and optional x402 payment handlers for direct API integrations.
+
+## Quick Start
 
 ```ts
-import { ContextKit } from "contextkit";
+import { ContextKit } from "@basedchef/contextkit";
 
 const client = new ContextKit({
   apiKey: process.env.CONTEXTKIT_API_KEY!,
+  baseUrl: "https://91.107.248.223.sslip.io",
   x402: async (challenge) => wallet.pay(challenge)
 });
 
-const response = await client.summarize({ messages });
+const response = await client.summarize({
+  messages: [
+    {
+      role: "user",
+      content: "Summarize this long project context for the next AI agent."
+    }
+  ],
+  mode: "compact"
+});
+```
+
+## API Methods
+
+```ts
+await client.summarize({ messages, mode: "micro" });
+await client.compressContext({ messages });
+await client.handoff({ messages });
+await client.extractProfile({ messages });
+await client.estimateTokens({ modelFamily: "openai", input: messages });
+```
+
+## Bankr-Hosted x402 Path
+
+Most users and agents do not need the SDK. They can call the hosted paid endpoint from a Bankr-authenticated terminal:
+
+```bash
+bankr x402 call https://x402.bankr.bot/0xdace98cd605dd56b2edc66f0f4df3687f64fd824/contextkit-summarize \
+  -X POST \
+  -d '{"messages":[{"role":"user","content":"Summarize this context."}]}'
 ```
 
-## Methods
+That flow requires no ContextKit API key, no npm package, and no SDK.
 
-- `summarize(request)`
-- `compressContext(request)`
-- `handoff(request)`
-- `extractProfile(request)`
-- `estimateTokens(request)`
+## Direct API Path
+
+The SDK is for advanced integrations. Direct paid generation routes still require x402 payment. API keys are used for dashboard operations, analytics, webhook management, token estimates, and selected direct API routes.
+
+```ts
+const client = new ContextKit({
+  apiKey: process.env.CONTEXTKIT_API_KEY!,
+  baseUrl: "https://91.107.248.223.sslip.io",
+  x402: async (challenge) => wallet.pay(challenge)
+});
+```
 
 ## Webhook Verification
 
 ```ts
-import { verifyContextKitWebhook } from "contextkit";
+import { verifyContextKitWebhook } from "@basedchef/contextkit";
 
 const valid = await verifyContextKitWebhook({
   payload: rawBody,
@@ -33,9 +88,6 @@ const valid = await verifyContextKitWebhook({
 });
 ```
 
-## Build
+## License
 
-```bash
-npm install
-npm run build
-```
+MIT

package/package.json

@@ -1,14 +1,40 @@
 {
   "name": "@basedchef/contextkit",
-  "version": "0.1.1",
-  "description": "TypeScript SDK for ContextKit context infrastructure APIs.",
+  "version": "0.1.2",
+  "description": "TypeScript SDK for ContextKit, a Bankr-hosted x402 context API for AI agents, memory compression, handoffs, profiles, and webhooks.",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "LICENSE"
+  ],
+  "license": "MIT",
+  "author": "basedchef",
+  "homepage": "https://91.107.248.223.sslip.io",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arsalang75523/contextkit.git",
+    "directory": "packages/sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/arsalang75523/contextkit/issues"
+  },
+  "keywords": [
+    "contextkit",
+    "ai",
+    "ai-agents",
+    "agent-memory",
+    "context-compression",
+    "context-engineering",
+    "summarization",
+    "handoff",
+    "webhooks",
+    "x402",
+    "bankr",
+    "typescript-sdk"
   ],
   "sideEffects": false,
   "publishConfig": {