touchstone-mcp-tools 1.0.1 → 1.0.2

package/build/handlers/wolves-handler.d.ts

@@ -43,6 +43,14 @@ export declare class WolvesHandler {
             progression_parameters?: any[];
         }>;
     }): Promise<ToolResult>;
+    updateSubscribers(params: {
+        experiment_id: string;
+        subscribers: Array<{
+            id: string;
+            type: string;
+            tenantId: string;
+        }>;
+    }): Promise<ToolResult>;
     getExperiment(params: {
         experiment_id: string;
     }): Promise<ToolResult>;

package/build/handlers/wolves-handler.js

@@ -1,4 +1,18 @@
 import { WolvesApiClient } from "../utils/wolves-api.js";
+// Generate 8-character variant ID: 4 lowercase letters + 4 digits
+// Matches ExP-Hub UI convention (e.g., "kifj6658", "tvan3734")
+function generateVariantId() {
+    const letters = "abcdefghijklmnopqrstuvwxyz";
+    const digits = "0123456789";
+    let result = "";
+    for (let i = 0; i < 4; i++) {
+        result += letters.charAt(Math.floor(Math.random() * letters.length));
+    }
+    for (let i = 0; i < 4; i++) {
+        result += digits.charAt(Math.floor(Math.random() * digits.length));
+    }
+    return result;
+}
 export class WolvesHandler {
     api;
     constructor(api) {
@@ -39,13 +53,18 @@ export class WolvesHandler {
     }
     // Tool 5: create_experiment
     async createExperiment(params) {
+        // Auto-generate 8-char variant IDs for variants that don't have one
+        const variants = params.variants.map((v) => ({
+            ...v,
+            id: v.id || generateVariantId(),
+        }));
         const result = await this.api.createExperiment({
             name: params.name,
             description: params.description,
             experimentation_group: params.experimentation_group,
             assignment_unit_id: params.assignment_unit_id,
             subscribers: params.subscribers,
-            variants: params.variants,
+            variants,
             metrics: params.metrics,
             progressions: params.progressions,
         });
@@ -54,7 +73,17 @@ export class WolvesHandler {
             message: `Experiment "${result.name}" created (ID: ${result.id})`,
         };
     }
-    // Tool 6: get_experiment
+    // Tool 6: update_subscribers
+    async updateSubscribers(params) {
+        await this.api.updateSubscribers(params.experiment_id, {
+            subscribers: params.subscribers,
+        });
+        return {
+            data: { experiment_id: params.experiment_id, subscriber_count: params.subscribers.length },
+            message: `Updated ${params.subscribers.length} subscriber(s) for experiment "${params.experiment_id}"`,
+        };
+    }
+    // Tool 8: get_experiment
     async getExperiment(params) {
         const result = await this.api.getExperiment(params.experiment_id);
         return {
@@ -62,7 +91,7 @@ export class WolvesHandler {
             message: `Retrieved experiment "${result.name}" (status: ${result.status})`,
         };
     }
-    // Tool 7: list_experiments
+    // Tool 8: list_experiments
     async listExperiments(params) {
         const result = await this.api.listExperiments({
             page: params.page,

package/build/schemas/wolves-tools.json

@@ -92,7 +92,7 @@
                         "type": "object",
                         "required": ["type"],
                         "properties": {
-                            "id": { "type": "string", "description": "Variant ID (auto-generated if omitted)" },
+                            "id": { "type": "string", "description": "Variant ID. 8-character alphanumeric (4 letters + 4 digits, e.g., 'kifj6658'). Auto-generated if omitted." },
                             "type": { "type": "string", "enum": ["control", "treatment"], "description": "Variant type" },
                             "description": { "type": "string", "description": "Variant description" }
                         }
@@ -130,6 +130,33 @@
             }
         }
     },
+    "update_subscribers": {
+        "name": "update_subscribers",
+        "description": "Update subscribers for an experiment. Subscribers receive notifications about experiment changes. Requires subscriber objects with id, type, and tenantId (obtained from search_subscribers).",
+        "inputSchema": {
+            "type": "object",
+            "required": ["experiment_id", "subscribers"],
+            "properties": {
+                "experiment_id": {
+                    "type": "string",
+                    "description": "UUID of the experiment to update subscribers for"
+                },
+                "subscribers": {
+                    "type": "array",
+                    "description": "List of subscriber objects. Each subscriber must include id, type, and tenantId from search_subscribers results.",
+                    "items": {
+                        "type": "object",
+                        "required": ["id", "type", "tenantId"],
+                        "properties": {
+                            "id": { "type": "string", "description": "Subscriber's user ID (from search_subscribers)" },
+                            "type": { "type": "string", "description": "Subscriber type (e.g., 'UserAccount')" },
+                            "tenantId": { "type": "string", "description": "Subscriber's tenant ID (from search_subscribers)" }
+                        }
+                    }
+                }
+            }
+        }
+    },
     "get_experiment": {
         "name": "get_experiment",
         "description": "Get detailed information about a specific experiment by its ID.",

package/build/servers/wolves-server.js

@@ -42,6 +42,9 @@ export class WolvesServer {
                 case "create_experiment":
                     result = await this.handler.createExperiment(args);
                     break;
+                case "update_subscribers":
+                    result = await this.handler.updateSubscribers(args);
+                    break;
                 case "get_experiment":
                     result = await this.handler.getExperiment(args);
                     break;

package/build/utils/wolves-api.d.ts

@@ -44,6 +44,14 @@ export interface SubscriberSearchResult {
     type: string;
     tenantId: string;
 }
+export interface SubscriberInput {
+    id: string;
+    type: string;
+    tenantId: string;
+}
+export interface UpdateSubscribersRequest {
+    subscribers: SubscriberInput[];
+}
 export interface VariantInput {
     id?: string;
     type: "control" | "treatment";
@@ -124,6 +132,7 @@ export declare class WolvesApiClient {
     listAssignmentUnits(filter?: string): Promise<AssignmentUnitsListResponse>;
     searchSubscribers(search: string, count?: number, fetchUserPhoto?: boolean): Promise<SubscriberSearchResult[]>;
     createExperiment(data: CreateExperimentRequest): Promise<ExperimentDetail>;
+    updateSubscribers(experimentId: string, data: UpdateSubscribersRequest): Promise<void>;
     getExperiment(experimentId: string): Promise<ExperimentDetail>;
     listExperiments(params?: {
         page?: number;

package/build/utils/wolves-api.js

@@ -69,6 +69,9 @@ export class WolvesApiClient {
         const response = await this.client.post("/api/experiments/experiments", data);
         return response.data;
     }
+    async updateSubscribers(experimentId, data) {
+        await this.client.put(`/api/experiments/experiments/${encodeURIComponent(experimentId)}/subscribers`, data);
+    }
     async getExperiment(experimentId) {
         const response = await this.client.get(`/api/experiments/experiments/${experimentId}`);
         return response.data;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "touchstone-mcp-tools",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "MCP tools for TouchStone Experimentation platform",
   "type": "module",
   "main": "build/index.js",