@ema.co/mcp-toolkit 2026.2.13 → 2026.2.23-1

package/dist/sdk/generated/api-client/client.gen.js

@@ -1,3 +1,3 @@
 // This file is auto-generated by @hey-api/openapi-ts
-import { createClient, createConfig } from './client';
+import { createClient, createConfig } from './client/index.js';
 export const client = createClient(createConfig({ baseUrl: 'https://api.ema.co' }));

package/dist/sdk/generated/api-client/core/utils.gen.js

@@ -1,5 +1,5 @@
 // This file is auto-generated by @hey-api/openapi-ts
-import { serializeArrayParam, serializeObjectParam, serializePrimitiveParam, } from './pathSerializer.gen';
+import { serializeArrayParam, serializeObjectParam, serializePrimitiveParam, } from './pathSerializer.gen.js';
 export const PATH_PARAM_RE = /\{[^{}]+\}/g;
 export const defaultPathSerializer = ({ path, url: _url }) => {
     let url = _url;

package/dist/sdk/generated/api-client/index.js

@@ -1,2 +1,2 @@
 // This file is auto-generated by @hey-api/openapi-ts
-export { archiveProjectById, createChatbotConversation, createConversation, createDocument, createPersona, createPersonaTemplate, createProject, createProjectTemplate, deleteConversation, deletePersona, deletePersonaTemplate, deleteProjectTemplate, editChartSnippet, emailActionImage, emailActionLink, emailActionUnsubscribe, fetchTicketUpdates, getChatbotConfig, getChatHistory, getConversationMessages, getConversationMessagesPaginated, getDefaultPersonaTemplateAccessSettingsForTenant, getLinkedInAuthUrl, getLogoUploadUrl, getMailLoginUrlForPersona, getPersonaAccessLevelById, getPersonaById, getPersonaTemplateById, getProjectById, getProjectsForPersona, getProjectTemplateByPersonaId, getWelcomeMessage, grantPersonaTemplateAccess, healthBasicCheck, healthCheck, importPersona, linkedinAccountNotification, linkedinActionLink, listAllPersonaTemplates, listAvailablePhoneNumbers, listConversations, listConversationsForPersona, listConversationsPaginated, listPersonas, listPersonaTemplates, listPersonaTemplatesPost, listSavedSnippets, metrics, processWebPrompt, provisionPhoneNumber, regenerateDocument, retrieveDocument, revokePersonaTemplateAccess, saveSnippet, sendChatMessage, sendChatMessageAsync, setDefaultPersonaTemplateAccessSetting, setPersonaTemplateAccessSettingsForNewSubTenant, streamChatbotConversationsCsv, triggerProjectWorkflow, unsaveSnippet, updateConversationDisplayName, updateDataUploadStatus, updateDocument, updateMessageFeedback, updatePersona, updatePersonaTemplate, updateProject, updateProjectTemplate, uploadLogo, verifyLogoUpload } from './sdk.gen';
+export { archiveProjectById, createChatbotConversation, createConversation, createDocument, createPersona, createPersonaTemplate, createProject, createProjectTemplate, deleteConversation, deletePersona, deletePersonaTemplate, deleteProjectTemplate, editChartSnippet, emailActionImage, emailActionLink, emailActionUnsubscribe, fetchTicketUpdates, getChatbotConfig, getChatHistory, getConversationMessages, getConversationMessagesPaginated, getDefaultPersonaTemplateAccessSettingsForTenant, getLinkedInAuthUrl, getLogoUploadUrl, getMailLoginUrlForPersona, getPersonaAccessLevelById, getPersonaById, getPersonaTemplateById, getProjectById, getProjectsForPersona, getProjectTemplateByPersonaId, getWelcomeMessage, grantPersonaTemplateAccess, healthBasicCheck, healthCheck, importPersona, linkedinAccountNotification, linkedinActionLink, listAllPersonaTemplates, listAvailablePhoneNumbers, listConversations, listConversationsForPersona, listConversationsPaginated, listPersonas, listPersonaTemplates, listPersonaTemplatesPost, listSavedSnippets, metrics, processWebPrompt, provisionPhoneNumber, regenerateDocument, retrieveDocument, revokePersonaTemplateAccess, saveSnippet, sendChatMessage, sendChatMessageAsync, setDefaultPersonaTemplateAccessSetting, setPersonaTemplateAccessSettingsForNewSubTenant, streamChatbotConversationsCsv, triggerProjectWorkflow, unsaveSnippet, updateConversationDisplayName, updateDataUploadStatus, updateDocument, updateMessageFeedback, updatePersona, updatePersonaTemplate, updateProject, updateProjectTemplate, uploadLogo, verifyLogoUpload } from './sdk.gen.js';

package/dist/sdk/generated/api-client/sdk.gen.js

@@ -1,6 +1,6 @@
 // This file is auto-generated by @hey-api/openapi-ts
-import { formDataBodySerializer } from './client';
-import { client } from './client.gen';
+import { formDataBodySerializer } from './client/index.js';
+import { client } from './client.gen.js';
 /**
  * Metrics
  *

package/dist/sdk/generated/well-known-types.js

@@ -0,0 +1,99 @@
+/**
+ * Auto-generated well-known type constants from Ema Platform proto definitions.
+ * Generated at: 2026-02-20T06:49:59.625Z
+ *
+ * DO NOT EDIT MANUALLY — regenerate with: npm run generate:type-compatibility
+ *
+ * Source: values_pb.ts (synced weekly from protos/service/workflows/v1/values.proto)
+ */
+/** All active well-known types with metadata. */
+export const WELL_KNOWN_TYPES = [
+    { name: "WELL_KNOWN_TYPE_STRING", shortName: "STRING", value: 1, description: "Primitives" },
+    { name: "WELL_KNOWN_TYPE_INT", shortName: "INT", value: 2, description: "" },
+    { name: "WELL_KNOWN_TYPE_FLOAT", shortName: "FLOAT", value: 3, description: "" },
+    { name: "WELL_KNOWN_TYPE_BOOL", shortName: "BOOL", value: 4, description: "" },
+    { name: "WELL_KNOWN_TYPE_STRUCT", shortName: "STRUCT", value: 14, description: "Untyped key-value dictionary" },
+    { name: "WELL_KNOWN_TYPE_DOCUMENT", shortName: "DOCUMENT", value: 5, description: "Complex types that are built-in to the system" },
+    { name: "WELL_KNOWN_TYPE_DATASTORE_CONNECTION", shortName: "DATASTORE_CONNECTION", value: 7, description: "Complex types that are generally used as config values" },
+    { name: "WELL_KNOWN_TYPE_FUSION_LLM_CONFIG", shortName: "FUSION_LLM_CONFIG", value: 8, description: "" },
+    { name: "WELL_KNOWN_TYPE_SEARCH_RESULT", shortName: "SEARCH_RESULT", value: 9, description: "" },
+    { name: "WELL_KNOWN_TYPE_EMAIL_ACCOUNT_CONFIG", shortName: "EMAIL_ACCOUNT_CONFIG", value: 28, description: "" },
+    { name: "WELL_KNOWN_TYPE_BOOST_TERM", shortName: "BOOST_TERM", value: 10, description: "Boost term and associated boost factor for reranking search results, specifically for extractive segments." },
+    { name: "WELL_KNOWN_TYPE_TEXT_WITH_SOURCES", shortName: "TEXT_WITH_SOURCES", value: 11, description: "Text with sources, used to represent a text with associated sources." },
+    { name: "WELL_KNOWN_TYPE_CHAT_CONVERSATION", shortName: "CHAT_CONVERSATION", value: 13, description: "Chat conversation or conversational context." },
+    { name: "WELL_KNOWN_TYPE_GLOSSARY_ITEM", shortName: "GLOSSARY_ITEM", value: 15, description: "A glossary item (term (string) and definition (string)). Glossary would be a list of these items." },
+    { name: "WELL_KNOWN_TYPE_EXTRACTION_COLUMN", shortName: "EXTRACTION_COLUMN", value: 16, description: "Extraction column, used to represent an extraction column in a table." },
+    { name: "WELL_KNOWN_TYPE_RULESET", shortName: "RULESET", value: 17, description: "RuleSet" },
+    { name: "WELL_KNOWN_TYPE_TAG_EXTRACTION_CONFIG", shortName: "TAG_EXTRACTION_CONFIG", value: 18, description: "Tag extraction config used to extract tag values given keys to a context dictionary for a tag dimension. These tag values are passed to Search action to filter/boost search results." },
+    { name: "WELL_KNOWN_TYPE_DATA_PROTECTION_CONFIG", shortName: "DATA_PROTECTION_CONFIG", value: 19, description: "Uses the DataProtectionConfig proto to store data protection configuration." },
+    { name: "WELL_KNOWN_TYPE_CHART", shortName: "CHART", value: 20, description: "A chart, which contains a family (value-based, frequency-based, xy-based), a type (bar, line, pie, etc.), a title and the data that is required to render the chart." },
+    { name: "WELL_KNOWN_TYPE_DATE", shortName: "DATE", value: 21, description: "Date type" },
+    { name: "WELL_KNOWN_TYPE_DATETIME", shortName: "DATETIME", value: 22, description: "DateTime type" },
+    { name: "WELL_KNOWN_TYPE_DOCUMENT_TEMPLATE", shortName: "DOCUMENT_TEMPLATE", value: 23, description: "Document template type" },
+    { name: "WELL_KNOWN_TYPE_ANY", shortName: "ANY", value: 24, description: "Any type" },
+    { name: "WELL_KNOWN_TYPE_THREAD", shortName: "THREAD", value: 25, description: "Ticketing Thread type" },
+    { name: "WELL_KNOWN_TYPE_JSON_MAPPER_CONFIG", shortName: "JSON_MAPPER_CONFIG", value: 26, description: "JSON Mapper Config type" },
+    { name: "WELL_KNOWN_TYPE_DOCUMENT_VERSION_ID", shortName: "DOCUMENT_VERSION_ID", value: 27, description: "Document version id well known type" },
+    { name: "WELL_KNOWN_TYPE_HUMAN_COLLABORATION_CONFIG", shortName: "HUMAN_COLLABORATION_CONFIG", value: 29, description: "Human Collaboration Config type for HITL agent" },
+];
+/** Deprecated well-known types (kept for backwards compatibility). */
+export const DEPRECATED_WELL_KNOWN_TYPES = [
+    { name: "WELL_KNOWN_TYPE_CHAT_MESSAGE", shortName: "CHAT_MESSAGE", value: 12, replacement: "WELL_KNOWN_TYPE_CHAT_CONVERSATION" },
+];
+export const BASE_TYPE_COMPATIBILITY = [
+    { sourceType: "WELL_KNOWN_TYPE_STRING", targetType: "WELL_KNOWN_TYPE_STRING", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_INT", targetType: "WELL_KNOWN_TYPE_INT", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_FLOAT", targetType: "WELL_KNOWN_TYPE_FLOAT", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_BOOL", targetType: "WELL_KNOWN_TYPE_BOOL", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_STRUCT", targetType: "WELL_KNOWN_TYPE_STRUCT", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_DOCUMENT", targetType: "WELL_KNOWN_TYPE_DOCUMENT", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_DATASTORE_CONNECTION", targetType: "WELL_KNOWN_TYPE_DATASTORE_CONNECTION", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_FUSION_LLM_CONFIG", targetType: "WELL_KNOWN_TYPE_FUSION_LLM_CONFIG", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_SEARCH_RESULT", targetType: "WELL_KNOWN_TYPE_SEARCH_RESULT", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_EMAIL_ACCOUNT_CONFIG", targetType: "WELL_KNOWN_TYPE_EMAIL_ACCOUNT_CONFIG", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_BOOST_TERM", targetType: "WELL_KNOWN_TYPE_BOOST_TERM", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_TEXT_WITH_SOURCES", targetType: "WELL_KNOWN_TYPE_TEXT_WITH_SOURCES", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_CHAT_CONVERSATION", targetType: "WELL_KNOWN_TYPE_CHAT_CONVERSATION", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_GLOSSARY_ITEM", targetType: "WELL_KNOWN_TYPE_GLOSSARY_ITEM", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_EXTRACTION_COLUMN", targetType: "WELL_KNOWN_TYPE_EXTRACTION_COLUMN", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_RULESET", targetType: "WELL_KNOWN_TYPE_RULESET", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_TAG_EXTRACTION_CONFIG", targetType: "WELL_KNOWN_TYPE_TAG_EXTRACTION_CONFIG", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_DATA_PROTECTION_CONFIG", targetType: "WELL_KNOWN_TYPE_DATA_PROTECTION_CONFIG", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_CHART", targetType: "WELL_KNOWN_TYPE_CHART", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_DATE", targetType: "WELL_KNOWN_TYPE_DATE", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_DATETIME", targetType: "WELL_KNOWN_TYPE_DATETIME", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_DOCUMENT_TEMPLATE", targetType: "WELL_KNOWN_TYPE_DOCUMENT_TEMPLATE", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_ANY", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_THREAD", targetType: "WELL_KNOWN_TYPE_THREAD", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_JSON_MAPPER_CONFIG", targetType: "WELL_KNOWN_TYPE_JSON_MAPPER_CONFIG", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_DOCUMENT_VERSION_ID", targetType: "WELL_KNOWN_TYPE_DOCUMENT_VERSION_ID", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_HUMAN_COLLABORATION_CONFIG", targetType: "WELL_KNOWN_TYPE_HUMAN_COLLABORATION_CONFIG", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_STRING", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_INT", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_FLOAT", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_BOOL", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_STRUCT", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_DOCUMENT", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_DATASTORE_CONNECTION", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_FUSION_LLM_CONFIG", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_SEARCH_RESULT", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_EMAIL_ACCOUNT_CONFIG", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_BOOST_TERM", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_TEXT_WITH_SOURCES", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_CHAT_CONVERSATION", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_GLOSSARY_ITEM", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_EXTRACTION_COLUMN", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_RULESET", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_TAG_EXTRACTION_CONFIG", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_DATA_PROTECTION_CONFIG", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_CHART", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_DATE", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_DATETIME", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_DOCUMENT_TEMPLATE", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_THREAD", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_JSON_MAPPER_CONFIG", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_DOCUMENT_VERSION_ID", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+    { sourceType: "WELL_KNOWN_TYPE_HUMAN_COLLABORATION_CONFIG", targetType: "WELL_KNOWN_TYPE_ANY", compatible: true },
+];
+/** Set of all active well-known type names for O(1) lookup. */
+export const WELL_KNOWN_TYPE_NAMES = new Set(WELL_KNOWN_TYPES.map(t => t.name));

package/dist/sdk/generated/widget-catalog.js

@@ -0,0 +1,60 @@
+/**
+ * Widget Catalog — Intentionally Static (NO API Alternative)
+ *
+ * WHY STATIC: There is no API endpoint to list widget definitions. Widget metadata
+ * lives in persona template YAML files and is not exposed via the API.
+ *
+ * RUNTIME ALTERNATIVE: For a specific persona, fetch widgets dynamically via:
+ *   persona(id="...", include_workflow=true) → proto_config.widgets[].name
+ *
+ * SOURCE: ema-repos/ema/ema_backend/db/system_values/persona_templates/prod/*.yaml
+ * SYNC: Manual - run knowledge scan workflow to detect template changes
+ *
+ * TECHNICAL NOTES:
+ * - Widget 'id' is the WidgetType enum value from protos
+ * - Widget 'name' is assigned per-template (e.g., "upload", "upload1", "upload2")
+ * - Proto 'case' values represent TYPE discriminators, not widget names
+ *
+ * See .context/core/guides/source-repos.md for full sync instructions
+ */
+export const WIDGET_CATALOG = [
+    // ═══════════════════════════════════════════════════════════════════════════
+    // Voice AI Widgets
+    // ═══════════════════════════════════════════════════════════════════════════
+    // SOURCE: voicebot_ai_employee.yaml
+    // LAST VERIFIED: 2026-01-27
+    { id: 38, name: "voiceSettings", description: "Language hints, voice model selection (title: 'Voice and language')", requiredFor: ["voice"], fields: ["languageHints", "voiceModel"] },
+    { id: 39, name: "conversationSettings", description: "Identity, purpose, action instructions, hangup rules (title: 'Conversational behavior')", requiredFor: ["voice"], fields: ["welcomeMessage", "identityAndPurpose", "takeActionInstructions", "hangupInstructions", "transferCallInstructions", "speechCharacteristics", "systemPrompt", "formFillingInstructions", "waitMessage"] },
+    { id: 43, name: "vadSettings", description: "Voice activity detection settings", requiredFor: ["voice"], fields: ["turnTimeout", "silenceEndCallTimeout", "maxConversationDuration"] },
+    { id: 42, name: "dataStorageSettings", description: "Audio/transcript recording settings", requiredFor: ["voice"], fields: ["storeAudioRecording", "storeTranscripts", "storeAgentTranscript"] },
+    { id: 41, name: "callSettings", description: "Call forwarding, spam prevention settings", requiredFor: ["voice"], fields: ["enableCallForwarding", "callForwardingNumber", "enableSpamCallPrevention"] },
+    { id: 44, name: "voicebotPhoneNumber", description: "Phone number configuration (title: 'Phone numbers')", requiredFor: ["voice"], fields: ["phoneNumber"] },
+    { id: 40, name: "voicebotFeedbackCollection", description: "Post-call feedback collection (title: 'Feedback collection')", requiredFor: ["voice"], fields: [] },
+    // ═══════════════════════════════════════════════════════════════════════════
+    // Chat AI Widgets
+    // ═══════════════════════════════════════════════════════════════════════════
+    // SOURCE: TBD - need to verify from chat template
+    { id: 28, name: "chatbotSdkConfig", description: "Chat widget configuration and theming", requiredFor: ["chat"], fields: ["theme", "position", "initialMessage"] },
+    { id: 33, name: "feedbackMessage", description: "Feedback collection settings", requiredFor: ["chat"], fields: ["enabled", "prompt"] },
+    // ═══════════════════════════════════════════════════════════════════════════
+    // Document Generation Widgets
+    // ═══════════════════════════════════════════════════════════════════════════
+    // SOURCE: ema-repos/ema/ema_backend/db/system_values/persona_templates/prod/document_proposal_manager.yaml
+    // NOTE: Widget names are defined per-template. These are from Document Proposal Manager.
+    //       To sync: see .context/core/guides/source-repos.md
+    // LAST VERIFIED: 2026-01-27 from document_proposal_manager.yaml
+    { id: 3, name: "upload", description: "Content Repository - gold standard company docs (title: 'Content Repository')", requiredFor: ["document"], fields: ["tags"], uploadTarget: true },
+    { id: 3, name: "upload1", description: "Service Line Documents - business unit specific content (title: 'Service Line Documents')", requiredFor: ["document"], fields: ["tags"], uploadTarget: true },
+    { id: 3, name: "upload2", description: "Style Guide - formatting and tone guide (title: 'Style Guide')", requiredFor: ["document"], fields: ["tags"], uploadTarget: true },
+    { id: 29, name: "fileTagging0", description: "File tagging configuration (title: 'Set Tags')", requiredFor: ["document"], fields: ["tagTypes", "fileTagMappings"] },
+    { id: 5, name: "answerFormat0", description: "Proposal instructions - format, tone, language (title: 'Proposal Instructions')", requiredFor: ["document"], fields: ["textValue"] },
+    { id: 16, name: "sectionConfigWidget", description: "Section categories with instructions (title: 'Section Categories')", requiredFor: ["document"], fields: ["sections"] },
+    // ═══════════════════════════════════════════════════════════════════════════
+    // Common Widgets (all types)
+    // ═══════════════════════════════════════════════════════════════════════════
+    // These appear across multiple template types
+    { id: 3, name: "fileUpload", description: "Default document upload (KB files, title: 'Data sources')", requiredFor: ["voice", "chat", "dashboard"], fields: ["allowedTypes", "maxSize"], uploadTarget: true },
+    { id: 6, name: "fusionModel", description: "EmaFusion model selection (GPT-4, Claude, etc., title: 'EmaFusion™ model')", requiredFor: ["voice", "chat", "dashboard", "document"], fields: ["allModels", "selectedModels"] },
+    { id: 8, name: "dataProtection", description: "PII redaction settings", requiredFor: ["voice", "chat", "dashboard", "document"], fields: ["protectedClasses"] },
+    { id: 9, name: "copyrightCheck", description: "Copyright infringement checker (title: 'Copyright Checker')", requiredFor: ["document"], fields: [] },
+];

package/dist/sdk/grpc-client.js

@@ -17,6 +17,10 @@ import { ActionManager, ListActionsRequestSchema, ListActionsFromWorkflowRequest
 import { DashboardsService, GetDashboardRowsRequestSchema, GetDashboardSchemaRequestSchema, } from './generated/protos/service/workflows/v1/dashboards_pb.js';
 import { WorkflowManager, CheckWorkflowRequestSchema, GetWorkflowRequestSchema, } from './generated/protos/service/workflows/v1/rpc/workflow_rpc_pb.js';
 import { DataIngestService, GetRootContentNodesRequestSchema, GetContentNodeAggregatesRequestSchema, ReplicateDataRequestSchema, GetReplicationStatusRequestSchema, FilePickerGroupType, WidgetReplicationMappingSchema, } from './generated/protos/service/dataingest/v1/dataingest_pb.js';
+import { ConversationReviewService, GetConversationReviewsRequestSchema, GetConversationReviewDetailRequestSchema, ConversationReviewFiltersSchema, } from './generated/protos/service/conversation_review/v1/conversation_review_pb.js';
+import { DebugLogService, WorkflowLevelDebugLogRequestSchema, ActionLevelShowWorkLogRequestSchema, } from './generated/protos/service/persona/v1/debug_logs_pb.js';
+import { DebuggerService, SearchMessagesRequestSchema as DebuggerSearchMessagesRequestSchema, } from './generated/protos/service/debugger/service_pb.js';
+import { timestampFromDate } from '@bufbuild/protobuf/wkt';
 import { RegisteredWorkflowNameSchema } from './generated/protos/service/workflows/v1/names_pb.js';
 import { WorkflowDefSchema } from './generated/protos/service/workflows/v1/workflow_pb.js';
 /**
@@ -40,6 +44,9 @@ export class GrpcClient {
     dashboardsService;
     workflowManager;
     dataIngestService;
+    conversationReviewService;
+    debugLogService;
+    debuggerService;
     constructor(env) {
         this.env = env;
         // Create gRPC-Web transport
@@ -55,6 +62,9 @@ export class GrpcClient {
         this.dashboardsService = createClient(DashboardsService, transport);
         this.workflowManager = createClient(WorkflowManager, transport);
         this.dataIngestService = createClient(DataIngestService, transport);
+        this.conversationReviewService = createClient(ConversationReviewService, transport);
+        this.debugLogService = createClient(DebugLogService, transport);
+        this.debuggerService = createClient(DebuggerService, transport);
     }
     /**
      * Update the bearer token (e.g., after refresh)
@@ -263,6 +273,110 @@ export class GrpcClient {
         });
         return this.dataIngestService.getReplicationStatus(request);
     }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // ConversationReviewService RPCs (Audit)
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * List conversation reviews for a persona (audit tab).
+     *
+     * @param personaId - The persona ID
+     * @param opts - Filters and pagination
+     * @returns Paginated conversation review summaries
+     */
+    async getConversationReviews(personaId, opts) {
+        const DEFAULT_CONVERSATION_LIMIT = 20;
+        const request = create(GetConversationReviewsRequestSchema, {
+            personaId,
+            limit: opts?.limit ?? DEFAULT_CONVERSATION_LIMIT,
+            paginationToken: opts?.paginationToken ?? '',
+            ...(opts?.filters ? {
+                filters: create(ConversationReviewFiltersSchema, {
+                    workflowFailure: opts.filters.workflowFailure ?? false,
+                    hasUserFrustration: opts.filters.hasUserFrustration ?? false,
+                    noResultsFound: opts.filters.noResultsFound ?? false,
+                    searchQuery: opts.filters.searchQuery ?? '',
+                    status: opts.filters.status ?? 0,
+                    channel: opts.filters.channel ?? 0,
+                    ...(opts.filters.createdFrom ? { createdFrom: timestampFromDate(opts.filters.createdFrom) } : {}),
+                    ...(opts.filters.createdTo ? { createdTo: timestampFromDate(opts.filters.createdTo) } : {}),
+                }),
+            } : {}),
+        });
+        return this.conversationReviewService.getConversationReviews(request);
+    }
+    /**
+     * Get detailed conversation review with messages and workflow run IDs.
+     *
+     * @param conversationId - The conversation ID
+     * @returns Full message history with workflow_run_ids and work log summaries
+     */
+    async getConversationReviewDetail(conversationId) {
+        const request = create(GetConversationReviewDetailRequestSchema, {
+            conversationId,
+        });
+        return this.conversationReviewService.getConversationReviewDetail(request);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // DebugLogService RPCs (Show Work)
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Get workflow-level debug log with show work for all actions.
+     *
+     * DebugLogService has PERSONA_REQUIRED auth annotation — persona is passed
+     * via X-Persona-Id gRPC header, not in the request body.
+     *
+     * @param workflowRunId - The workflow run ID (from MessageDetail.workflow_run_id)
+     * @param personaId - The persona ID (required for auth context)
+     * @returns Full execution trace including persona config, workflow def snapshot, and per-action show work logs
+     */
+    async getWorkflowLevelDebugLog(workflowRunId, personaId) {
+        const request = create(WorkflowLevelDebugLogRequestSchema, {
+            workflowRunId,
+        });
+        return this.debugLogService.getWorkflowLevelDebugLog(request, {
+            headers: new Headers({ 'x-persona-id': personaId }),
+        });
+    }
+    /**
+     * Get action-level show work log for a specific action in a workflow run.
+     *
+     * DebugLogService has PERSONA_REQUIRED auth annotation — persona is passed
+     * via X-Persona-Id gRPC header, not in the request body.
+     *
+     * @param actionName - The action instance name
+     * @param workflowRunId - The workflow run ID
+     * @param personaId - The persona ID (required for auth context)
+     * @returns Detailed show work log with inputs, outputs, LLM calls, steps, HITL rounds
+     */
+    async getActionLevelShowWorkLog(actionName, workflowRunId, personaId) {
+        const request = create(ActionLevelShowWorkLogRequestSchema, {
+            actionName,
+            workflowRunId,
+        });
+        return this.debugLogService.getActionLevelShowWorkLog(request, {
+            headers: new Headers({ 'x-persona-id': personaId }),
+        });
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // DebuggerService RPCs (Search)
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Search messages across conversations.
+     * Maps `query` → proto field `queryStr`.
+     *
+     * @param opts - Search parameters
+     * @returns Matching message pairs (user + bot) with run IDs
+     */
+    async searchMessages(opts) {
+        const request = create(DebuggerSearchMessagesRequestSchema, {
+            queryStr: opts.query,
+            personaId: opts.personaId ?? '',
+            conversationId: opts.conversationId ?? '',
+            ...(opts.startTime ? { startTime: timestampFromDate(opts.startTime) } : {}),
+            ...(opts.endTime ? { endTime: timestampFromDate(opts.endTime) } : {}),
+        });
+        return this.debuggerService.searchMessages(request);
+    }
 }
 // Re-export the service definitions for advanced use cases
-export { ActionManager, DashboardsService, WorkflowManager, DataIngestService };
+export { ActionManager, DashboardsService, WorkflowManager, DataIngestService, ConversationReviewService, DebugLogService, DebuggerService };

package/dist/sync/sdk.js

@@ -6,7 +6,7 @@
  * not an API client concern.
  */
 import { getMasterEnv, resolveBearerToken } from "../sdk/config.js";
-import { EmaClient } from "../sdk/client.js";
+import { EmaClientAdapter } from "../sdk/client-adapter.js";
 import { StateStore } from "../sdk/state.js";
 import { fingerprintPersona, syncOnce } from "../sync.js";
 /**
@@ -34,7 +34,7 @@ export class SyncSDK {
                 baseUrl: envCfg.baseUrl,
                 bearerToken: resolveBearerToken(envCfg.bearerTokenEnv),
             };
-            this.clients.set(envName, new EmaClient(env));
+            this.clients.set(envName, new EmaClientAdapter(env));
         }
         return this.clients.get(envName);
     }

package/dist/sync.js

@@ -6,7 +6,8 @@
  */
 import crypto from "node:crypto";
 import { getMasterEnv, resolveBearerToken } from "./sdk/config.js";
-import { EmaApiError, EmaClient } from "./sdk/client.js";
+import { EmaClientAdapter } from "./sdk/client-adapter.js";
+import { EmaApiError } from "./sdk/client.js";
 import { SYNC_METADATA_KEY } from "./sdk/models.js";
 // ─────────────────────────────────────────────────────────────────────────────
 // Constants
@@ -201,7 +202,7 @@ export async function syncOnce(cfg, state) {
         started_at: nowIso(),
         status: "running",
     });
-    const masterClient = new EmaClient(buildEnv(masterEnvCfg));
+    const masterClient = new EmaClientAdapter(buildEnv(masterEnvCfg));
     try {
         const personas = await masterClient.getPersonasForTenant();
         let scanned = 0;
@@ -265,7 +266,7 @@ export async function syncOnce(cfg, state) {
             // Sync to each target
             for (const targetEnvName of targetsNeedingSync) {
                 const targetCfg = envByName(cfg, targetEnvName);
-                const targetClient = new EmaClient(buildEnv(targetCfg));
+                const targetClient = new EmaClientAdapter(buildEnv(targetCfg));
                 try {
                     await upsertReplicaPersona({
                         cfg,

package/docs/README.md

@@ -1,14 +1,22 @@
-# Deprecated
+# Documentation
 
-> **This directory is deprecated.** Public documentation has moved to `.context/public/guides/`.
+> Public documentation lives in `.context/public/guides/` (static files) and MCP dynamic resources (generated from code).
 
-## Moved files
+## Static guides (shipped with npm package)
 
-- `ema-user-guide.md` → `.context/public/guides/ema-user-guide.md`
-- `mcp-tools-guide.md` → `.context/public/guides/mcp-tools-guide.md`
-- `dashboard-operations.md` → `.context/public/guides/dashboard-operations.md`
-- `email-patterns.md` → `.context/public/guides/email-patterns.md`
+- `.context/public/guides/mcp-tools-guide.md` → `ema://docs/getting-started`
+- `.context/public/guides/ema-user-guide.md` → `ema://docs/ema-user-guide`
 
-## Future
+## Dynamic resources (generated, always current)
 
-This directory may be re-added as a symlink to internal docs once cutover is verified.
+- `ema://docs/workflow-node-reference` — Per-node I/O types, categorizer patterns, LLM config
+- `ema://rules/email-input-wiring` — Email field wiring patterns
+- `ema://rules/extraction-column-format` — Entity extraction column schema
+- `ema://rules/chat-response-wiring` — Chat response wiring rules
+- `ema://docs/usage-guide` — Complete MCP usage guide
+
+## Removed (content consolidated into dynamic resources)
+
+- `dashboard-operations.md` → `ema://docs/workflow-node-reference`, `ema://rules/extraction-column-format`
+- `email-patterns.md` → `ema://rules/email-input-wiring`
+- `workflow-builder-patterns.md` → `ema://docs/workflow-node-reference`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ema.co/mcp-toolkit",
-  "version": "2026.2.13",
+  "version": "2026.2.23-1",
   "description": "Ema AI Employee toolkit - MCP server, CLI, and SDK for managing AI Employees across environments",
   "type": "module",
   "main": "dist/index.js",
@@ -56,7 +56,7 @@
     "check:publish": "tsx scripts/check-publish-content.ts",
     "prepublishOnly": "npm run build && npm run test && npm run check:publish",
     "generate:types": "tsx scripts/generate-types.ts",
-    "generate:api-client": "npx @hey-api/openapi-ts -i src/sdk/generated/openapi.json -o src/sdk/generated/api-client -c @hey-api/client-fetch",
+    "generate:api-client": "npx @hey-api/openapi-ts -i src/sdk/generated/openapi.json -o src/sdk/generated/api-client -c @hey-api/client-fetch && tsx scripts/fix-generated-esm-imports.ts",
     "generate:protos": "buf generate ../ema-repos/protos --template buf.gen.yaml",
     "generate:proto-fields": "tsx scripts/generate-proto-fields.ts",
     "generate:deprecated-actions": "tsx scripts/generate-deprecated-actions.ts",
@@ -64,7 +64,8 @@
     "generate:skill:check": "tsx scripts/generate-skill.ts --check",
     "generate:templates": "tsx scripts/generate-templates.ts",
     "generate:templates:check": "tsx scripts/generate-templates.ts --check",
-    "generate:all": "npm run generate:protos && npm run generate:api-client && npm run generate:templates && npm run generate:skill",
+    "generate:type-compatibility": "tsx scripts/generate-type-compatibility.ts",
+    "generate:all": "npm run generate:protos && npm run generate:api-client && npm run generate:templates && npm run generate:skill && npm run generate:type-compatibility",
     "check:contracts": "tsx scripts/check-api-contracts.ts",
     "check:schema-sync": "tsx scripts/check-schema-handler-sync.ts",
     "check:prompt-refs": "tsx scripts/check-prompt-refs.ts",