@apex-inc/mcp-server 0.33.0 → 0.34.0

package/dist/tool-shared.d.ts

@@ -0,0 +1,300 @@
+import { z } from "zod";
+export interface Belief {
+    id: string;
+    statement: string;
+    confidence: number;
+    evidenceSupporting: unknown[];
+    evidenceContradicting: unknown[];
+    parentBeliefId?: string;
+    createdAt: string;
+    updatedAt: string;
+    validationState?: "unvalidated" | "validated";
+    generatedFromExperimentId?: string;
+}
+export interface MetricCatalogEntry {
+    key: string;
+    label: string;
+    type: "rate" | "count" | "revenue" | "duration";
+    outcomeTier: "outcome" | "proximal" | "internal";
+    measurable: boolean;
+    wired: "detected" | "waiting";
+    trailingVolume?: number;
+}
+export interface Hypothesis {
+    id: string;
+    beliefId: string;
+    statement: string;
+    predictedEffect: string;
+    confidence: number;
+    status: string;
+}
+export interface Prediction {
+    id: string;
+    hypothesisId: string;
+    beliefId: string;
+    metric: string;
+    expectedChange: number;
+    direction: "increase" | "decrease" | "no_change";
+    expectedRange: {
+        low: number;
+        high: number;
+    };
+    confidence: number;
+    timeHorizon: number;
+    evaluationWindow: number;
+    actualChange?: number;
+    accuracyScore?: number;
+}
+export interface DOMChange {
+    selector: string;
+    type: string;
+    value: string;
+    originalValue?: string;
+}
+export interface UnifiedVariant {
+    id: string;
+    key: string;
+    label: string;
+    surface: string;
+    createdAt: string;
+    description?: string;
+    mode?: "snippet" | "redirect" | "server_side" | "manual" | "sdk";
+    changes?: DOMChange[];
+    redirectUrl?: string;
+    screenshotUrl?: string;
+}
+export interface UnifiedExperiment {
+    id: string;
+    workspaceKey: string;
+    name: string;
+    surface: string;
+    status: string;
+    createdAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    variants: UnifiedVariant[];
+    primaryMetric: {
+        key: string;
+        label: string;
+        type: string;
+        unit: string;
+        direction: string;
+        source: {
+            kind: string;
+            eventType?: string;
+            property?: string;
+        };
+    };
+    allocation: {
+        strategy: string;
+        weights?: Record<string, number>;
+        thompsonPrior?: unknown;
+    };
+    hypothesis: string;
+    prediction: {
+        direction: string;
+        magnitude: string;
+    };
+    confidence: number;
+    beliefId?: string;
+    hypothesisId?: string;
+    predictionId?: string;
+    winner?: string;
+    winnerConfidence?: number;
+    results?: {
+        perVariant: Record<string, {
+            assigned: number;
+            participated: number;
+            converted: number;
+            conversionRate?: number;
+        }>;
+        winner?: string;
+        winnerConfidence?: number;
+    };
+    targetUrl?: string;
+    targetAnchor?: string;
+    createdFrom?: "dashboard" | "api" | "sdk" | "mcp" | "cursor";
+    previewUrl?: string;
+    deploymentCommit?: string;
+    deploymentStatus?: "pending" | "building" | "deployed" | "failed";
+    deployedAt?: string;
+    deployedBranch?: string;
+    graduated?: boolean;
+    promoted?: boolean;
+}
+/**
+ * Wiring verdict from `GET /api/experiments/{id}/wiring`.
+ *
+ * "Wiring" = are `experiment_exposure` events actually arriving for BOTH arms?
+ * An experiment can be configured perfectly but collect zero data if the
+ * variant-serving code (useApexVariant / Apex.getVariant) isn't deployed or
+ * running yet. This is the pre-launch safety check.
+ */
+export interface WiringResult {
+    experimentId: string;
+    surface: string;
+    status: string;
+    perArm: Array<{
+        variantKey: string;
+        label: string;
+        exposures: number;
+        lastSeenAt?: string;
+    }>;
+    armsLive: number;
+    totalArms: number;
+    bothArmsLive: boolean;
+    totalExposures: number;
+    /** Pageviews on the experiment's target page in the last 7 days. */
+    targetPageviews7d?: number;
+    lastTargetVisitAt?: string;
+    /** All web variants are SDK-hook wired — exposures need deployed code. */
+    sdkMode?: boolean;
+    /** All web variants are snippet-applied — exposures only exist once running,
+     *  so activation must not require pre-exposures (applied on activation). */
+    snippetMode?: boolean;
+    verdict: "wired" | "partial" | "no_exposures";
+}
+export interface GraduationRecipe {
+    experimentId: string;
+    experimentName: string;
+    mode: string;
+    targetUrl: string;
+    winner: string;
+    changes: DOMChange[];
+    graduatedAt: string | null;
+}
+export interface LedgerEntry {
+    id: string;
+    beliefId: string;
+    decision: string;
+    reasoning: string;
+    beliefUpdateFrom: number;
+    beliefUpdateTo: number;
+    createdAt: string;
+}
+export declare const APEX = "Apex";
+/**
+ * MOBX-006 — stable synthetic visitor id for agent-fired events.
+ *
+ * `/api/events` only counts an event toward wiring detection when it
+ * carries a top-level `visitorId`. A per-process random suffix keeps
+ * the id stable for the MCP server's lifetime (so repeated track_event
+ * calls roll up to one synthetic "visitor") while distinguishing
+ * separate agent sessions from each other.
+ */
+export declare const MCP_AGENT_VISITOR_ID: string;
+/** Control traffic % derived from the unified allocation weights (default 50). */
+export declare function controlPctOf(exp: UnifiedExperiment): number;
+/**
+ * Days running, derived locally from startedAt/createdAt → completedAt/now.
+ * The legacy web shape carried a server-computed `daysRunning`; the unified
+ * shape does not, so we compute it from the lifecycle timestamps.
+ */
+export declare function daysRunningOf(exp: UnifiedExperiment): number;
+/** Find a unified variant by its key (e.g. "control", "variant_a"). */
+export declare function findVariant(exp: UnifiedExperiment, key: string): UnifiedVariant | undefined;
+/** Render a per-arm exposure line for wiring summaries. */
+export declare function formatArmLine(arm: WiringResult["perArm"][number]): string;
+/** "add_to_cart" → "Add To Cart" (for primaryMetric labels). */
+export declare function titleCaseEvent(event: string): string;
+export declare function activeWorkspaceSiteUrl(): string | null;
+export declare function assertTargetUrlForActiveWorkspace(targetUrl: string): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+}>;
+/**
+ * Query string for the pack report windows: relative (`days` / `months`)
+ * or explicit `start` + `end` (YYYY-MM-DD, both required together —
+ * explicit bounds win server-side).
+ */
+export declare function windowQuery(opts: {
+    days?: number;
+    months?: number;
+    start?: string;
+    end?: string;
+}): string;
+export declare function errMsg(err: unknown): string;
+/** Build a dashboard deep link on the same host the MCP talks to (app origin). */
+export declare function appUrl(path: string): string;
+export declare function journeyLink(id: string): string;
+/**
+ * Detect a MOBILE experiment surface from repo signals (the MCP runs in the
+ * merchant's repo). Walks up a few dirs looking for capacitor.config.* or a
+ * Capacitor/RN dependency. Returns null when there's no mobile signal (web is
+ * the safe default — a website repo carries no special marker). QA 2026-06-18.
+ */
+export declare function detectSurfaceFromRepo(): "mobile" | null;
+/**
+ * Resolve the experiment surface. Explicit wins; otherwise detect from repo
+ * signals, then the workspace's registered data sources. Returns an `ambiguous`
+ * error only when both web and mobile data sources exist and there's no repo
+ * signal — in that case the agent must choose. (QA: stop defaulting to web.)
+ */
+export declare function resolveCreateSurface(explicit?: "web" | "mobile"): Promise<{
+    surface: "web" | "mobile";
+} | {
+    ambiguous: true;
+}>;
+/**
+ * Tenant echo (council CISO): never report a mutation as successful for a record
+ * outside the active workspace (guards a leaked/cross-workspace key).
+ */
+export declare function tenantOk(workspaceKey?: string): boolean;
+export declare function tenantMismatch(): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+};
+/**
+ * Shared schema + handler for `switch_workspace` (canonical) and its
+ * deprecated alias `switch_project`. Both register against the same handler
+ * so existing agent calls keep working through the project→workspace rename.
+ *
+ * After updating the active workspace locally, we VALIDATE the switch with an
+ * authed read against `/api/setup-state` (which `apiGet` scopes to the active
+ * workspace). Validation is non-fatal: the local switch always succeeds, but
+ * we surface an auth/reachability warning so the user knows to connect or
+ * fix the workspace key.
+ */
+export declare const switchWorkspaceSchema: z.ZodObject<{
+    workspaceKey: z.ZodOptional<z.ZodString>;
+    projectKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    workspaceKey?: string | undefined;
+    projectKey?: string | undefined;
+}, {
+    workspaceKey?: string | undefined;
+    projectKey?: string | undefined;
+}>;
+export declare function switchWorkspaceHandler(args: {
+    workspaceKey?: string;
+    projectKey?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+/**
+ * Shared handler for `list_workspaces` (canonical) and its deprecated alias
+ * `list_projects`. Both register against the same handler so existing agent
+ * calls keep working through the project→workspace rename.
+ */
+export declare function listWorkspacesHandler(): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=tool-shared.d.ts.map

package/dist/tool-shared.d.ts.map

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

package/dist/tool-shared.js

@@ -0,0 +1,319 @@
+import { z } from "zod";
+import { existsSync, readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { apiGet, setActiveWorkspace, getActiveWorkspace, getUserContext } from "./api-client.js";
+import { collectHosts, evaluateTargetUrl } from "./workspace-target-url.js";
+export const APEX = "Apex";
+/**
+ * MOBX-006 — stable synthetic visitor id for agent-fired events.
+ *
+ * `/api/events` only counts an event toward wiring detection when it
+ * carries a top-level `visitorId`. A per-process random suffix keeps
+ * the id stable for the MCP server's lifetime (so repeated track_event
+ * calls roll up to one synthetic "visitor") while distinguishing
+ * separate agent sessions from each other.
+ */
+export const MCP_AGENT_VISITOR_ID = `mcp-agent-${Math.random().toString(36).slice(2, 10)}`;
+/** Control traffic % derived from the unified allocation weights (default 50). */
+export function controlPctOf(exp) {
+    const w = exp.allocation?.weights?.control;
+    return typeof w === "number" ? Math.round(w * 100) : 50;
+}
+/**
+ * Days running, derived locally from startedAt/createdAt → completedAt/now.
+ * The legacy web shape carried a server-computed `daysRunning`; the unified
+ * shape does not, so we compute it from the lifecycle timestamps.
+ */
+export function daysRunningOf(exp) {
+    const start = exp.startedAt || exp.createdAt;
+    if (!start)
+        return 0;
+    const startMs = new Date(start).getTime();
+    if (Number.isNaN(startMs))
+        return 0;
+    const endMs = exp.completedAt ? new Date(exp.completedAt).getTime() : Date.now();
+    return Math.max(0, Math.floor((endMs - startMs) / 86_400_000));
+}
+/** Find a unified variant by its key (e.g. "control", "variant_a"). */
+export function findVariant(exp, key) {
+    return exp.variants?.find((v) => v.key === key);
+}
+/** Render a per-arm exposure line for wiring summaries. */
+export function formatArmLine(arm) {
+    const live = arm.exposures > 0;
+    const dot = live ? "●" : "○";
+    const seen = arm.lastSeenAt ? `, last seen ${arm.lastSeenAt}` : "";
+    return `  ${dot} ${arm.label} (${arm.variantKey}): ${arm.exposures} exposure${arm.exposures === 1 ? "" : "s"}${seen}`;
+}
+/** "add_to_cart" → "Add To Cart" (for primaryMetric labels). */
+export function titleCaseEvent(event) {
+    return event
+        .split(/[_\s]+/)
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+}
+export function activeWorkspaceSiteUrl() {
+    const ctx = getUserContext();
+    const key = getActiveWorkspace();
+    if (!ctx || !key)
+        return null;
+    for (const org of ctx.orgs) {
+        const match = org.workspaces.find((w) => w.workspaceKey === key);
+        if (match?.url)
+            return match.url;
+    }
+    return null;
+}
+export async function assertTargetUrlForActiveWorkspace(targetUrl) {
+    const namedSites = [];
+    let workspaceUrl = activeWorkspaceSiteUrl();
+    let catalogUnreadable = false;
+    try {
+        const env = await apiGet("/api/workspace/environments");
+        namedSites.push(...(env.data.production_hosts ?? []), ...(env.data.beta_hosts ?? []));
+        for (const row of env.data.known_hosts ?? []) {
+            namedSites.push(typeof row === "string" ? row : row.hostname ?? "");
+        }
+        if (env.data.workspace_url)
+            workspaceUrl = env.data.workspace_url;
+    }
+    catch {
+        catalogUnreadable = true;
+    }
+    let analyticsHosts = [];
+    try {
+        const json = await apiGet("/api/analytics/hostnames?limit=100");
+        analyticsHosts = json.data ?? [];
+    }
+    catch {
+        /* analytics is a supplement, not the source of truth */
+    }
+    const allowed = collectHosts({
+        analyticsHosts,
+        namedSites,
+        workspaceUrl,
+    });
+    if (allowed.length === 0 && catalogUnreadable) {
+        return {
+            ok: false,
+            message: "Could not load this workspace's sites (list_workspace_environments failed). Name the site with set_workspace_environments before setting target_url. Do not guess a brand domain or a sibling workspace's site.",
+        };
+    }
+    return evaluateTargetUrl(targetUrl, allowed);
+}
+/**
+ * Query string for the pack report windows: relative (`days` / `months`)
+ * or explicit `start` + `end` (YYYY-MM-DD, both required together —
+ * explicit bounds win server-side).
+ */
+export function windowQuery(opts) {
+    const params = new URLSearchParams();
+    if (opts.days)
+        params.set("days", String(opts.days));
+    if (opts.months)
+        params.set("months", String(opts.months));
+    if (opts.start && opts.end) {
+        params.set("start", opts.start);
+        params.set("end", opts.end);
+    }
+    const qs = params.toString();
+    return qs ? `?${qs}` : "";
+}
+export function errMsg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/** Build a dashboard deep link on the same host the MCP talks to (app origin). */
+export function appUrl(path) {
+    const base = process.env.APEX_URL || process.env.APEX_API_URL || "http://localhost:3001";
+    return `${base.replace(/\/$/, "")}${path}`;
+}
+export function journeyLink(id) {
+    return appUrl(`/dashboard/communications/journeys/${id}`);
+}
+/**
+ * Detect a MOBILE experiment surface from repo signals (the MCP runs in the
+ * merchant's repo). Walks up a few dirs looking for capacitor.config.* or a
+ * Capacitor/RN dependency. Returns null when there's no mobile signal (web is
+ * the safe default — a website repo carries no special marker). QA 2026-06-18.
+ */
+export function detectSurfaceFromRepo() {
+    try {
+        let dir = process.cwd();
+        for (let i = 0; i < 4; i++) {
+            for (const f of [
+                "capacitor.config.ts",
+                "capacitor.config.js",
+                "capacitor.config.json",
+                "capacitor.config.mjs",
+            ]) {
+                if (existsSync(join(dir, f)))
+                    return "mobile";
+            }
+            const pkgPath = join(dir, "package.json");
+            if (existsSync(pkgPath)) {
+                try {
+                    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+                    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+                    if (deps["@apex-inc/capacitor-plugin"] ||
+                        deps["@capacitor/core"] ||
+                        deps["react-native"]) {
+                        return "mobile";
+                    }
+                }
+                catch {
+                    /* unreadable package.json — keep walking */
+                }
+            }
+            const parent = dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    catch {
+        /* fs not available — fall through */
+    }
+    return null;
+}
+/**
+ * Resolve the experiment surface. Explicit wins; otherwise detect from repo
+ * signals, then the workspace's registered data sources. Returns an `ambiguous`
+ * error only when both web and mobile data sources exist and there's no repo
+ * signal — in that case the agent must choose. (QA: stop defaulting to web.)
+ */
+export async function resolveCreateSurface(explicit) {
+    if (explicit)
+        return { surface: explicit };
+    const repo = detectSurfaceFromRepo();
+    if (repo)
+        return { surface: repo };
+    try {
+        const ws = getActiveWorkspace();
+        if (ws) {
+            const r = await apiGet(`/api/workspaces/${encodeURIComponent(ws)}/readiness`);
+            const sources = r.data?.sources ?? [];
+            const hasMobile = sources.some((s) => s.kind === "ios" || s.kind === "android");
+            const hasWeb = sources.some((s) => s.kind === "website");
+            if (hasMobile && !hasWeb)
+                return { surface: "mobile" };
+            if (hasWeb && !hasMobile)
+                return { surface: "web" };
+            if (hasMobile && hasWeb)
+                return { ambiguous: true };
+        }
+    }
+    catch {
+        /* readiness unavailable — fall back to web */
+    }
+    return { surface: "web" };
+}
+/**
+ * Tenant echo (council CISO): never report a mutation as successful for a record
+ * outside the active workspace (guards a leaked/cross-workspace key).
+ */
+export function tenantOk(workspaceKey) {
+    const active = getActiveWorkspace();
+    return !active || !workspaceKey || workspaceKey === active;
+}
+export function tenantMismatch() {
+    return {
+        content: [
+            {
+                type: "text",
+                text: `${APEX} Refusing to confirm: the affected record belongs to a different workspace.`,
+            },
+        ],
+        isError: true,
+    };
+}
+/**
+ * Shared schema + handler for `switch_workspace` (canonical) and its
+ * deprecated alias `switch_project`. Both register against the same handler
+ * so existing agent calls keep working through the project→workspace rename.
+ *
+ * After updating the active workspace locally, we VALIDATE the switch with an
+ * authed read against `/api/setup-state` (which `apiGet` scopes to the active
+ * workspace). Validation is non-fatal: the local switch always succeeds, but
+ * we surface an auth/reachability warning so the user knows to connect or
+ * fix the workspace key.
+ */
+export const switchWorkspaceSchema = z.object({
+    workspaceKey: z.string().optional().describe("The workspace key to switch to."),
+    projectKey: z
+        .string()
+        .optional()
+        .describe("Deprecated alias of workspaceKey. Use workspaceKey."),
+});
+export async function switchWorkspaceHandler(args) {
+    const key = args.workspaceKey ?? args.projectKey;
+    if (!key) {
+        return {
+            content: [{
+                    type: "text",
+                    text: "Provide a workspaceKey to switch to (projectKey is accepted as a deprecated alias).",
+                }],
+            isError: true,
+        };
+    }
+    setActiveWorkspace(key);
+    const deprecationNote = !args.workspaceKey && args.projectKey
+        ? " (note: `projectKey` is deprecated — use `workspaceKey`.)"
+        : "";
+    // Validate the switch by reading setup-state for the now-active workspace.
+    let validation = " Verified — Apex can read this workspace.";
+    try {
+        await apiGet("/api/setup-state");
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (/\(401\)|\(403\)|authentication failed/i.test(message)) {
+            validation =
+                "\n\n⚠️ Switched locally, but could not verify the workspace — authentication failed. " +
+                    "Connect the MCP server to Apex (run any Apex tool to get a one-time approval link), " +
+                    "or regenerate APEX_API_KEY in Apex → Settings → AI Agents, then try again.";
+        }
+        else if (/\(404\)/.test(message)) {
+            validation =
+                `\n\n⚠️ Switched locally, but Apex returned 404 for "${key}" — the workspace key may be wrong. ` +
+                    "Use list_workspaces to see the valid keys for your API key.";
+        }
+        else {
+            validation = `\n\n⚠️ Switched locally, but could not reach Apex to verify it (${message}).`;
+        }
+    }
+    return {
+        content: [{
+                type: "text",
+                text: `Switched to workspace: ${key}. All subsequent calls will use this workspace.${deprecationNote}${validation}`,
+            }],
+    };
+}
+/**
+ * Shared handler for `list_workspaces` (canonical) and its deprecated alias
+ * `list_projects`. Both register against the same handler so existing agent
+ * calls keep working through the project→workspace rename.
+ */
+export async function listWorkspacesHandler() {
+    // NOTE: `/api/projects` is the PERMANENT alias path this tool has shipped
+    // against — it returns the flat row shape below. Do not point at
+    // `/api/workspaces` (different response shape).
+    const workspaces = await apiGet("/api/projects");
+    const current = getActiveWorkspace();
+    if (!workspaces.length) {
+        return {
+            content: [{ type: "text", text: "No workspaces found for this API key." }],
+        };
+    }
+    const lines = workspaces.map((p) => {
+        const active = p.workspaceKey === current ? " ← active" : "";
+        return `  ${p.workspaceKey} — ${p.name} (${p.url})${active}`;
+    });
+    return {
+        content: [{
+                type: "text",
+                text: [`Workspaces (${workspaces.length}):`, ...lines].join("\n"),
+            }],
+    };
+}
+//# sourceMappingURL=tool-shared.js.map

package/dist/tool-shared.js.map

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