@apex-inc/mcp-server 0.33.0 → 0.35.0

package/dist/tool-groups.js

@@ -0,0 +1,213 @@
+export const TOOL_GROUPS = [
+    "Experiments",
+    "Letters",
+    "Adoption",
+    "Partners",
+    "Measurement",
+    "Accounts",
+    "Context",
+];
+const GROUP_BY_NAME = {
+    plan_experiment: "Experiments",
+    start_reasoning: "Experiments",
+    create_belief: "Experiments",
+    create_experiment: "Experiments",
+    attach_experiment_asset: "Experiments",
+    recapture_experiment_screenshots: "Experiments",
+    verify_experiment_wiring: "Experiments",
+    activate_experiment: "Experiments",
+    pause_experiment: "Experiments",
+    track_deployment: "Experiments",
+    check_deployment: "Experiments",
+    archive_experiment: "Experiments",
+    list_experiments: "Experiments",
+    get_results: "Experiments",
+    list_beliefs: "Experiments",
+    list_belief_suggestions: "Experiments",
+    accept_belief_suggestion: "Experiments",
+    update_experiment: "Experiments",
+    fork_experiment: "Experiments",
+    check_experiment_conflicts: "Experiments",
+    verify_ad_exclusion: "Experiments",
+    attach_ad_exclusion: "Experiments",
+    detach_ad_exclusion: "Experiments",
+    check_live_tests: "Experiments",
+    set_experiment_mutex: "Experiments",
+    suggest_experiment: "Experiments",
+    promote_winner: "Experiments",
+    get_experiment_results: "Experiments",
+    promote_experiment_winner: "Experiments",
+    graduate_experiment: "Experiments",
+    record_outcome: "Experiments",
+    predict_impact: "Experiments",
+    evaluate_feature: "Experiments",
+    link_experiment: "Experiments",
+    unlink_experiment: "Experiments",
+    gate_experiment_on_merge: "Experiments",
+    open_graduation_pr: "Experiments",
+    open_revert_pr: "Experiments",
+    get_automation_controls: "Experiments",
+    update_automation_controls: "Experiments",
+    list_engineering_links: "Experiments",
+    recommend_communications: "Letters",
+    generate_communications: "Letters",
+    list_communications: "Letters",
+    list_communication_themes: "Letters",
+    create_communication_theme: "Letters",
+    update_communication_theme: "Letters",
+    apply_communication_theme: "Letters",
+    edit_communication: "Letters",
+    publish_communication: "Letters",
+    preview_communication: "Letters",
+    add_communication_variant: "Letters",
+    send_test_communication: "Letters",
+    trigger_communication: "Letters",
+    create_comm_experiment: "Letters",
+    create_communication: "Letters",
+    create_journey: "Letters",
+    create_journey_from_template: "Letters",
+    list_trigger_contracts: "Letters",
+    set_journey_trigger: "Letters",
+    add_journey_step: "Letters",
+    set_journey_send: "Letters",
+    add_journey_branch: "Letters",
+    publish_journey: "Letters",
+    list_journeys: "Letters",
+    get_journey: "Letters",
+    list_journey_exits: "Letters",
+    add_journey_exit: "Letters",
+    remove_journey_exit: "Letters",
+    get_contact_cart: "Letters",
+    audit_journey_exits: "Letters",
+    wire_audience_seed: "Letters",
+    wire_audience: "Letters",
+    audit_audience_readiness: "Letters",
+    list_segments: "Letters",
+    get_segment: "Letters",
+    create_segment: "Letters",
+    list_adoption_milestones: "Adoption",
+    get_adoption_milestone: "Adoption",
+    create_adoption_milestone: "Adoption",
+    update_adoption_milestone: "Adoption",
+    delete_adoption_milestone: "Adoption",
+    compose_adoption_milestone: "Adoption",
+    attach_adoption_milestone_still: "Adoption",
+    recapture_adoption_milestone_stills: "Adoption",
+    list_adoption_milestone_stills: "Adoption",
+    reorder_adoption_milestones: "Adoption",
+    get_adoption_metrics: "Adoption",
+    get_adoption_account_progress: "Adoption",
+    get_adoption_user_progress: "Adoption",
+    list_adoption_features: "Adoption",
+    create_adoption_feature: "Adoption",
+    list_partner_programs: "Partners",
+    create_partner_program: "Partners",
+    update_partner_program: "Partners",
+    list_partner_program_members: "Partners",
+    apply_program_default_to_members: "Partners",
+    update_membership_rate: "Partners",
+    reset_membership_rate: "Partners",
+    invite_partner: "Partners",
+    list_pending_payouts: "Partners",
+    approve_payouts: "Partners",
+    reject_payouts: "Partners",
+    get_effective_fees: "Partners",
+    vouch_for_partner: "Partners",
+    list_events: "Measurement",
+    list_metrics: "Measurement",
+    get_growth_reality: "Measurement",
+    get_channel_economics: "Measurement",
+    get_saas_recurring_revenue: "Measurement",
+    get_saas_expansion: "Measurement",
+    get_ecommerce_product_sales: "Measurement",
+    list_product_costs: "Measurement",
+    set_product_cost: "Measurement",
+    upload_product_catalog: "Measurement",
+    get_ecommerce_returns: "Measurement",
+    get_marketplace_metrics: "Measurement",
+    track_event: "Measurement",
+    send_server_event: "Measurement",
+    identify_user: "Measurement",
+    get_schema: "Measurement",
+    map_attribute: "Measurement",
+    define_event: "Measurement",
+    log_prediction: "Measurement",
+    list_data_sources: "Measurement",
+    create_data_source: "Measurement",
+    get_data_source_health: "Measurement",
+    get_analytics_sources: "Measurement",
+    get_analytics_hostnames: "Measurement",
+    get_event_spec: "Measurement",
+    get_event_taxonomy: "Measurement",
+    get_wiring_status: "Measurement",
+    propose_wiring_plan: "Measurement",
+    apex_test_event: "Measurement",
+    apex_recent_events: "Measurement",
+    apex_health: "Measurement",
+    apex_spec_validate: "Measurement",
+    list_conversions: "Measurement",
+    create_conversion: "Measurement",
+    set_primary_conversion: "Measurement",
+    create_target: "Measurement",
+    list_ad_measurement: "Measurement",
+    set_ad_measurement_events: "Measurement",
+    list_apex_links: "Measurement",
+    create_apex_link: "Measurement",
+    get_skan_schema: "Measurement",
+    set_skan_schema: "Measurement",
+    get_conversion_source_of_truth: "Measurement",
+    set_conversion_source_of_truth: "Measurement",
+    list_accounts: "Accounts",
+    get_account: "Accounts",
+    get_account_people: "Accounts",
+    list_sub_accounts: "Accounts",
+    get_contact_groups: "Accounts",
+    update_account_pipeline: "Accounts",
+    list_workspaces: "Context",
+    list_projects: "Context",
+    switch_workspace: "Context",
+    switch_project: "Context",
+    list_orgs: "Context",
+    switch_org: "Context",
+    get_setup_state: "Context",
+    list_workspace_environments: "Context",
+    set_workspace_environments: "Context",
+    check_workspace_readiness: "Context",
+    start_apex_login: "Context",
+    start_integration_install: "Context",
+    create_api_key: "Context",
+    list_api_keys: "Context",
+    revoke_api_key: "Context",
+    update_organization: "Context",
+    update_workspace: "Context",
+    set_consent_posture: "Context",
+    set_app_surface_paths: "Context",
+    get_scoring_model: "Context",
+    set_scoring_weights: "Context",
+    invite_teammate: "Context",
+    set_engagement_analytics: "Context",
+    set_app_platforms: "Context",
+    set_attribution_model: "Context",
+    start_sender_domain: "Context",
+    get_sender_domain: "Context",
+    set_push_credentials: "Context",
+    set_protect_auto_pause: "Context",
+    claim_links_subdomain: "Context",
+    list_webhook_destinations: "Context",
+    add_webhook_destination: "Context",
+    get_messaging_guardrails: "Context",
+    set_messaging_guardrails: "Context",
+};
+export function toolGroup(name) {
+    return GROUP_BY_NAME[name];
+}
+export function countToolsByGroup(names) {
+    const counts = Object.fromEntries(TOOL_GROUPS.map((g) => [g, 0]));
+    for (const name of names) {
+        const group = toolGroup(name);
+        if (group)
+            counts[group] += 1;
+    }
+    return counts;
+}
+//# sourceMappingURL=tool-groups.js.map

package/dist/tool-groups.js.map

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

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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"}