@basedchef/contextkit 0.1.2 → 0.1.3

package/README.md

@@ -2,7 +2,7 @@
 
 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.
+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
 
@@ -18,7 +18,9 @@ npm install @basedchef/contextkit
 - 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.
+- 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
 
@@ -27,8 +29,7 @@ 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)
+  baseUrl: "https://91.107.248.223.sslip.io"
 });
 
 const response = await client.summarize({
@@ -50,6 +51,7 @@ 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
@@ -66,7 +68,16 @@ That flow requires no ContextKit API key, no npm package, and no SDK.
 
 ## 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.
+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"
+});
+```
+
+Optional x402 fallback:
 
 ```ts
 const client = new ContextKit({

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,6 +1,6 @@
 {
   "name": "@basedchef/contextkit",
-  "version": "0.1.2",
+  "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",