From b3cc10dc643865020be24b29b9e65aeead83cd9d Mon Sep 17 00:00:00 2001
From: tetsuo <usage_deep0n@icloud.com>
Date: Sat, 4 Jul 2026 16:28:53 -0600
Subject: [PATCH] docs(sdk): reposition as the devnet ZK/privacy SDK (FD5/FD9)

The README claimed to be the canonical public home for the AgenC SDK
while shipping a devnet-only ZK/proof SDK (program 6UcJ...). Reposition
honestly:

- top-of-README pointer box to @tetsuo-ai/marketplace-sdk
  (tetsuo-ai/agenc-protocol, packages/sdk-ts) for marketplace work
- explicit devnet-only scope section; the mainnet privacy story is
  deferred, not hidden
- npm package description updated to match (not published; rides the
  next release)
- CHANGELOG Unreleased entry

Claude-Session: https://claude.ai/code/session_01PnpmjbFCZVQBB7w7DhypZY
---
 CHANGELOG.md |  3 +++
 README.md    | 22 ++++++++++++++++++++--
 package.json |  2 +-
 3 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 208bba0..6cff4d4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,9 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+### Changed
+- Repositioned the README and npm package description as the devnet-only ZK/privacy SDK, with a prominent pointer to `@tetsuo-ai/marketplace-sdk` (repo `tetsuo-ai/agenc-protocol`) for AgenC marketplace work. The mainnet privacy story is deferred, not hidden. No behavior changes.
+
 ### Added
 - Added initial changelog + API baseline tooling. (#983)
 
diff --git a/README.md b/README.md
index 7135433..0e8cf54 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,26 @@
 # @tetsuo-ai/sdk
 
-Privacy-preserving agent coordination on Solana.
+Devnet ZK/privacy SDK for AgenC — privacy-preserving agent coordination on Solana.
 
-This repo is the canonical public home for the AgenC SDK. It owns:
+> **Building on the AgenC marketplace?** Marketplace work — posting, claiming,
+> reviewing, and settling tasks on **mainnet** — lives in
+> [`@tetsuo-ai/marketplace-sdk`](https://www.npmjs.com/package/@tetsuo-ai/marketplace-sdk)
+> (repo: [tetsuo-ai/agenc-protocol](https://github.com/tetsuo-ai/agenc-protocol),
+> `packages/sdk-ts`). This package is **not** the marketplace SDK.
+
+## Scope: devnet-only ZK/privacy SDK
+
+This package targets the **devnet** deployment of the AgenC coordination
+program (`6UcJzbTEemBz3aY5wK5qKHGMD7bdRsmR4smND29gB2ab`) and its RISC Zero
+proof flows: private task completion, proof generation via the prover service,
+and the surrounding agent/dispute/governance helpers on that devnet program.
+
+The mainnet privacy story is deferred, not hidden: the ZK private-completion
+path has not shipped to the mainnet marketplace program yet, so nothing in this
+package signs or settles on mainnet. When private completion lands on mainnet,
+that support will be announced in this repo's changelog.
+
+This repo is the public home for the AgenC **devnet ZK/privacy SDK**. It owns:
 
 - the published `@tetsuo-ai/sdk` package
 - the public SDK changelog and release authority
diff --git a/package.json b/package.json
index 5358129..fb09b07 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tetsuo-ai/sdk",
   "version": "1.4.0",
-  "description": "TypeScript SDK for AgenC - Privacy-preserving agent coordination on Solana",
+  "description": "Devnet ZK/privacy SDK for AgenC — privacy-preserving agent coordination on Solana (devnet program). For AgenC marketplace work use @tetsuo-ai/marketplace-sdk.",
   "packageManager": "npm@11.7.0",
   "main": "dist/index.js",
   "module": "dist/index.mjs",