@chitmark/sdk 0.7.0 → 0.8.0

package/README.md

@@ -1,8 +1,10 @@
 # @chitmark/sdk
 
-Official TypeScript / JavaScript SDK for Chitmark: trust decisions on agent-mediated actions, tuned by business outcomes.
+Official TypeScript and JavaScript SDK for Chitmark.
 
-AI agents and multi-account farms drain free tiers, trial credits, and API allowances while looking exactly like your best customers. Chitmark scores each action in under 50 ms and returns `allow`, `challenge`, or `deny`. Then your outcomes (conversion, credit burn, chargeback) come back through `feedback` and tune the next decision.
+- [Trust Decisions](https://chitmark.com/docs/quickstart/trust-decisions) lets you screen costly actions such as signups, credit grants, and API requests with `verify`, `feedback`, and `challenge`.
+- [Agent Attribution](https://chitmark.com/docs/guides/agent-attribution) lets you recognize returning site sessions and evaluate signed proof from linked agents.
+- [Agent Paid Access](https://chitmark.com/docs/guides/agent-paid-access) lets you buy or sell controlled access to API resources with hosted checkout and seller-controlled delivery.
 
 [![npm version](https://img.shields.io/npm/v/@chitmark/sdk.svg)](https://www.npmjs.com/package/@chitmark/sdk)
 
@@ -18,7 +20,7 @@ pnpm add @chitmark/sdk
 
 Requires Node >= 24. Runs on Node, browsers, Cloudflare Workers, and other edge runtimes (see the `/edge` entrypoint below).
 
-## Quick start
+## Trust Decisions quick start
 
 ```typescript
 import { Chitmark } from "@chitmark/sdk";
@@ -172,6 +174,21 @@ const chitmark = new Chitmark({ apiKey: env.CHITMARK_API_KEY });
 const verdict = await chitmark.verifyRequest(req, { action: "signup" });
 ```
 
+## Agent Attribution
+
+Use an Attribution read key to recognize site sessions or resolve an authorized principal association. Unknown is a successful outcome, and email is nullable.
+
+```ts
+const result = await chitmark.attribution.resolve({ request });
+console.log(result.identity.recognized, result.principal.email);
+```
+
+See the [Agent Attribution guide](https://chitmark.com/docs/guides/agent-attribution/) for request adapters, link grants, and disclosure rules.
+
+## Agent Paid Access
+
+Call `chitmark.charge(request)` to request a quote, continue through hosted checkout, or check purchase status. Sellers use separate credentials to reserve execution and record delivery. See the [Agent Paid Access guide](https://chitmark.com/docs/guides/agent-paid-access) for scopes and a complete buyer and seller example.
+
 ## Agent integration
 
 Using Cursor, Claude Code, Codex, or another coding agent? Point it at