@vercora-protocol/sdk 0.0.14 → 0.0.15

package/README.md

@@ -47,7 +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). |
+| `agents/skill.md`        | Short **AI agent entrypoint** (production: `https://vercora.xyz/agents/skill.md`). |
 
 ---
 
@@ -496,7 +496,7 @@ 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.
+Start from **`agents/skill.md`** in this package for a stable entrypoint; the full playbook is at **`https://vercora.xyz/agents/playbook.md`** (production), or `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`).

package/agents/skill.md

@@ -2,22 +2,64 @@
 
 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
+## Public production deployment (Vercora)
+
+The canonical HTTPS deployment—use this when you **do not** have the monorepo—is **[vercora.xyz](https://vercora.xyz)**. Fetch these over TLS; use a Solana `Connection` and cluster that match the deployment you operate against (see this package’s `README.md`).
+
+| Resource | URL |
+|----------|-----|
+| Full AI playbook (markdown) | `https://vercora.xyz/agents/playbook.md` |
+| This skill entry (markdown) | `https://vercora.xyz/agents/skill.md` |
+| Pointer manifest (JSON) | `https://vercora.xyz/.well-known/vercora-agents.json` |
+| Developer docs (human) | `https://vercora.xyz/docs` |
+| AI / agents page (human) | `https://vercora.xyz/docs/agents` |
+
+Example:
+
+```http
+GET https://vercora.xyz/agents/playbook.md
+```
+
+## Other front-end deployments
+
+For self-hosted or staging sites, use the same path suffixes with your origin: `{BASE}/agents/playbook.md`, `{BASE}/agents/skill.md`, `{BASE}/.well-known/vercora-agents.json` (where `BASE` is `https://your-host` with no trailing slash).
+
+## What to read first
 
 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).
+2. **Full playbook** (skills, pitfalls, decision trees):
+   - **Production:** `https://vercora.xyz/agents/playbook.md`
+   - **Monorepo (contributors):** `prediction_market/docs/AI-AGENT-SDK-PLAYBOOK.md` (content matches the production mirror).
+
+The playbook is the source of truth for instruction order, branching, and edge cases.
+
+## Key files in the published npm package
+
+Paths are under `node_modules/@vercora-protocol/sdk/` after install.
 
-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.
+| Path | Purpose |
+|------|---------|
+| `README.md` | Install, API tables, examples, AI agent integration |
+| `agents/skill.md` | This entry |
+| `dist/index.js` / `dist/index.d.ts` | Package entry (`PredictionMarketClient`, re-exports) |
+| `dist/idl/vercora.json` | Anchor **IDL** JSON (`IDL` / `PROGRAM_ID` match this release) |
+| `dist/client.js` | `PredictionMarketClient` implementation |
+| `dist/types.d.ts` | `CreateMarketParams`, `MarketAccount`, `UpdateParimutuelStateParams`, etc. |
+| `dist/generated/vercora.d.ts` | Anchor codegen types; use as `Program<Vercora>` generic |
+| `dist/pda.d.ts` | PDA helpers (`deriveMarket`, `deriveVault`, …) |
+| `dist/marketUi.d.ts` | `getMarketLifecycleStatus`, `formatTimeLeft`, … |
+| `package.json` | Version and peer dependencies |
 
-## Canonical URLs (when a web app is available)
+## Monorepo paths (source / docs, not shipped in npm)
 
-| 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` |
+| Path | Purpose |
+|------|---------|
+| `prediction_market/docs/AI-AGENT-SDK-PLAYBOOK.md` | Full AI playbook (synced to `https://vercora.xyz/agents/playbook.md`) |
+| `prediction_market/docs/market-mechanics-and-ux-options.md` | Mechanics and UX notes (non-normative) |
+| `prediction_market/app/sdk/src/` | SDK TypeScript source |
+| `prediction_market/target/idl/vercora.json` | IDL from `anchor build` (synced into SDK + web) |
+| `prediction_market/programs/vercora/` | On-chain program (Rust) |
+| `prediction_market/app/web/public/.well-known/vercora-agents.json` | Pointer manifest (deployed at `https://vercora.xyz/.well-known/vercora-agents.json`) |
 
 ## NPM
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercora-protocol/sdk",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "description": "TypeScript SDK for the Vercora protocol on Solana",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",