@ema.co/mcp-toolkit 2026.2.24 → 2026.2.27

package/dist/mcp/handlers/persona/update.js

@@ -412,15 +412,41 @@ export async function handleUpdate(args, client) {
             hint: "Set preview=false to deploy these changes",
         };
     }
+    // Determine the state to set:
+    // - "ready" when deploying a workflow OR when explicitly enabling the persona
+    // - "inactive" when explicitly disabling the persona
+    // This matches the behavior of the Ema frontend
+    let stateToSet;
+    if (args.enabled === true) {
+        stateToSet = "ready";
+    }
+    else if (args.enabled === false) {
+        stateToSet = "inactive";
+    }
+    else if (workflowToSet) {
+        // Deploying a workflow implies activating the persona
+        stateToSet = "ready";
+    }
+    const updateRequest = {
+        persona_id: persona.id,
+        name: args.name,
+        description: args.description,
+        proto_config: mergedProtoConfig,
+        workflow: workflowToSet,
+        enabled_by_user: typeof args.enabled === "boolean" ? args.enabled : undefined,
+        ...(stateToSet ? { state: stateToSet } : {}),
+    };
+    // Debug: log what we're sending
+    console.error("[persona/update] Sending to API:", JSON.stringify({
+        persona_id: updateRequest.persona_id,
+        enabled_by_user: updateRequest.enabled_by_user,
+        state: updateRequest.state,
+        has_workflow: !!updateRequest.workflow,
+        has_proto_config: !!updateRequest.proto_config,
+    }));
     try {
-        await client.updateAiEmployee({
-            persona_id: persona.id,
-            name: args.name,
-            description: args.description,
-            proto_config: mergedProtoConfig,
-            workflow: workflowToSet,
-            enabled_by_user: typeof args.enabled === "boolean" ? args.enabled : undefined,
-        });
+        const apiResponse = await client.updateAiEmployee(updateRequest);
+        console.error("[persona/update] API response:", JSON.stringify(apiResponse));
     }
     catch (apiErr) {
         // Return structured error consistent with other handlers

package/dist/mcp/handlers/workflow/deploy.js

@@ -233,6 +233,9 @@ export async function handleWorkflowDeploy(args, client) {
             persona_id: personaId,
             workflow: sanitizedWorkflow,
             proto_config: protoConfigToUse,
+            // Set state to "ready" to activate the persona after deployment
+            // This matches the behavior of the Ema frontend
+            state: "ready",
         });
         // ═══════════════════════════════════════════════════════════════════════════
         // CRITICAL: Check for silent deployment failure

package/dist/mcp/handlers/workflow/validation.js

@@ -14,6 +14,7 @@
  * 2. Semantic validation (logic) - catches wiring/reference errors
  * 3. Best practices (warnings) - non-blocking suggestions
  */
+import { ConnectError, Code } from "@connectrpc/connect";
 import { validateWorkflowDefSchema } from "../../domain/workflow-def-schema.js";
 // Re-export schema validation for use by other handlers
 export { validateWorkflowDefSchema };
@@ -248,6 +249,7 @@ export async function validateSearchDataSourceConsistency(workflowDef, personaId
     // Try to get data source stats for each widget used by search nodes (at least one must have indexed data)
     let dataSourceStats = null;
     let lastError;
+    let isPermissionError = false;
     for (const widgetName of widgetNames) {
         try {
             const stats = await client.getDataSourceAggregates(personaId, widgetName);
@@ -261,13 +263,27 @@ export async function validateSearchDataSourceConsistency(workflowDef, personaId
         }
         catch (err) {
             lastError = err;
+            // Check for permission/auth errors - these should block, not warn
+            if (err instanceof ConnectError) {
+                if (err.code === Code.PermissionDenied || err.code === Code.Unauthenticated) {
+                    isPermissionError = true;
+                }
+            }
         }
     }
-    if (!dataSourceStats && lastError) {
-        console.error(`[validation] Could not verify data sources for ${personaId}`, lastError);
-    }
-    // If we couldn't get stats, allow through but warn (don't block on API errors)
+    // If we couldn't get stats, skip validation with appropriate warning
     if (!dataSourceStats) {
+        if (isPermissionError) {
+            const errorMsg = lastError instanceof ConnectError ? lastError.rawMessage : String(lastError);
+            // Permission to getDataSourceAggregates != permission to updateAiEmployee
+            // Skip validation but warn - don't block activation
+            return {
+                valid: true,
+                _warning: `Could not verify data source consistency - permission denied for data source API (${errorMsg}). Skipping this validation.`,
+                validation_skipped: "search_data_source_consistency_permission",
+            };
+        }
+        // Other errors (network, etc.) - also skip with warning
         return {
             valid: true,
             _warning: "Could not verify data source consistency - API error. Proceed with caution.",

package/dist/mcp/tools.js

@@ -45,6 +45,8 @@ export function generateTools(envNames, defaultEnv) {
 
 ## Update
 - \`persona(method="update", id="abc", config={...})\` - update config (name, description, widgets)
+- \`persona(method="update", id="abc", enabled=true)\` - activate persona
+- \`persona(method="update", id="abc", enabled=false)\` - deactivate persona
 
 **IMPORTANT (strict)**:
 - Always fetch latest state immediately before changing: \`persona(method="get", id="abc", include_fingerprint=true)\`
@@ -183,6 +185,10 @@ persona(
                         type: "object",
                         description: "Proto config to update - name, description, widgets (for method=update)"
                     },
+                    enabled: {
+                        type: "boolean",
+                        description: "Enable/disable persona (for method=update). Set to true to activate, false to deactivate.",
+                    },
                     base_fingerprint: {
                         type: "string",
                         description: "Fingerprint from persona(method='get', include_fingerprint=true). REQUIRED for method=update unless force=true (stale-state protection).",

package/dist/sdk/client-adapter.js

@@ -177,6 +177,8 @@ export class EmaClientAdapter {
             proto_config: req.proto_config,
             name: req.name,
             description: req.description,
+            state: req.state,
+            enabled_by_user: req.enabled_by_user,
         });
         return result;
     }

package/dist/sdk/ema-client.js

@@ -278,6 +278,8 @@ export class EmaClientV2 {
                 proto_config: data.proto_config,
                 name: data.name,
                 description: data.description,
+                state: data.state,
+                enabled_by_user: data.enabled_by_user,
             },
         });
         return result.data;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ema.co/mcp-toolkit",
-  "version": "2026.2.24",
+  "version": "2026.2.27",
   "description": "Ema AI Employee toolkit - MCP server, CLI, and SDK for managing AI Employees across environments",
   "type": "module",
   "main": "dist/index.js",