@basedchef/contextkit 0.1.1 → 0.1.3

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,96 @@
-# 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 a TypeScript integration that needs typed calls to ContextKit direct APIs, webhook verification, API-key credits, and optional x402 payment handling. For the simplest paid path, agents can still 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 for direct API integrations.
+- Use account credits so SDK users can call paid endpoints without Bankr.
+- Optionally attach an x402 payment handler when credits are not available.
+
+## Quick Start
 
 ```ts
-import { ContextKit } from "contextkit";
+import { ContextKit } from "@basedchef/contextkit";
 
 const client = new ContextKit({
   apiKey: process.env.CONTEXTKIT_API_KEY!,
-  x402: async (challenge) => wallet.pay(challenge)
+  baseUrl: "https://91.107.248.223.sslip.io"
 });
 
-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 });
+await client.credits();
+```
+
+## 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."}]}'
+```
+
+That flow requires no ContextKit API key, no npm package, and no SDK.
+
+## Direct API Path
+
+The SDK is for direct API integrations. If the API key owner has ContextKit credits, paid generation routes run without Bankr and deduct the endpoint price from the account balance. If credits are insufficient, the API falls back to the standard x402 payment challenge.
+
+```ts
+const client = new ContextKit({
+  apiKey: process.env.CONTEXTKIT_API_KEY!,
+  baseUrl: "https://91.107.248.223.sslip.io"
+});
 ```
 
-## Methods
+Optional x402 fallback:
 
-- `summarize(request)`
-- `compressContext(request)`
-- `handoff(request)`
-- `extractProfile(request)`
-- `estimateTokens(request)`
+```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 +99,6 @@ const valid = await verifyContextKitWebhook({
 });
 ```
 
-## Build
+## License
 
-```bash
-npm install
-npm run build
-```
+MIT

package/dist/index.cjs

@@ -60,6 +60,20 @@ var ContextKit = class {
   async estimateTokens(input) {
     return this.post("/api/tokens/estimate", input);
   }
+  credits() {
+    return this.get("/api/auth/credits");
+  }
+  async get(path) {
+    const response = await this.fetcher(`${this.baseUrl.replace(/\/$/, "")}${path}`, {
+      headers: {
+        Authorization: `Bearer ${this.options.apiKey}`
+      }
+    });
+    if (response.ok) {
+      return await response.json();
+    }
+    throw new ContextKitError(response.status, await response.text());
+  }
   async post(path, body) {
     const url = `${this.baseUrl.replace(/\/$/, "")}${path}`;
     const init = {

package/dist/index.d.cts

@@ -191,6 +191,23 @@ type MemoryEnrichmentResponse = {
     deprecatedMemories: string[];
     confidence: number;
 };
+type CreditEvent = {
+    id: string;
+    ownerId: string;
+    type: "grant" | "debit" | "refund";
+    amountUsd: number;
+    balanceAfterUsd: number;
+    route?: string;
+    requestId?: string;
+    apiKeyId?: string;
+    note?: string;
+    createdAt: string;
+};
+type CreditsResponse = {
+    ownerId: string;
+    balanceUsd: number;
+    events: CreditEvent[];
+};
 type X402PaymentHandler = (challenge: unknown, request: RequestInit & {
     url: string;
 }) => Promise<string>;
@@ -219,6 +236,8 @@ declare class ContextKit {
         compressedTokens: number;
         reductionPercent: number;
     }>;
+    credits(): Promise<CreditsResponse>;
+    private get;
     private post;
 }
 declare class ContextKitError extends Error {
@@ -253,4 +272,4 @@ declare function getFirstX402Requirement(challenge: X402Challenge): {
 };
 declare function encodeX402Payment(payment: unknown): string;
 
-export { type CompressContextResponse, ContextKit, ContextKitError, type ContextRequest, type ConversationMessage, type HandoffResponse, type MemoryEnrichmentResponse, type ProfileResponse, type SummarizeResponse, type X402PaymentHandler, encodeX402Payment, getFirstX402Requirement, verifyContextKitWebhook };
+export { type CompressContextResponse, ContextKit, ContextKitError, type ContextRequest, type ConversationMessage, type CreditEvent, type CreditsResponse, type HandoffResponse, type MemoryEnrichmentResponse, type ProfileResponse, type SummarizeResponse, type X402PaymentHandler, encodeX402Payment, getFirstX402Requirement, verifyContextKitWebhook };

package/dist/index.d.ts

@@ -191,6 +191,23 @@ type MemoryEnrichmentResponse = {
     deprecatedMemories: string[];
     confidence: number;
 };
+type CreditEvent = {
+    id: string;
+    ownerId: string;
+    type: "grant" | "debit" | "refund";
+    amountUsd: number;
+    balanceAfterUsd: number;
+    route?: string;
+    requestId?: string;
+    apiKeyId?: string;
+    note?: string;
+    createdAt: string;
+};
+type CreditsResponse = {
+    ownerId: string;
+    balanceUsd: number;
+    events: CreditEvent[];
+};
 type X402PaymentHandler = (challenge: unknown, request: RequestInit & {
     url: string;
 }) => Promise<string>;
@@ -219,6 +236,8 @@ declare class ContextKit {
         compressedTokens: number;
         reductionPercent: number;
     }>;
+    credits(): Promise<CreditsResponse>;
+    private get;
     private post;
 }
 declare class ContextKitError extends Error {
@@ -253,4 +272,4 @@ declare function getFirstX402Requirement(challenge: X402Challenge): {
 };
 declare function encodeX402Payment(payment: unknown): string;
 
-export { type CompressContextResponse, ContextKit, ContextKitError, type ContextRequest, type ConversationMessage, type HandoffResponse, type MemoryEnrichmentResponse, type ProfileResponse, type SummarizeResponse, type X402PaymentHandler, encodeX402Payment, getFirstX402Requirement, verifyContextKitWebhook };
+export { type CompressContextResponse, ContextKit, ContextKitError, type ContextRequest, type ConversationMessage, type CreditEvent, type CreditsResponse, type HandoffResponse, type MemoryEnrichmentResponse, type ProfileResponse, type SummarizeResponse, type X402PaymentHandler, encodeX402Payment, getFirstX402Requirement, verifyContextKitWebhook };

package/dist/index.js

@@ -30,6 +30,20 @@ var ContextKit = class {
   async estimateTokens(input) {
     return this.post("/api/tokens/estimate", input);
   }
+  credits() {
+    return this.get("/api/auth/credits");
+  }
+  async get(path) {
+    const response = await this.fetcher(`${this.baseUrl.replace(/\/$/, "")}${path}`, {
+      headers: {
+        Authorization: `Bearer ${this.options.apiKey}`
+      }
+    });
+    if (response.ok) {
+      return await response.json();
+    }
+    throw new ContextKitError(response.status, await response.text());
+  }
   async post(path, body) {
     const url = `${this.baseUrl.replace(/\/$/, "")}${path}`;
     const init = {

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.3",
+  "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": {