@ema.co/mcp-toolkit 2026.2.23 → 2026.2.27

package/dist/mcp/resources-dynamic.js

@@ -1523,8 +1523,13 @@ persona(method="update", id="<ID>", config={widgets: [...]})
 
 ### 6. Upload Knowledge
 \`\`\`
+# Default widget ('fileUpload') — exists on every chat/voice persona
 persona(id="<ID>", data={method:"upload", path:"your-data.txt"})
+
+# Custom widget — auto-created in proto_config on first upload (widget_created: true in response)
+persona(id="<ID>", data={method:"upload", path:"policies.pdf", widget_name:"policies"})
 \`\`\`
+Wire any custom widget to a search node: \`search/v2\` → \`datastore_configs\` → \`widgetConfig: { widgetName: "<widget_name>" }\`.
 
 ## Hard Requirements
 

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).",
@@ -278,7 +284,7 @@ persona(
                             // Especially important for Document Generation personas with multiple upload widgets
                             widget_name: {
                                 type: "string",
-                                description: "Target widget for upload OR filter for stats. For Document Proposal Manager: 'upload' (Content Repository), 'upload1' (Service Line Docs), 'upload2' (Style Guide). Default: 'fileUpload'. See catalog(type='widgets') for reference."
+                                description: "Target widget for upload OR filter for stats. Default: 'fileUpload'. If the named widget doesn't exist in the persona's proto_config, it is auto-created (type 3, fileUpload). Use a custom name to create a second knowledge base alongside the default one. For Document Proposal Manager: 'upload' (Content Repository), 'upload1' (Service Line Docs), 'upload2' (Style Guide). See catalog(type='widgets') for reference."
                             },
                             // delete params
                             file_id: { type: "string", description: "File/item ID to delete (for method=delete)" },
@@ -704,9 +710,9 @@ persona(
                         type: "number",
                         description: "Max results to return (for method=conversations)",
                     },
-                    offset: {
-                        type: "number",
-                        description: "Pagination offset (for method=conversations)",
+                    pagination_token: {
+                        type: "string",
+                        description: "Pagination token from previous response (for method=conversations)",
                     },
                     channel: {
                         type: "string",

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/dist/sdk/generated/api-client/client/client.gen.js

@@ -1,7 +1,7 @@
 // This file is auto-generated by @hey-api/openapi-ts
-import { createSseClient } from '../core/serverSentEvents.gen';
-import { getValidRequestBody } from '../core/utils.gen';
-import { buildUrl, createConfig, createInterceptors, getParseAs, mergeConfigs, mergeHeaders, setAuthParams, } from './utils.gen';
+import { createSseClient } from '../core/serverSentEvents.gen.js';
+import { getValidRequestBody } from '../core/utils.gen.js';
+import { buildUrl, createConfig, createInterceptors, getParseAs, mergeConfigs, mergeHeaders, setAuthParams, } from './utils.gen.js';
 export const createClient = (config = {}) => {
     let _config = mergeConfigs(createConfig(), config);
     const getConfig = () => ({ ..._config });

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

@@ -1,6 +1,6 @@
 // This file is auto-generated by @hey-api/openapi-ts
-export { formDataBodySerializer, jsonBodySerializer, urlSearchParamsBodySerializer, } from '../core/bodySerializer.gen';
-export { buildClientParams } from '../core/params.gen';
-export { serializeQueryKeyValue } from '../core/queryKeySerializer.gen';
-export { createClient } from './client.gen';
-export { createConfig, mergeHeaders } from './utils.gen';
+export { formDataBodySerializer, jsonBodySerializer, urlSearchParamsBodySerializer, } from '../core/bodySerializer.gen.js';
+export { buildClientParams } from '../core/params.gen.js';
+export { serializeQueryKeyValue } from '../core/queryKeySerializer.gen.js';
+export { createClient } from './client.gen.js';
+export { createConfig, mergeHeaders } from './utils.gen.js';

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

@@ -1,8 +1,8 @@
 // This file is auto-generated by @hey-api/openapi-ts
-import { getAuthToken } from '../core/auth.gen';
-import { jsonBodySerializer } from '../core/bodySerializer.gen';
-import { serializeArrayParam, serializeObjectParam, serializePrimitiveParam, } from '../core/pathSerializer.gen';
-import { getUrl } from '../core/utils.gen';
+import { getAuthToken } from '../core/auth.gen.js';
+import { jsonBodySerializer } from '../core/bodySerializer.gen.js';
+import { serializeArrayParam, serializeObjectParam, serializePrimitiveParam, } from '../core/pathSerializer.gen.js';
+import { getUrl } from '../core/utils.gen.js';
 export const createQuerySerializer = ({ parameters = {}, ...args } = {}) => {
     const querySerializer = (queryParams) => {
         const search = [];

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ema.co/mcp-toolkit",
-  "version": "2026.2.23",
+  "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",
@@ -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",