@apex-inc/mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Apex Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,151 @@
+# @apex-inc/mcp-server
+
+Persistent growth intelligence for AI agents and developer tools.
+
+The Apex MCP server gives your AI agent a persistent growth brain — beliefs, predictions, experiments, and calibration that compound across every session. Instead of starting from zero, your AI draws on everything your team has ever learned: which beliefs have been validated, which predictions were accurate, and what to test next.
+
+## Install
+
+```bash
+npm install @apex-inc/mcp-server
+```
+
+## Configure
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "apex": {
+      "command": "npx",
+      "args": ["@apex-inc/mcp-server"],
+      "env": {
+        "APEX_URL": "https://your-apex-instance.com",
+        "APEX_API_URL": "https://your-apex-instance.com",
+        "APEX_API_KEY": "apex_key_your_key_here",
+        "APEX_PROJECT_KEY": "your-project-key"
+      }
+    }
+  }
+}
+```
+
+### Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `APEX_URL` | No | Base URL of the Apex app (default: `http://localhost:3001`) |
+| `APEX_API_KEY` | Recommended | API key for authenticated access |
+| `APEX_PROJECT_KEY` | No | Project key for multi-project setups (default: `default`) |
+
+## MCP Tools (19)
+
+### Growth Intelligence
+
+Query the persistent knowledge system — beliefs, predictions, calibration, and recommendations.
+
+| Tool | Description |
+|------|-------------|
+| `suggest_experiment` | Context-aware experiment recommendations based on beliefs, past results, and confidence gaps |
+| `predict_impact` | Decision guardrail — predict impact using historical experiment data before committing |
+| `evaluate_feature` | Pre-build intelligence — evaluate a feature idea against the belief graph |
+| `create_belief` | Record a belief (confirms statement and confidence with user first) |
+| `log_prediction` | Log a prediction — feeds the calibration loop tracking team accuracy |
+| `record_outcome` | Record outcome with Bayesian belief update |
+
+### Experiment Engine
+
+Design, run, and measure controlled experiments.
+
+| Tool | Description |
+|------|-------------|
+| `plan_experiment` | Analyze a goal against beliefs and experiments, returns structured options |
+| `start_reasoning` | Record a belief → hypothesis chain |
+| `create_experiment` | Create an A/B test — supports `preview=true` for dry run |
+| `activate_experiment` | Launch an experiment (changes draft → running) |
+| `pause_experiment` | Pause a running experiment (all visitors see control) |
+| `list_experiments` | List experiments with status and results. Pass `status: "archived"` or `"all"` |
+| `get_results` | Detailed results for a specific experiment |
+| `promote_winner` | Mark the winning variant and complete the experiment |
+| `archive_experiment` | Archive an experiment (preserves all data and belief connections) |
+
+### Deployment & Tracking
+
+| Tool | Description |
+|------|-------------|
+| `track_deployment` | Record that experiment code has been committed and pushed |
+| `check_deployment` | Verify the experiment assignment endpoint is reachable |
+| `track_event` | Track a custom event (identical to SDK `track()` and snippet `apex.track()`) |
+| `identify_user` | Identify a user by email for identity stitching |
+
+## Shipped skills (Cursor / AI assistants)
+
+Markdown skills ship in **`skills/`** inside this package (e.g. `skills/apex-experimentation/SKILL.md`). Copy each skill folder into **`.cursor/skills/<skill-name>/`** so your assistant learns when to suggest experiments and how to instrument tracking.
+
+Your Apex app also serves the same files at **`/shipped-skills/<skill-id>/SKILL.md`** (see **Install → JSON** response from `/api/mcp-install` for URLs and install steps).
+
+Set **`APEX_URL`** to your Apex base URL (the MCP client uses this; **`APEX_API_URL`** is accepted for compatibility).
+
+## MCP Resources (6)
+
+| URI | Name | Description |
+|-----|------|-------------|
+| `apex://beliefs` | Assumptions | All tracked assumptions with certainty scores and test status |
+| `apex://experiments/active` | Running Experiments | Currently running experiments with results and assumption linkages |
+| `apex://ledger` | Learning Log | History of everything learned from experiments — decisions, reasoning, belief updates |
+| `apex://intelligence-score` | Learning Rate | How much of what you assume has been tested, and how fast you're learning |
+| `apex://intelligence` | Growth Intelligence | Full intelligence metrics: score breakdown, revenue data, learning velocity |
+| `apex://calibration` | Prediction Calibration | Prediction accuracy and calibration data — how well predictions match reality |
+
+## MCP Prompts (2)
+
+| Prompt | Description |
+|--------|-------------|
+| `new-experiment` | Interactive experiment setup — guides through belief selection, prediction, variant design, and deployment |
+| `experiment-review` | Review results, update beliefs, promote winners, and plan next steps |
+
+## Example Workflows
+
+### Interactive experiment creation
+
+```
+You: "I want to test a new headline on the landing page"
+
+Step 1 — AI calls plan_experiment({ goal: "test headline on landing page" })
+→ Returns: suggested beliefs, metrics, confidence levels, traffic splits
+→ AI presents these as structured choices
+
+Step 2 — You choose belief, confidence, and metric
+→ AI calls start_reasoning with your choices
+→ AI asks: "Want to log a prediction?"
+
+Step 3 — You pick metric and expected impact
+→ AI calls log_prediction with your inputs
+
+Step 4 — AI proposes variant headlines for you to choose
+→ You pick one or write your own
+
+Step 5 — AI calls create_experiment({ ..., preview: true })
+→ Shows the full plan — you confirm → create_experiment({ ..., preview: false })
+```
+
+### Decision guardrail before a change
+
+```
+Developer: "Let's increase signup form fields from 3 to 5"
+→ AI calls predict_impact({ description: "increase signup form fields from 3 to 5" })
+→ Returns: "Similar experiments decreased activation by 18%. Recommendation: RECONSIDER"
+```
+
+### Pre-build feature evaluation
+
+```
+Developer: "Should we build a freemium tier?"
+→ AI calls evaluate_feature({ feature: "freemium pricing tier", targetMetric: "activation" })
+→ Returns: belief graph analysis, historical evidence, confidence gaps, and suggestion
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE)

package/dist/api-client.d.ts

@@ -0,0 +1,5 @@
+export declare function apiGet<T>(path: string): Promise<T>;
+export declare function apiPost<T>(path: string, body: unknown): Promise<T>;
+export declare function apiDelete(path: string): Promise<void>;
+export declare function apiPatch<T>(path: string, body: unknown): Promise<T>;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AASA,wBAAsB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CASxD;AAED,wBAAsB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAWxE;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS3D;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAWzE"}

package/dist/api-client.js

@@ -0,0 +1,53 @@
+const BASE_URL = process.env.APEX_URL || "http://localhost:3001";
+function authHeaders() {
+    const key = process.env.APEX_API_KEY;
+    const headers = { "x-apex-source": "mcp-server" };
+    if (key)
+        headers["x-api-key"] = key;
+    return headers;
+}
+export async function apiGet(path) {
+    const res = await fetch(`${BASE_URL}${path}`, {
+        headers: { ...authHeaders() },
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`GET ${path} failed (${res.status}): ${body}`);
+    }
+    return res.json();
+}
+export async function apiPost(path, body) {
+    const res = await fetch(`${BASE_URL}${path}`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...authHeaders() },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`POST ${path} failed (${res.status}): ${text}`);
+    }
+    return res.json();
+}
+export async function apiDelete(path) {
+    const res = await fetch(`${BASE_URL}${path}`, {
+        method: "DELETE",
+        headers: { ...authHeaders() },
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`DELETE ${path} failed (${res.status}): ${text}`);
+    }
+}
+export async function apiPatch(path, body) {
+    const res = await fetch(`${BASE_URL}${path}`, {
+        method: "PATCH",
+        headers: { "Content-Type": "application/json", ...authHeaders() },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`PATCH ${path} failed (${res.status}): ${text}`);
+    }
+    return res.json();
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { toolDefinitions } from "./tools.js";
+import { resourceDefinitions } from "./resources.js";
+import { promptDefinitions } from "./prompts.js";
+const server = new McpServer({
+    name: "apex",
+    version: "0.1.0",
+});
+// --- Register tools ---
+for (const [name, def] of Object.entries(toolDefinitions)) {
+    server.tool(name, def.description, def.schema.shape, async (args) => {
+        try {
+            return await def.handler(args);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: "text", text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+// --- Register resources ---
+for (const def of Object.values(resourceDefinitions)) {
+    server.resource(def.name, def.uri, { description: def.description, mimeType: def.mimeType }, async () => {
+        return await def.handler();
+    });
+}
+// --- Register prompts ---
+server.prompt("new-experiment", "Walk through setting up a new experiment: goal, assumption, expected outcome, and test design", { decision: z.string().optional().describe("What you want to improve") }, (args) => promptDefinitions["new-experiment"].handler(args));
+server.prompt("experiment-review", "Review experiment results, see what you learned, and decide what to do next", { experimentId: z.string().describe("The experiment ID to review") }, (args) => promptDefinitions["experiment-review"].handler(args));
+// --- Start ---
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Apex MCP server failed to start:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,yBAAyB;AAEzB,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;IAC1D,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC3F,IAAI,CAAC;YACH,OAAO,MAAM,GAAG,CAAC,OAAO,CAAC,IAAa,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;gBAC/D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,6BAA6B;AAE7B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACrD,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,IAAI,EAAE;QACtG,OAAO,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,2BAA2B;AAE3B,MAAM,CAAC,MAAM,CACX,gBAAgB,EAChB,+FAA+F,EAC/F,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,EACxE,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,IAA8B,CAAC,CACtF,CAAC;AAEF,MAAM,CAAC,MAAM,CACX,mBAAmB,EACnB,6EAA6E,EAC7E,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC,EAAE,EACpE,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,IAA8B,CAAC,CACzF,CAAC;AAEF,gBAAgB;AAEhB,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,39 @@
+export declare const promptDefinitions: {
+    "new-experiment": {
+        name: string;
+        description: string;
+        arguments: {
+            name: string;
+            description: string;
+            required: boolean;
+        }[];
+        handler: (args: Record<string, string>) => {
+            messages: {
+                role: "user";
+                content: {
+                    type: "text";
+                    text: string;
+                };
+            }[];
+        };
+    };
+    "experiment-review": {
+        name: string;
+        description: string;
+        arguments: {
+            name: string;
+            description: string;
+            required: boolean;
+        }[];
+        handler: (args: Record<string, string>) => {
+            messages: {
+                role: "user";
+                content: {
+                    type: "text";
+                    text: string;
+                };
+            }[];
+        };
+    };
+};
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB;;;;;;;;;wBAYV,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;;;;;;;;;;;wBA6KtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;;;CAqCzC,CAAC"}

package/dist/prompts.js

@@ -0,0 +1,220 @@
+export const promptDefinitions = {
+    "new-experiment": {
+        name: "new-experiment",
+        description: "Launch a new experiment with Apex. Interactive setup with code-level implementation.",
+        arguments: [
+            {
+                name: "decision",
+                description: "What you want to improve (optional — will ask if not provided)",
+                required: false,
+            },
+        ],
+        handler: (args) => {
+            const decision = args.decision;
+            const intro = decision
+                ? `The user wants to improve: "${decision}"\n\n`
+                : "";
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: `${intro}You are helping me launch an experiment using **Apex** (Apex).
+
+## MANDATORY UX RULES
+
+You MUST use the \`AskQuestion\` tool for EVERY decision point. Never ask the user to type a number or free-text response unless they explicitly request it.
+
+### AskQuestion formatting rules:
+- **title**: Always start with "Apex —" followed by the step name (e.g. "Apex — Pick a Belief")
+- **ONE question per call** — never batch multiple questions. One step, one poll.
+- **Options must be self-explanatory** — include enough context in the label that the user doesn't need to read chat history
+- **Do NOT add "Custom", "I'll write my own", or any free-text escape hatch option** — Cursor's AskQuestion already provides an "Other..." option automatically. Adding a redundant one clutters the UI.
+- **Every step is mandatory — never offer a "Skip" option** — predictions, confidence, and all other inputs are required. Skipping undermines the calibration loop and the scientific rigor of Apex.
+- **Never auto-fill values the user should choose** — confidence, predictions, and variant text are THEIR inputs
+- **Match the Apex dashboard UI** — poll options must use the same terminology and choices as the web dashboard (e.g. "Adaptive Traffic Allocation" not "Thompson Sampling", same confidence tiers, same split options)
+
+### Branding:
+Every message you write should make it clear the user is working with Apex. Start messages with "Apex" when presenting results or summaries. The user should always know their selections are feeding the Apex intelligence layer.
+
+## Architecture
+
+Apex uses two experiment modes:
+- **SDK mode** (default via MCP): You make real code changes using \`useApexVariant\` hook. Pixel-perfect previews, requires deploy.
+- **Snippet mode**: Runtime DOM manipulation via JS snippet. No code changes, but limited to text swaps.
+
+For MCP workflows, always use SDK mode unless the user explicitly requests snippet mode.
+
+## Flow — one AskQuestion at a time
+
+### Step 1: Understand the Goal
+${decision ? `I want to improve: "${decision}". ` : "Use AskQuestion to ask what the user wants to improve. "}Call \`plan_experiment\` with the goal. Then use AskQuestion to present beliefs:
+
+\`\`\`
+AskQuestion:
+  title: "Apex — Pick a Belief"
+  prompt: "Which assumption should this experiment test?"
+  options: [related beliefs from plan_experiment] + [suggested new beliefs]
+\`\`\`
+
+### Step 2: Confidence Level
+After the user picks a belief, use AskQuestion BEFORE calling start_reasoning:
+
+\`\`\`
+AskQuestion:
+  title: "Apex — Your Confidence"
+  prompt: "How confident are you that: \"[belief statement]\"?"
+  options:
+    - "Low (30%) — Gut feeling, no supporting data yet"
+    - "Medium (55%) — Some signals, but hasn't been tested"
+    - "High (75%) — Strong evidence from past experiments or data"
+    - "Very High (90%) — Near-certain, well-established pattern"
+\`\`\`
+
+Only call \`start_reasoning\` AFTER the user picks confidence.
+
+### Step 3: Prediction
+\`\`\`
+AskQuestion:
+  title: "Apex — Log a Prediction"
+  prompt: "What lift do you expect? Apex tracks prediction accuracy over time to sharpen your forecasting."
+  options:
+    - "Small lift (+5%) — Incremental improvement"
+    - "Moderate lift (+10%) — Meaningful change"
+    - "Large lift (+15-20%) — High-conviction bet"
+\`\`\`
+
+### Step 4: Variant Design
+Present ONE question at a time:
+
+First — what to change:
+\`\`\`
+AskQuestion:
+  title: "Apex — What to Change"
+  prompt: "Which element should we test? (Current page: [url])"
+  options: [2-3 specific elements from the page]
+\`\`\`
+
+Then — variant text:
+\`\`\`
+AskQuestion:
+  title: "Apex — Variant Content"
+  prompt: "What should the variant say? (Current: [original text])"
+  options: [2-3 suggestions based on the belief]
+\`\`\`
+
+Then — traffic allocation:
+\`\`\`
+AskQuestion:
+  title: "Apex — Traffic Allocation"
+  prompt: "How should Apex allocate traffic?"
+  options:
+    - "Adaptive (recommended) — Automatically shifts traffic toward the winning variant using Thompson Sampling"
+    - "Balanced 50/50 — Equal split, fastest to reach significance"
+    - "Conservative 80/20 — Minimal exposure to variant, lower risk"
+\`\`\`
+NOTE: "Adaptive" is the default and recommended option. It starts at 50/50 and Thompson Sampling adjusts automatically. These options must match what the Apex dashboard UI offers.
+
+### Step 5: Preview & Create
+Call \`create_experiment\` with preview=true. Present summary, then:
+
+\`\`\`
+AskQuestion:
+  title: "Apex — Confirm Experiment"
+  prompt: "[summary of experiment]"
+  options: Create it | Change variant text | Change traffic split | Cancel
+\`\`\`
+
+If confirmed, call \`create_experiment\` with preview=false.
+
+### Step 6: Implement (SDK mode)
+The create_experiment response contains an \`sdk\` recipe. Make the code changes:
+1. Import \`useApexVariant\` from \`@/lib/apex-sdk\`
+2. Add \`const variant = useApexVariant("<experimentId>")\`
+3. Wrap the target content in a variant conditional
+4. Show the diff, then:
+
+\`\`\`
+AskQuestion:
+  title: "Apex — Review Code Changes"
+  prompt: "Code changes ready. What's next?"
+  options: Preview locally | Edit the changes | Cancel
+\`\`\`
+
+### Step 7: Preview & Deploy
+After preview approval:
+
+\`\`\`
+AskQuestion:
+  title: "Apex — Deploy"
+  prompt: "Preview looks good?"
+  options: Commit & push | Make changes | Cancel
+\`\`\`
+
+Commit, push, call \`track_deployment\`.
+
+### Step 8: Activate
+\`\`\`
+AskQuestion:
+  title: "Apex — Go Live"
+  prompt: "Experiment deployed. Ready to start collecting data?"
+  options: Activate now | Keep as draft
+\`\`\`
+
+Start now.`,
+                        },
+                    },
+                ],
+            };
+        },
+    },
+    "experiment-review": {
+        name: "experiment-review",
+        description: "Review experiment results with Apex. See what happened, what it means, and decide what to do next.",
+        arguments: [
+            {
+                name: "experimentId",
+                description: "The ID of the experiment to review",
+                required: true,
+            },
+        ],
+        handler: (args) => {
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: `Review experiment ${args.experimentId} using Apex (Apex).
+
+## MANDATORY UX RULES
+Use \`AskQuestion\` tool for every decision. One question at a time. Title always starts with "Apex —".
+
+## Steps
+
+1. Call \`get_results\` to pull current data
+2. Present results clearly as a text summary (winner, lift, confidence, data volume)
+3. Use AskQuestion:
+
+\`\`\`
+AskQuestion:
+  title: "Apex — Experiment Results"
+  prompt: "[experiment name]: [summary of results]"
+  options:
+    - Promote winner (graduates the experiment)
+    - Keep running (need more data)
+    - Pause (stop collecting temporarily)
+    - Record outcome (log learnings to belief graph)
+    - Suggest next experiment
+\`\`\`
+
+If promoting a winner, the \`promote_winner\` response includes a code cleanup recipe for SDK experiments. Follow those instructions to graduate the code (remove useApexVariant conditional, keep only the winner).`,
+                        },
+                    },
+                ],
+            };
+        },
+    },
+};
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,gBAAgB,EAAE;QAChB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,sFAAsF;QACxF,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,gEAAgE;gBAC7E,QAAQ,EAAE,KAAK;aAChB;SACF;QACD,OAAO,EAAE,CAAC,IAA4B,EAAE,EAAE;YACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC/B,MAAM,KAAK,GAAG,QAAQ;gBACpB,CAAC,CAAC,+BAA+B,QAAQ,OAAO;gBAChD,CAAC,CAAC,EAAE,CAAC;YAEP,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAe;wBACrB,OAAO,EAAE;4BACP,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,GAAG,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6B1B,QAAQ,CAAC,CAAC,CAAC,uBAAuB,QAAQ,KAAK,CAAC,CAAC,CAAC,yDAAyD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAiHlG;yBACE;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;KACF;IAED,mBAAmB,EAAE;QACnB,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,oGAAoG;QACtG,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,oCAAoC;gBACjD,QAAQ,EAAE,IAAI;aACf;SACF;QACD,OAAO,EAAE,CAAC,IAA4B,EAAE,EAAE;YACxC,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAe;wBACrB,OAAO,EAAE;4BACP,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,qBAAqB,IAAI,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;qNAuB2J;yBACxM;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}

package/dist/resources.d.ts

@@ -0,0 +1,81 @@
+export declare const resourceDefinitions: {
+    beliefs: {
+        uri: string;
+        name: string;
+        description: string;
+        mimeType: string;
+        handler: () => Promise<{
+            contents: {
+                uri: string;
+                text: string;
+                mimeType: string;
+            }[];
+        }>;
+    };
+    activeExperiments: {
+        uri: string;
+        name: string;
+        description: string;
+        mimeType: string;
+        handler: () => Promise<{
+            contents: {
+                uri: string;
+                text: string;
+                mimeType: string;
+            }[];
+        }>;
+    };
+    ledger: {
+        uri: string;
+        name: string;
+        description: string;
+        mimeType: string;
+        handler: () => Promise<{
+            contents: {
+                uri: string;
+                text: string;
+                mimeType: string;
+            }[];
+        }>;
+    };
+    intelligenceScore: {
+        uri: string;
+        name: string;
+        description: string;
+        mimeType: string;
+        handler: () => Promise<{
+            contents: {
+                uri: string;
+                text: string;
+                mimeType: string;
+            }[];
+        }>;
+    };
+    intelligence: {
+        uri: string;
+        name: string;
+        description: string;
+        mimeType: string;
+        handler: () => Promise<{
+            contents: {
+                uri: string;
+                text: string;
+                mimeType: string;
+            }[];
+        }>;
+    };
+    calibration: {
+        uri: string;
+        name: string;
+        description: string;
+        mimeType: string;
+        handler: () => Promise<{
+            contents: {
+                uri: string;
+                text: string;
+                mimeType: string;
+            }[];
+        }>;
+    };
+};
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AA2DA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqM/B,CAAC"}