@vercora-protocol/sdk 0.0.13 → 0.0.14

package/README.md

@@ -47,6 +47,7 @@ Most transaction methods use **`provider.wallet.publicKey`** as the signer (`use
 | `types`                  | Params and account shapes (`CreateMarketParams`, `ListedMarket`, …).                         |
 | `marketUi`               | Pure UI helpers (`getMarketLifecycleStatus`, `formatTimeLeft`, …).                           |
 | `Vercora` (type)         | Anchor `Program` generic for `Program<Vercora>`.                                             |
+| `agents/skill.md`        | Short **AI agent entrypoint** (also mirrored at `{BASE}/agents/skill.md` on the Vercora web app). |
 
 ---
 
@@ -495,6 +496,8 @@ import type {
 
 ## AI agent integration
 
+Start from **`agents/skill.md`** in this package for a stable entrypoint; the full playbook is available at **`{BASE}/agents/playbook.md`** on a deployed Vercora web app, or as `docs/AI-AGENT-SDK-PLAYBOOK.md` in the monorepo.
+
 1. **Bootstrap**: `Connection` → `AnchorProvider` → `Program<Vercora>` from `IDL` → `PredictionMarketClient`.
 2. **Branch**: `fetchMarket` → `market.marketType` (`completeSet` vs `parimutuel`).
 3. **Flows**:

package/agents/skill.md

@@ -0,0 +1,30 @@
+# Vercora Protocol — agent skill entry (`@vercora-protocol/sdk`)
+
+This file ships **inside** the npm package (`agents/skill.md`) so AI agents, clawbots, and operator scripts can load instructions without depending on a particular website.
+
+## What to read
+
+1. **This package’s `README.md`** — install, exports, `PredictionMarketClient` API, and the **AI agent integration** section (workflow map).
+2. **Full playbook** (longer, skills + pitfalls + decision trees) — one of:
+   - **Deployed app:** `GET {BASE}/agents/playbook.md` (replace `BASE` with the site origin, e.g. `https://vercora.xyz`).
+   - **Monorepo:** `prediction_market/docs/AI-AGENT-SDK-PLAYBOOK.md` (same content as the web mirror).
+
+Treat the playbook as the source of truth for call order, branching, and edge cases. Pin `BASE` to the same cluster/RPC policy you use for transactions.
+
+## Canonical URLs (when a web app is available)
+
+| Resource | Path |
+|----------|------|
+| Full playbook (markdown) | `{BASE}/agents/playbook.md` |
+| This entry (markdown) | `{BASE}/agents/skill.md` |
+| Pointer manifest (JSON) | `{BASE}/.well-known/vercora-agents.json` |
+
+## NPM
+
+- Package: `@vercora-protocol/sdk`
+- See `package.json` for the published version; align Anchor program + IDL with the same release when possible.
+
+## Quick guardrails (parimutuel)
+
+- After `fetchMarket(marketPda)`, read **`isEarlyWithdrawAllowed`**. If `false`, do not propose **`parimutuelWithdraw`** until close/resolution (on-chain error **`EarlyWithdrawNotAllowed`**). Creators may change this with **`updateParimutuelState`** (with penalty bps).
+- Use **`isClosedEarly`**, **`isVoided`**, **`winningOutcomeIndex`** for lifecycle — not legacy `closed` / `voided` / `resolvedOutcomeIndex` names.

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@vercora-protocol/sdk",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "description": "TypeScript SDK for the Vercora protocol on Solana",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "agents"
   ],
   "publishConfig": {
     "access": "public",