@ema.co/mcp-toolkit 1.4.0 → 1.4.2

package/dist/mcp/handlers-consolidated.js

@@ -122,17 +122,32 @@ export async function handlePersona(args, client, getTemplateId, createClientFor
             if (!persona) {
                 return { error: `Persona not found: ${idOrName}` };
             }
+            // Merge new proto_config with existing, or use existing if not provided
+            const existingProtoConfig = persona.proto_config ?? {};
+            const newProtoConfig = args.proto_config;
+            const mergedProtoConfig = newProtoConfig
+                ? { ...existingProtoConfig, ...newProtoConfig } // Merge: new values override existing
+                : existingProtoConfig;
+            // IMPORTANT: The Ema API requires workflow to be sent along with proto_config
+            // for proto_config changes to persist. This matches what the UI does.
+            // Get full persona details to include workflow
+            const fullPersona = await client.getPersonaById(persona.id);
+            const existingWorkflow = fullPersona
+                ? (fullPersona.workflow_def ?? fullPersona.workflow)
+                : undefined;
             await client.updateAiEmployee({
                 persona_id: persona.id,
                 name: args.name,
                 description: args.description,
-                proto_config: persona.proto_config ?? {},
+                proto_config: mergedProtoConfig,
+                workflow: existingWorkflow, // Include workflow for proto_config to persist
                 enabled_by_user: typeof args.enabled === "boolean" ? args.enabled : undefined,
             });
             return {
                 success: true,
                 persona_id: persona.id,
                 updated_fields: Object.keys(args).filter(k => !["id", "identifier", "mode", "env"].includes(k)),
+                proto_config_updated: !!newProtoConfig,
             };
         }
         case "compare": {

package/dist/mcp/tools-consolidated.js

@@ -119,6 +119,10 @@ export function generateConsolidatedTools(envNames, defaultEnv) {
                 clone_from: { type: "string", description: "Clone from persona ID (for create)" },
                 // Update flags
                 enabled: { type: "boolean", description: "Enable/disable (for update)" },
+                proto_config: {
+                    type: "object",
+                    description: "Voice/chat settings (welcomeMessage, identityAndPurpose, etc.) for update"
+                },
                 // Compare flags
                 compare_to: { type: "string", description: "Second persona ID (for compare)" },
                 compare_env: { type: "string", description: "Environment of compare_to persona" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ema.co/mcp-toolkit",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "Ema AI Employee toolkit - MCP server, CLI, and SDK for managing AI Employees across environments",
   "type": "module",
   "main": "dist/index.js",
@@ -41,8 +41,10 @@
     "restart": "npm run stop && npm run dev",
     "restart:mcp": "npm run stop && npm run mcp",
     "cli": "tsx src/cli/index.ts",
-    "test": "vitest run",
-    "test:watch": "vitest",
+    "test": "vitest run --exclude 'test/integration/**'",
+    "test:watch": "vitest --exclude 'test/integration/**'",
+    "test:integration": "EMA_TEST_INTEGRATION=true vitest run test/integration/",
+    "test:all": "npm run test && npm run test:integration",
     "typecheck": "tsc --noEmit",
     "precommit": "npm run typecheck && npm run test",
     "prepare": "husky",

package/dist/config.js

@@ -1,136 +0,0 @@
-/**
- * Environment Configuration
- *
- * Defines Ema API environments and service settings.
- * Used by both MCP server and CLI/service modes.
- */
-import fs from "node:fs";
-import yaml from "js-yaml";
-import { z } from "zod";
-// ─────────────────────────────────────────────────────────────────────────────
-// Schema
-// ─────────────────────────────────────────────────────────────────────────────
-const EnvironmentSchema = z.object({
-    name: z.string().min(1),
-    baseUrl: z.string().url(),
-    bearerTokenEnv: z.string().min(1),
-    isMaster: z.boolean().optional().default(false),
-    // Deprecated but accepted for backward compatibility
-    userId: z.string().optional(),
-    templateIdMap: z.record(z.string()).optional(),
-});
-const SchedulerSchema = z.object({
-    intervalSeconds: z.number().int().positive().optional(),
-    cron: z.string().min(1).optional(),
-}).strict().refine((v) => v.cron || v.intervalSeconds, { message: "scheduler must set either intervalSeconds or cron" });
-const ServiceSchema = z.object({
-    stateDbPath: z.string().min(1).optional().default("./ema-state.sqlite3"),
-    scheduler: SchedulerSchema.optional(),
-}).strict();
-// Legacy schema for backward compatibility
-const LegacyRouteRuleSchema = z.object({
-    personaIds: z.array(z.string()).default([]),
-    targetEnvs: z.array(z.string()).default([]),
-    nameGlobs: z.array(z.string()).optional().default([]),
-    nameRegexes: z.array(z.string()).optional().default([]),
-    namePrefixes: z.array(z.string()).optional().default([]),
-}).passthrough();
-const AppConfigSchema = z.object({
-    environments: z.array(EnvironmentSchema).min(1),
-    service: ServiceSchema.optional(),
-    dryRun: z.boolean().optional().default(false),
-    verbose: z.boolean().optional().default(false),
-    // Legacy fields (kept for backward compatibility)
-    routing: z.array(LegacyRouteRuleSchema).optional(),
-    scheduler: SchedulerSchema.optional(),
-    stateDbPath: z.string().optional(),
-    eventSharedSecretEnv: z.string().optional(),
-}).refine((cfg) => {
-    // Validate at most one master
-    const masters = cfg.environments.filter((e) => e.isMaster);
-    return masters.length <= 1;
-}, { message: "At most one environment can be isMaster: true" });
-// ─────────────────────────────────────────────────────────────────────────────
-// Loading functions
-// ─────────────────────────────────────────────────────────────────────────────
-export function loadConfig(path) {
-    const raw = fs.readFileSync(path, "utf8");
-    const parsed = yaml.load(raw);
-    if (!parsed || typeof parsed !== "object") {
-        throw new Error("Invalid config YAML");
-    }
-    const res = AppConfigSchema.safeParse(parsed);
-    if (!res.success) {
-        const errors = res.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`);
-        throw new Error(`Invalid config: ${errors.join("; ")}`);
-    }
-    return res.data;
-}
-export function loadConfigOptional(path) {
-    try {
-        return loadConfig(path);
-    }
-    catch (e) {
-        if (e && typeof e === "object" && "code" in e && e.code === "ENOENT") {
-            return null;
-        }
-        const msg = e instanceof Error ? e.message : String(e);
-        if (msg.includes("ENOENT"))
-            return null;
-        throw e;
-    }
-}
-export function loadConfigFromJsonEnv() {
-    const raw = process.env.EMA_CONFIG_JSON ?? process.env.EMA_AGENT_SYNC_CONFIG_JSON;
-    if (!raw)
-        return null;
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        throw new Error("EMA_CONFIG_JSON is not valid JSON");
-    }
-    const res = validateConfig(parsed);
-    if (!res.ok) {
-        throw new Error(`Invalid EMA_CONFIG_JSON: ${res.errors.join("; ")}`);
-    }
-    return res.config;
-}
-export function validateConfig(input) {
-    const res = AppConfigSchema.safeParse(input);
-    if (!res.success) {
-        return { ok: false, errors: res.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`) };
-    }
-    return { ok: true, config: res.data };
-}
-export function configToYaml(cfg) {
-    return yaml.dump(cfg, { noRefs: true, sortKeys: true });
-}
-// ─────────────────────────────────────────────────────────────────────────────
-// Utilities
-// ─────────────────────────────────────────────────────────────────────────────
-export function resolveBearerToken(envVarName) {
-    const v = process.env[envVarName];
-    if (!v)
-        throw new Error(`Missing bearer token env var: ${envVarName}`);
-    // Strip "Bearer " prefix if user included it
-    const trimmed = v.trim();
-    if (trimmed.toLowerCase().startsWith("bearer ")) {
-        return trimmed.slice(7).trim();
-    }
-    return trimmed;
-}
-export function assertEnvVarsPresent(cfg) {
-    for (const e of cfg.environments) {
-        if (!process.env[e.bearerTokenEnv]) {
-            throw new Error(`Missing required env var for ${e.name}: ${e.bearerTokenEnv}`);
-        }
-    }
-}
-export function getMasterEnv(cfg) {
-    return cfg.environments.find((e) => e.isMaster);
-}
-export function getEnvByName(cfg, name) {
-    return cfg.environments.find((e) => e.name === name);
-}

package/dist/emaClient.js

@@ -1,398 +0,0 @@
-export class EmaApiError extends Error {
-    statusCode;
-    body;
-    constructor(opts) {
-        super(opts.message);
-        this.statusCode = opts.statusCode;
-        this.body = opts.body;
-        this.name = "EmaApiError";
-    }
-}
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-export class EmaClient {
-    env;
-    timeoutMs;
-    constructor(env, opts) {
-        this.env = env;
-        this.timeoutMs = opts?.timeoutMs ?? 30_000;
-    }
-    async requestWithRetries(method, path, opts) {
-        const retries = opts?.retries ?? 4;
-        const baseDelayMs = opts?.baseDelayMs ?? 500;
-        let lastErr;
-        for (let attempt = 0; attempt <= retries; attempt++) {
-            try {
-                const controller = new AbortController();
-                const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
-                const fullUrl = `${this.env.baseUrl.replace(/\/$/, "")}${path}`;
-                const response = await fetch(fullUrl, {
-                    method,
-                    headers: {
-                        Authorization: `Bearer ${this.env.bearerToken}`,
-                        "Content-Type": "application/json",
-                    },
-                    body: opts?.json !== undefined ? JSON.stringify(opts.json) : undefined,
-                    signal: controller.signal,
-                });
-                clearTimeout(timeoutId);
-                // Retry on transient errors
-                if ([429, 500, 502, 503, 504].includes(response.status) && attempt < retries) {
-                    const delay = baseDelayMs * 2 ** attempt;
-                    await sleep(delay);
-                    continue;
-                }
-                return response;
-            }
-            catch (e) {
-                lastErr = e instanceof Error ? e : new Error(String(e));
-                if (attempt >= retries)
-                    throw lastErr;
-                const delay = baseDelayMs * 2 ** attempt;
-                await sleep(delay);
-            }
-        }
-        throw lastErr ?? new Error("Unreachable");
-    }
-    // ─────────────────────────────────────────────────────────────────────────────
-    // AI Employees (Personas)
-    // ─────────────────────────────────────────────────────────────────────────────
-    async getPersonasForTenant() {
-        // Try POST first (original API), fall back to GET if 405
-        let resp = await this.requestWithRetries("POST", "/api/personas/get_personas_for_tenant", {
-            json: {},
-        });
-        // If POST fails with 405, try GET method
-        if (resp.status === 405) {
-            resp = await this.requestWithRetries("GET", "/api/personas/get_personas_for_tenant", {});
-        }
-        if (!resp.ok) {
-            throw new EmaApiError({
-                statusCode: resp.status,
-                body: await resp.text(),
-                message: `get_personas_for_tenant failed (${this.env.name})`,
-            });
-        }
-        const data = (await resp.json());
-        const personas = data.personas ?? data.configs ?? [];
-        return personas;
-    }
-    /** Alias: in the UI, personas are called "AI Employees" */
-    async getAiEmployeesForTenant() {
-        return this.getPersonasForTenant();
-    }
-    /**
-     * Get a single persona by ID with full details including workflow_def.
-     * Uses /api/personas/{id} endpoint which returns the complete persona including workflow_def.
-     */
-    async getPersonaById(personaId) {
-        // #region agent log
-        fetch('http://127.0.0.1:7242/ingest/4b191179-efb6-478a-b628-20269a94f0b3', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ location: 'emaClient.ts:getPersonaById:start', message: 'Fetching full persona details', data: { env: this.env.name, personaId }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'workflow-fix', hypothesisId: 'D' }) }).catch(() => { });
-        // #endregion
-        // Primary: /api/personas/{id} - returns full persona with workflow_def
-        try {
-            const resp = await this.requestWithRetries("GET", `/api/personas/${personaId}`, {});
-            if (resp.ok) {
-                const persona = (await resp.json());
-                // #region agent log
-                const wfActions = persona?.workflow_def?.actions;
-                fetch('http://127.0.0.1:7242/ingest/4b191179-efb6-478a-b628-20269a94f0b3', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ location: 'emaClient.ts:getPersonaById:success', message: 'Got full persona from /api/personas/{id}', data: { env: this.env.name, personaId, hasWorkflowDef: !!persona?.workflow_def, workflowActionsCount: Array.isArray(wfActions) ? wfActions.length : 0 }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'workflow-fix', hypothesisId: 'D' }) }).catch(() => { });
-                // #endregion
-                return persona;
-            }
-        }
-        catch {
-            // Fall through to fallback
-        }
-        // Fallback: /api/ai_employee/get_ai_employee endpoint
-        try {
-            const resp = await this.requestWithRetries("GET", `/api/ai_employee/get_ai_employee?persona_id=${personaId}`, {});
-            if (resp.ok) {
-                const data = (await resp.json());
-                const persona = data.persona ?? data.ai_employee ?? data.config ?? null;
-                // #region agent log
-                fetch('http://127.0.0.1:7242/ingest/4b191179-efb6-478a-b628-20269a94f0b3', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ location: 'emaClient.ts:getPersonaById:fallback', message: 'Got persona from fallback endpoint', data: { env: this.env.name, personaId, hasWorkflowDef: !!persona?.workflow_def }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'workflow-fix', hypothesisId: 'D' }) }).catch(() => { });
-                // #endregion
-                return persona;
-            }
-        }
-        catch {
-            // Fall through to return null
-        }
-        return null;
-    }
-    /**
-     * Get workflow definition by workflow_id.
-     * Tries multiple API endpoints to fetch the workflow.
-     */
-    async getWorkflowDef(workflowId) {
-        // Try gRPC-web style GetWorkflow endpoint
-        try {
-            const resp = await this.requestWithRetries("POST", "/workflows.v1.WorkflowManager/GetWorkflow", {
-                json: { workflow_id: workflowId },
-            });
-            if (resp.ok) {
-                const data = (await resp.json());
-                return data.workflow ?? (Object.keys(data).length > 0 ? data : null);
-            }
-        }
-        catch {
-            // Fall through
-        }
-        // Try GetWorkflowDefinition endpoint (alternate name)
-        try {
-            const resp = await this.requestWithRetries("POST", "/workflows.v1.WorkflowManager/GetWorkflowDefinition", {
-                json: { workflow_id: workflowId },
-            });
-            if (resp.ok) {
-                const data = (await resp.json());
-                return data;
-            }
-        }
-        catch {
-            // Fall through
-        }
-        // Try listing actions and constructing workflow
-        try {
-            const actions = await this.listActionsFromWorkflow(workflowId);
-            if (actions && actions.length > 0) {
-                // Return actions as part of workflow def (partial reconstruction)
-                return { workflow_id: workflowId, actions: actions };
-            }
-        }
-        catch {
-            // Fall through
-        }
-        return null;
-    }
-    async updateAiEmployee(req, opts) {
-        // #region agent log
-        if (opts?.verbose) {
-            fetch('http://127.0.0.1:7242/ingest/4b191179-efb6-478a-b628-20269a94f0b3', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ location: 'emaClient.ts:updateAiEmployee:fullRequest', message: 'FULL UPDATE REQUEST', data: { env: this.env.name, fullRequest: req }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'verbose-test', hypothesisId: 'full-request' }) }).catch(() => { });
-        }
-        // #endregion
-        const resp = await this.requestWithRetries("POST", "/api/ai_employee/update_ai_employee", {
-            json: req,
-        });
-        if (!resp.ok) {
-            const body = await resp.text();
-            // #region agent log
-            fetch('http://127.0.0.1:7242/ingest/4b191179-efb6-478a-b628-20269a94f0b3', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ location: 'emaClient.ts:updateAiEmployee:error', message: 'UPDATE FAILED', data: { env: this.env.name, status: resp.status, body }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'verbose-test', hypothesisId: 'api-error' }) }).catch(() => { });
-            // #endregion
-            throw new EmaApiError({
-                statusCode: resp.status,
-                body,
-                message: `update_ai_employee failed (${this.env.name})`,
-            });
-        }
-        const result = (await resp.json());
-        // #region agent log
-        if (opts?.verbose) {
-            fetch('http://127.0.0.1:7242/ingest/4b191179-efb6-478a-b628-20269a94f0b3', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ location: 'emaClient.ts:updateAiEmployee:response', message: 'UPDATE RESPONSE', data: { env: this.env.name, responseKeys: Object.keys(result), response: result }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'verbose-test', hypothesisId: 'full-response' }) }).catch(() => { });
-        }
-        // #endregion
-        return result;
-    }
-    async createAiEmployee(req, opts) {
-        // #region agent log
-        if (opts?.verbose) {
-            fetch('http://127.0.0.1:7242/ingest/4b191179-efb6-478a-b628-20269a94f0b3', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ location: 'emaClient.ts:createAiEmployee:fullRequest', message: 'FULL CREATE REQUEST', data: { env: this.env.name, fullRequest: req }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'verbose-test', hypothesisId: 'full-request' }) }).catch(() => { });
-        }
-        // #endregion
-        const resp = await this.requestWithRetries("POST", "/api/ai_employee/create_ai_employee", {
-            json: req,
-        });
-        if (!resp.ok) {
-            const body = await resp.text();
-            // #region agent log
-            fetch('http://127.0.0.1:7242/ingest/4b191179-efb6-478a-b628-20269a94f0b3', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ location: 'emaClient.ts:createAiEmployee:error', message: 'CREATE FAILED', data: { env: this.env.name, status: resp.status, body }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'verbose-test', hypothesisId: 'api-error' }) }).catch(() => { });
-            // #endregion
-            throw new EmaApiError({
-                statusCode: resp.status,
-                body,
-                message: `create_ai_employee failed (${this.env.name})`,
-            });
-        }
-        const result = (await resp.json());
-        // #region agent log
-        if (opts?.verbose) {
-            fetch('http://127.0.0.1:7242/ingest/4b191179-efb6-478a-b628-20269a94f0b3', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ location: 'emaClient.ts:createAiEmployee:response', message: 'CREATE RESPONSE', data: { env: this.env.name, responseKeys: Object.keys(result), response: result }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'verbose-test', hypothesisId: 'full-response' }) }).catch(() => { });
-        }
-        // #endregion
-        return result;
-    }
-    // ─────────────────────────────────────────────────────────────────────────────
-    // Actions (displayed as "Agents" in the UI)
-    // ─────────────────────────────────────────────────────────────────────────────
-    /**
-     * List all actions available to the tenant.
-     * API endpoint: workflows.v1.ActionManager/ListActions
-     * UI label: "Agents"
-     */
-    async listActions() {
-        const resp = await this.requestWithRetries("POST", "/workflows.v1.ActionManager/ListActions", {
-            json: {},
-        });
-        if (!resp.ok) {
-            throw new EmaApiError({
-                statusCode: resp.status,
-                body: await resp.text(),
-                message: `listActions failed (${this.env.name})`,
-            });
-        }
-        const data = (await resp.json());
-        return data.actions ?? [];
-    }
-    /** Alias: in the UI, actions are called "Agents" */
-    async listAgents() {
-        return this.listActions();
-    }
-    /**
-     * List actions associated with a specific workflow.
-     * API endpoint: workflows.v1.ActionManager/ListActionsFromWorkflow
-     * UI label: "Agents"
-     *
-     * @param workflowId - The workflow ID to list actions for
-     */
-    async listActionsFromWorkflow(workflowId) {
-        const resp = await this.requestWithRetries("POST", "/workflows.v1.ActionManager/ListActionsFromWorkflow", { json: { workflow_id: workflowId } });
-        if (!resp.ok) {
-            throw new EmaApiError({
-                statusCode: resp.status,
-                body: await resp.text(),
-                message: `listActionsFromWorkflow failed (${this.env.name})`,
-            });
-        }
-        const data = (await resp.json());
-        return data.actions ?? [];
-    }
-    /** Alias: in the UI, actions are called "Agents" */
-    async listAgentsFromWorkflow(workflowId) {
-        return this.listActionsFromWorkflow(workflowId);
-    }
-    // ─────────────────────────────────────────────────────────────────────────────
-    // Sync Metadata (tagging synced personas)
-    // ─────────────────────────────────────────────────────────────────────────────
-    /**
-     * Sync tag regex patterns.
-     * Current format: <!-- synced_from:env/id -->
-     * Legacy formats also supported for backward compatibility.
-     */
-    static SYNC_TAG_REGEX = /<!-- synced_from:([^/]+)\/([a-f0-9-]+) -->/;
-    static LEGACY_JSON_REGEX = /<!-- _ema_sync:(.+?) -->/;
-    /**
-     * Get sync metadata from a persona's description.
-     * Returns null if the persona has never been synced.
-     */
-    getSyncMetadata(persona) {
-        // Check top-level description for sync tag
-        const desc = persona.description;
-        if (desc) {
-            const meta = this.extractSyncMetadataFromString(desc);
-            if (meta)
-                return meta;
-        }
-        // Fallback: check proto_config._ema_sync (legacy)
-        const protoConfig = persona.proto_config;
-        if (protoConfig?._ema_sync) {
-            return protoConfig._ema_sync;
-        }
-        return null;
-    }
-    /**
-     * Extract sync metadata from a string (description field).
-     * Supports both new compact format and legacy JSON format.
-     */
-    extractSyncMetadataFromString(text) {
-        // Try new compact format: <!-- synced_from:env/id -->
-        const compactMatch = text.match(EmaClient.SYNC_TAG_REGEX);
-        if (compactMatch) {
-            return {
-                master_env: compactMatch[1],
-                master_id: compactMatch[2],
-                synced_at: new Date().toISOString(),
-            };
-        }
-        // Try legacy JSON format: <!-- _ema_sync:{...} -->
-        const legacyMatch = text.match(EmaClient.LEGACY_JSON_REGEX);
-        if (legacyMatch) {
-            try {
-                return JSON.parse(legacyMatch[1]);
-            }
-            catch {
-                return null;
-            }
-        }
-        return null;
-    }
-    /**
-     * Check if a persona was synced from a master environment.
-     */
-    isSyncedPersona(persona) {
-        return this.getSyncMetadata(persona) !== null;
-    }
-    /**
-     * Regex to clean all sync tag formats from description.
-     */
-    static SYNC_CLEANUP_REGEX = /<!-- (?:synced_from|sync|_ema_sync):[^\n]*-->/g;
-    /**
-     * Extract the clean description (without sync marker).
-     */
-    getCleanDescription(description) {
-        if (!description)
-            return "";
-        return description.replace(EmaClient.SYNC_CLEANUP_REGEX, "").trim();
-    }
-    /**
-     * Build description with compact sync tag appended.
-     */
-    buildDescriptionWithSyncTag(cleanDescription, metadata) {
-        const marker = `<!-- synced_from:${metadata.master_env}/${metadata.master_id} -->`;
-        return cleanDescription ? `${cleanDescription}\n\n${marker}` : marker;
-    }
-    /**
-     * Tag a persona as synced by appending metadata to description.
-     */
-    async tagAsSynced(personaId, metadata, currentDescription, existingProtoConfig) {
-        const cleanDesc = this.getCleanDescription(currentDescription);
-        const newDescription = this.buildDescriptionWithSyncTag(cleanDesc, metadata);
-        await this.updateAiEmployee({
-            persona_id: personaId,
-            proto_config: existingProtoConfig ?? {},
-            description: newDescription,
-        });
-    }
-    /**
-     * Remove sync metadata from a persona (unlink from master).
-     */
-    async removeSyncTag(personaId, currentDescription, existingProtoConfig) {
-        const cleanDesc = this.getCleanDescription(currentDescription);
-        await this.updateAiEmployee({
-            persona_id: personaId,
-            proto_config: existingProtoConfig ?? {},
-            description: cleanDesc,
-        });
-    }
-    /**
-     * List all personas that have sync metadata (were synced from master).
-     */
-    async listSyncedPersonas() {
-        const personas = await this.getPersonasForTenant();
-        const synced = [];
-        for (const p of personas) {
-            const meta = this.getSyncMetadata(p);
-            if (meta) {
-                synced.push({ persona: p, syncMetadata: meta });
-            }
-        }
-        return synced;
-    }
-    /**
-     * Find a synced persona by its master environment and master ID.
-     */
-    async findSyncedPersona(masterEnv, masterId) {
-        const synced = await this.listSyncedPersonas();
-        return (synced.find((s) => s.syncMetadata.master_env === masterEnv && s.syncMetadata.master_id === masterId) ?? null);
-    }
-}

package/dist/models.js

@@ -1,8 +0,0 @@
-// ─────────────────────────────────────────────────────────────────────────────
-// Sync Metadata (stored in description as HTML comment)
-// ─────────────────────────────────────────────────────────────────────────────
-/**
- * The key used to store sync metadata in status_log.
- * Prefixed with underscore to indicate internal/system use.
- */
-export const SYNC_METADATA_KEY = "_ema_sync";

package/dist/state.js

@@ -1,88 +0,0 @@
-import Database from "better-sqlite3";
-export class StateStore {
-    db;
-    mapTable = "persona_map_v2";
-    fpTable = "persona_fingerprint_v2";
-    runsTable = "sync_runs_v2";
-    constructor(path) {
-        this.db = new Database(path);
-        this.db.pragma("journal_mode = WAL");
-        this.migrate();
-    }
-    close() {
-        this.db.close();
-    }
-    migrate() {
-        this.db.exec(`
-      CREATE TABLE IF NOT EXISTS ${this.mapTable} (
-        master_env TEXT NOT NULL,
-        master_user_id TEXT NOT NULL,
-        master_persona_id TEXT NOT NULL,
-        target_env TEXT NOT NULL,
-        target_user_id TEXT NOT NULL,
-        target_persona_id TEXT NOT NULL,
-        PRIMARY KEY (master_env, master_user_id, master_persona_id, target_env, target_user_id)
-      );
-
-      CREATE TABLE IF NOT EXISTS ${this.fpTable} (
-        env TEXT NOT NULL,
-        env_user_id TEXT NOT NULL,
-        persona_id TEXT NOT NULL,
-        fingerprint TEXT NOT NULL,
-        last_seen_at TEXT NOT NULL,
-        PRIMARY KEY (env, env_user_id, persona_id)
-      );
-
-      CREATE TABLE IF NOT EXISTS ${this.runsTable} (
-        id TEXT PRIMARY KEY,
-        master_env TEXT NOT NULL,
-        master_env_user_id TEXT NOT NULL,
-        started_at TEXT NOT NULL,
-        finished_at TEXT,
-        status TEXT NOT NULL,
-        error TEXT
-      );
-    `);
-    }
-    getMapping(args) {
-        const row = this.db
-            .prepare(`SELECT target_persona_id
-         FROM ${this.mapTable}
-         WHERE master_env = ? AND master_user_id = ? AND master_persona_id = ? AND target_env = ? AND target_user_id = ?`)
-            .get(args.masterEnv, args.masterUserId, args.masterPersonaId, args.targetEnv, args.targetUserId);
-        return row?.target_persona_id ?? null;
-    }
-    upsertMapping(row) {
-        this.db
-            .prepare(`INSERT INTO ${this.mapTable} (master_env, master_user_id, master_persona_id, target_env, target_user_id, target_persona_id)
-         VALUES (?, ?, ?, ?, ?, ?)
-         ON CONFLICT(master_env, master_user_id, master_persona_id, target_env, target_user_id)
-         DO UPDATE SET target_persona_id = excluded.target_persona_id`)
-            .run(row.master_env, row.master_user_id, row.master_persona_id, row.target_env, row.target_user_id, row.target_persona_id);
-    }
-    getFingerprint(args) {
-        const row = this.db
-            .prepare(`SELECT fingerprint FROM ${this.fpTable} WHERE env = ? AND env_user_id = ? AND persona_id = ?`)
-            .get(args.env, args.envUserId, args.personaId);
-        return row?.fingerprint ?? null;
-    }
-    upsertFingerprint(row) {
-        this.db
-            .prepare(`INSERT INTO ${this.fpTable} (env, env_user_id, persona_id, fingerprint, last_seen_at)
-         VALUES (?, ?, ?, ?, ?)
-         ON CONFLICT(env, env_user_id, persona_id)
-         DO UPDATE SET fingerprint = excluded.fingerprint, last_seen_at = excluded.last_seen_at`)
-            .run(row.env, row.env_user_id, row.persona_id, row.fingerprint, row.last_seen_at);
-    }
-    beginRun(row) {
-        this.db
-            .prepare(`INSERT INTO ${this.runsTable} (id, master_env, master_env_user_id, started_at, status)
-         VALUES (?, ?, ?, ?, ?)`)
-            .run(row.id, row.master_env, row.master_env_user_id, row.started_at, row.status);
-    }
-    finishRun(args) {
-        this.db
-            .prepare(`UPDATE ${this.runsTable} SET finished_at = ?, status = ?, error = ? WHERE id = ?`)
-            .run(args.finishedAt, args.status, args.error ?? null, args.id);
-    }
-}

package/dist/syncOptions.js

@@ -1,216 +0,0 @@
-/**
- * Sync Options Configuration
- *
- * Hierarchical configuration for sync behavior, loaded from:
- * 1. .ema.yaml in repo root (shared team defaults)
- * 2. ~/.ema.yaml in user home (personal overrides)
- * 3. Tool parameters (runtime overrides)
- *
- * Resolution order (lowest → highest priority):
- * Built-in defaults → defaults → targets[env] → personas[name] → tool params
- */
-import fs from "node:fs";
-import path from "node:path";
-import os from "node:os";
-import yaml from "js-yaml";
-import { z } from "zod";
-// ─────────────────────────────────────────────────────────────────────────────
-// Schema
-// ─────────────────────────────────────────────────────────────────────────────
-const SyncBehaviorSchema = z.object({
-    sync_status: z.boolean().optional(),
-    dry_run: z.boolean().optional(),
-}).strict();
-const RoutingRuleSchema = z.object({
-    match: z.object({
-        names: z.array(z.string()).optional().default([]),
-        ids: z.array(z.string()).optional().default([]),
-    }).strict(),
-    targets: z.array(z.string()).min(1),
-}).strict();
-const SyncOptionsConfigSchema = z.object({
-    defaults: SyncBehaviorSchema.optional().default({}),
-    targets: z.record(SyncBehaviorSchema).optional().default({}),
-    personas: z.record(SyncBehaviorSchema).optional().default({}),
-    routing: z.array(RoutingRuleSchema).optional().default([]),
-}).strict();
-// ─────────────────────────────────────────────────────────────────────────────
-// Built-in defaults
-// ─────────────────────────────────────────────────────────────────────────────
-const BUILTIN_DEFAULTS = {
-    sync_status: false,
-    dry_run: false,
-};
-// ─────────────────────────────────────────────────────────────────────────────
-// Config loading
-// ─────────────────────────────────────────────────────────────────────────────
-let cachedSyncOptions = null;
-function loadYamlFile(filePath) {
-    try {
-        const content = fs.readFileSync(filePath, "utf8");
-        return yaml.load(content);
-    }
-    catch {
-        return null;
-    }
-}
-function findRepoRoot() {
-    // Start from current working directory and look for .git or package.json
-    let dir = process.cwd();
-    while (dir !== path.dirname(dir)) {
-        if (fs.existsSync(path.join(dir, ".git")) || fs.existsSync(path.join(dir, "package.json"))) {
-            return dir;
-        }
-        dir = path.dirname(dir);
-    }
-    return process.cwd();
-}
-/**
- * Load and merge sync options from all config sources.
- * Caches result for performance.
- */
-export function loadSyncOptions() {
-    if (cachedSyncOptions)
-        return cachedSyncOptions;
-    const repoRoot = findRepoRoot();
-    const homeDir = os.homedir();
-    // Load from repo .ema.yaml
-    const repoConfigPath = path.join(repoRoot, ".ema.yaml");
-    const repoConfig = loadYamlFile(repoConfigPath);
-    // Load from ~/.ema.yaml
-    const userConfigPath = path.join(homeDir, ".ema.yaml");
-    const userConfig = loadYamlFile(userConfigPath);
-    // Merge configs (user overrides repo)
-    const merged = {
-        defaults: {},
-        targets: {},
-        personas: {},
-        routing: [],
-    };
-    // Apply repo config
-    if (repoConfig && typeof repoConfig === "object") {
-        const parsed = SyncOptionsConfigSchema.safeParse(repoConfig);
-        if (parsed.success) {
-            merged.defaults = { ...merged.defaults, ...parsed.data.defaults };
-            merged.targets = { ...merged.targets, ...parsed.data.targets };
-            merged.personas = { ...merged.personas, ...parsed.data.personas };
-            merged.routing = [...(parsed.data.routing ?? [])];
-        }
-    }
-    // Apply user config (overrides repo)
-    if (userConfig && typeof userConfig === "object") {
-        const parsed = SyncOptionsConfigSchema.safeParse(userConfig);
-        if (parsed.success) {
-            merged.defaults = { ...merged.defaults, ...parsed.data.defaults };
-            // Deep merge targets
-            for (const [env, behavior] of Object.entries(parsed.data.targets ?? {})) {
-                merged.targets[env] = { ...merged.targets[env], ...behavior };
-            }
-            // Deep merge personas
-            for (const [name, behavior] of Object.entries(parsed.data.personas ?? {})) {
-                merged.personas[name] = { ...merged.personas[name], ...behavior };
-            }
-            // Prepend user routing rules (higher priority)
-            merged.routing = [...(parsed.data.routing ?? []), ...merged.routing];
-        }
-    }
-    cachedSyncOptions = merged;
-    return merged;
-}
-/**
- * Clear the cached sync options (for testing or config reload).
- */
-export function clearSyncOptionsCache() {
-    cachedSyncOptions = null;
-}
-/**
- * Resolve sync behavior for a specific persona and target environment.
- *
- * Resolution order (lowest → highest priority):
- * 1. Built-in defaults
- * 2. Config defaults
- * 3. Config targets[targetEnv]
- * 4. Config personas[personaName]
- * 5. Runtime overrides (passed as parameter)
- */
-export function resolveSyncBehavior(opts) {
-    const { personaName, targetEnv, overrides } = opts;
-    const config = loadSyncOptions();
-    // Start with built-in defaults
-    const resolved = { ...BUILTIN_DEFAULTS };
-    // Apply config defaults
-    if (config.defaults) {
-        if (config.defaults.sync_status !== undefined)
-            resolved.sync_status = config.defaults.sync_status;
-        if (config.defaults.dry_run !== undefined)
-            resolved.dry_run = config.defaults.dry_run;
-    }
-    // Apply target env overrides
-    const targetConfig = config.targets?.[targetEnv];
-    if (targetConfig) {
-        if (targetConfig.sync_status !== undefined)
-            resolved.sync_status = targetConfig.sync_status;
-        if (targetConfig.dry_run !== undefined)
-            resolved.dry_run = targetConfig.dry_run;
-    }
-    // Apply persona overrides
-    if (personaName) {
-        const personaConfig = config.personas?.[personaName];
-        if (personaConfig) {
-            if (personaConfig.sync_status !== undefined)
-                resolved.sync_status = personaConfig.sync_status;
-            if (personaConfig.dry_run !== undefined)
-                resolved.dry_run = personaConfig.dry_run;
-        }
-    }
-    // Apply runtime overrides
-    if (overrides) {
-        if (overrides.sync_status !== undefined)
-            resolved.sync_status = overrides.sync_status;
-        if (overrides.dry_run !== undefined)
-            resolved.dry_run = overrides.dry_run;
-    }
-    return resolved;
-}
-// ─────────────────────────────────────────────────────────────────────────────
-// Routing
-// ─────────────────────────────────────────────────────────────────────────────
-/**
- * Check if a string matches a glob pattern (simple implementation).
- * Supports * as wildcard.
- */
-function matchGlob(pattern, value) {
-    const regex = new RegExp("^" + pattern.replace(/\*/g, ".*") + "$");
-    return regex.test(value);
-}
-/**
- * Get target environments for a persona based on routing rules.
- */
-export function getRoutingTargets(personaName, personaId) {
-    const config = loadSyncOptions();
-    const targets = new Set();
-    for (const rule of config.routing ?? []) {
-        // Check name patterns
-        for (const pattern of rule.match.names ?? []) {
-            if (matchGlob(pattern, personaName)) {
-                rule.targets.forEach((t) => targets.add(t));
-                break;
-            }
-        }
-        // Check IDs
-        if (rule.match.ids?.includes(personaId)) {
-            rule.targets.forEach((t) => targets.add(t));
-        }
-    }
-    return [...targets];
-}
-/**
- * Validate sync options config.
- */
-export function validateSyncOptions(input) {
-    const result = SyncOptionsConfigSchema.safeParse(input);
-    if (!result.success) {
-        return { ok: false, errors: result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`) };
-    }
-    return { ok: true, config: result.data };
-}