0nmcp 2.5.0 → 2.7.0

package/crm/users.js

@@ -105,20 +105,7 @@ const users = [
 
   // ── FORMS ─────────────────────────────────────────────────
 
-  {
-    name: "crm_list_forms",
-    description: "List all forms for a CRM location with optional pagination and type filter.",
-    method: "GET",
-    path: "/forms/",
-    params: {
-      locationId: { type: "string", description: "Location / sub-account ID", required: true, in: "query" },
-      skip: { type: "number", description: "Number of records to skip for pagination", required: false, in: "query" },
-      limit: { type: "number", description: "Maximum number of forms to return", required: false, in: "query" },
-      type: { type: "string", description: "Filter by form type", required: false, in: "query" },
-    },
-    query: ["locationId", "skip", "limit", "type"],
-    body: [],
-  },
+  // crm_list_forms — defined in funnels.js
 
   {
     name: "crm_get_form_submissions",
@@ -154,20 +141,7 @@ const users = [
 
   // ── SURVEYS ───────────────────────────────────────────────
 
-  {
-    name: "crm_list_surveys",
-    description: "List all surveys for a CRM location with optional pagination and type filter.",
-    method: "GET",
-    path: "/surveys/",
-    params: {
-      locationId: { type: "string", description: "Location / sub-account ID", required: true, in: "query" },
-      skip: { type: "number", description: "Number of records to skip for pagination", required: false, in: "query" },
-      limit: { type: "number", description: "Maximum number of surveys to return", required: false, in: "query" },
-      type: { type: "string", description: "Filter by survey type", required: false, in: "query" },
-    },
-    query: ["locationId", "skip", "limit", "type"],
-    body: [],
-  },
+  // crm_list_surveys — defined in funnels.js
 
   {
     name: "crm_get_survey_submissions",
@@ -187,60 +161,11 @@ const users = [
     body: [],
   },
 
-  // ── FUNNELS / WEBSITES ────────────────────────────────────
-
-  {
-    name: "crm_list_funnels",
-    description: "List funnels and websites for a CRM location with optional filters for type, name, category, and parent.",
-    method: "GET",
-    path: "/funnels/funnel/list",
-    params: {
-      locationId: { type: "string", description: "Location / sub-account ID", required: true, in: "query" },
-      limit: { type: "number", description: "Maximum number of funnels to return", required: false, in: "query" },
-      offset: { type: "number", description: "Number of records to skip for pagination", required: false, in: "query" },
-      type: { type: "string", description: "Filter by funnel type", required: false, in: "query" },
-      name: { type: "string", description: "Filter by exact funnel name", required: false, in: "query" },
-      search: { type: "string", description: "Free-text search across funnel names", required: false, in: "query" },
-      category: { type: "string", description: "Filter by funnel category", required: false, in: "query" },
-      parentId: { type: "string", description: "Filter by parent funnel ID", required: false, in: "query" },
-    },
-    query: ["locationId", "limit", "offset", "type", "name", "search", "category", "parentId"],
-    body: [],
-  },
-
-  {
-    name: "crm_get_funnel_pages",
-    description: "List pages within a funnel with optional filters for name and search.",
-    method: "GET",
-    path: "/funnels/page",
-    params: {
-      locationId: { type: "string", description: "Location / sub-account ID", required: true, in: "query" },
-      funnelId: { type: "string", description: "Funnel ID to list pages for", required: true, in: "query" },
-      limit: { type: "number", description: "Maximum number of pages to return", required: false, in: "query" },
-      offset: { type: "number", description: "Number of records to skip for pagination", required: false, in: "query" },
-      name: { type: "string", description: "Filter by exact page name", required: false, in: "query" },
-      search: { type: "string", description: "Free-text search across page names", required: false, in: "query" },
-    },
-    query: ["locationId", "funnelId", "limit", "offset", "name", "search"],
-    body: [],
-  },
-
-  {
-    name: "crm_count_funnel_pages",
-    description: "Get the total count of pages within a funnel, optionally filtered by name.",
-    method: "GET",
-    path: "/funnels/page/count",
-    params: {
-      locationId: { type: "string", description: "Location / sub-account ID", required: true, in: "query" },
-      funnelId: { type: "string", description: "Funnel ID to count pages for", required: true, in: "query" },
-      name: { type: "string", description: "Filter count by page name", required: false, in: "query" },
-    },
-    query: ["locationId", "funnelId", "name"],
-    body: [],
-  },
+  // ── FUNNELS / WEBSITES (defined in funnels.js) ────────────
+  // crm_list_funnels, crm_get_funnel_pages, crm_count_funnel_pages → see funnels.js
 
   {
-    name: "crm_funnel_redirect_lookup",
+    name: "crm_funnel_redirect_lookup_by_id",
     description: "Look up a funnel redirect by its redirect ID.",
     method: "GET",
     path: "/funnels/lookup/redirect",

package/crm/voice-ai.js

@@ -0,0 +1,150 @@
+// ============================================================
+// 0nMCP — CRM Voice AI API Tool Definitions
+// ============================================================
+// AI-powered phone agents. Create agents, define actions,
+// manage call logs. Each agent can use Knowledge Bases.
+// ============================================================
+
+export default [
+  // ── Agents ─────────────────────────────────────────────────
+
+  {
+    name: "crm_list_voice_agents",
+    description: "List all Voice AI agents for a location.",
+    method: "GET",
+    path: "/voice-ai/agents",
+    params: {
+      locationId: { type: "string", description: "Location ID", required: true, in: "query" },
+    },
+  },
+
+  {
+    name: "crm_create_voice_agent",
+    description: "Create a new Voice AI agent. Can be configured with knowledge bases, actions, and personality settings.",
+    method: "POST",
+    path: "/voice-ai/agents",
+    params: {
+      locationId: { type: "string", description: "Location ID", required: true, in: "body" },
+      name: { type: "string", description: "Agent name", required: true, in: "body" },
+      personality: { type: "string", description: "Agent personality/system prompt", required: false, in: "body" },
+      knowledgeBases: { type: "array", description: "Array of knowledge base IDs to attach", required: false, in: "body" },
+      actions: { type: "array", description: "Array of action IDs the agent can perform", required: false, in: "body" },
+      greeting: { type: "string", description: "Initial greeting message", required: false, in: "body" },
+      voiceId: { type: "string", description: "Voice ID for text-to-speech", required: false, in: "body" },
+    },
+    body: ["locationId", "name", "personality", "knowledgeBases", "actions", "greeting", "voiceId"],
+  },
+
+  {
+    name: "crm_get_voice_agent",
+    description: "Get a Voice AI agent by ID with full configuration.",
+    method: "GET",
+    path: "/voice-ai/agents/:agentId",
+    params: {
+      agentId: { type: "string", description: "Agent ID", required: true, in: "path" },
+    },
+  },
+
+  {
+    name: "crm_update_voice_agent",
+    description: "Update a Voice AI agent's configuration.",
+    method: "PATCH",
+    path: "/voice-ai/agents/:agentId",
+    params: {
+      agentId: { type: "string", description: "Agent ID", required: true, in: "path" },
+      name: { type: "string", description: "Agent name", required: false, in: "body" },
+      personality: { type: "string", description: "Agent personality/system prompt", required: false, in: "body" },
+      knowledgeBases: { type: "array", description: "Array of knowledge base IDs", required: false, in: "body" },
+      actions: { type: "array", description: "Array of action IDs", required: false, in: "body" },
+      greeting: { type: "string", description: "Initial greeting", required: false, in: "body" },
+      voiceId: { type: "string", description: "Voice ID", required: false, in: "body" },
+      active: { type: "boolean", description: "Whether agent is active", required: false, in: "body" },
+    },
+    body: ["name", "personality", "knowledgeBases", "actions", "greeting", "voiceId", "active"],
+  },
+
+  {
+    name: "crm_delete_voice_agent",
+    description: "Delete a Voice AI agent.",
+    method: "DELETE",
+    path: "/voice-ai/agents/:agentId",
+    params: {
+      agentId: { type: "string", description: "Agent ID", required: true, in: "path" },
+    },
+  },
+
+  // ── Actions ────────────────────────────────────────────────
+
+  {
+    name: "crm_create_voice_action",
+    description: "Create an action that a Voice AI agent can perform (e.g., book appointment, transfer call, query knowledge base).",
+    method: "POST",
+    path: "/voice-ai/actions",
+    params: {
+      locationId: { type: "string", description: "Location ID", required: true, in: "body" },
+      name: { type: "string", description: "Action name", required: true, in: "body" },
+      type: { type: "string", description: "Action type (e.g., 'knowledge_base', 'book_appointment', 'transfer_call', 'webhook')", required: true, in: "body" },
+      config: { type: "object", description: "Action-specific configuration (e.g., knowledgeBaseId, calendarId, phoneNumber, webhookUrl)", required: false, in: "body" },
+    },
+    body: ["locationId", "name", "type", "config"],
+  },
+
+  {
+    name: "crm_get_voice_action",
+    description: "Get a Voice AI action by ID.",
+    method: "GET",
+    path: "/voice-ai/actions/:actionId",
+    params: {
+      actionId: { type: "string", description: "Action ID", required: true, in: "path" },
+    },
+  },
+
+  {
+    name: "crm_update_voice_action",
+    description: "Update a Voice AI action.",
+    method: "PUT",
+    path: "/voice-ai/actions/:actionId",
+    params: {
+      actionId: { type: "string", description: "Action ID", required: true, in: "path" },
+      name: { type: "string", description: "Action name", required: false, in: "body" },
+      type: { type: "string", description: "Action type", required: false, in: "body" },
+      config: { type: "object", description: "Action configuration", required: false, in: "body" },
+    },
+    body: ["name", "type", "config"],
+  },
+
+  {
+    name: "crm_delete_voice_action",
+    description: "Delete a Voice AI action.",
+    method: "DELETE",
+    path: "/voice-ai/actions/:actionId",
+    params: {
+      actionId: { type: "string", description: "Action ID", required: true, in: "path" },
+    },
+  },
+
+  // ── Call Logs ──────────────────────────────────────────────
+
+  {
+    name: "crm_list_voice_call_logs",
+    description: "List Voice AI call logs with filters.",
+    method: "GET",
+    path: "/voice-ai/dashboard/call-logs",
+    params: {
+      locationId: { type: "string", description: "Location ID", required: true, in: "query" },
+      agentId: { type: "string", description: "Filter by agent ID", required: false, in: "query" },
+      limit: { type: "number", description: "Results per page", required: false, in: "query" },
+      offset: { type: "number", description: "Pagination offset", required: false, in: "query" },
+    },
+  },
+
+  {
+    name: "crm_get_voice_call_log",
+    description: "Get a specific Voice AI call log with transcript and details.",
+    method: "GET",
+    path: "/voice-ai/dashboard/call-logs/:callId",
+    params: {
+      callId: { type: "string", description: "Call ID", required: true, in: "path" },
+    },
+  },
+]

package/engine/index.js

@@ -3,9 +3,9 @@
 // ============================================================
 // The .0n Conversion Engine — import credentials, verify keys,
 // generate platform configs, create portable AI Brain bundles,
-// and build/run application bundles.
+// build/run application bundles, and the 0nEngine Plugin System.
 //
-// 11 MCP Tools:
+// 16 MCP Tools:
 //   engine_import    — Import credentials from .env/CSV/JSON
 //   engine_verify    — Verify API keys with test calls
 //   engine_platforms — Generate platform configs
@@ -17,6 +17,11 @@
 //   app_inspect      — Show application metadata (no passphrase)
 //   app_validate     — Validate application cross-references
 //   app_list         — List installed applications
+//   plugin_list      — List all plugins (catalog + custom)
+//   plugin_build     — Build a plugin from service key or spec
+//   plugin_execute   — Execute a plugin endpoint with .0n fields
+//   plugin_inspect   — Inspect a plugin's capabilities & endpoints
+//   plugin_create    — Generate a new custom plugin spec
 //
 // Patent Pending: US Provisional Patent Application #63/968,814
 // ============================================================
@@ -34,6 +39,18 @@ export { Application } from "./application.js";
 export { createApplication, openApplication, inspectApplication, validateApplication } from "./app-builder.js";
 export { ApplicationServer } from "./app-server.js";
 
+// ── 0nEngine Plugin System ──────────────────────────────────
+export { Plugin } from "./plugin.js";
+export { PluginBuilder, getPluginBuilder, buildPlugin, buildAllPlugins, buildFromSpec, generatePluginSpec } from "./plugin-builder.js";
+export { PluginRegistry, getPluginRegistry } from "./plugin-registry.js";
+
+// ── 0nAI Training Center ────────────────────────────────────
+export { registerTrainingTools } from "./training.js";
+export { TrainingFeedEngine, registerFeedTools, FEED_SOURCES } from "./training-feed.js";
+
+// ── Multi-AI Council ────────────────────────────────────────
+export { registerCouncilTools, getAvailableProviders, askAll, PROVIDERS } from "./multi-ai.js";
+
 // ── Imports for tool handlers ──────────────────────────────
 import { parseFile } from "./parser.js";
 import { mapEnvVars, groupByService, validateMapping } from "./mapper.js";
@@ -41,6 +58,8 @@ import { verifyCredentials, verifyAll } from "./validator.js";
 import { generatePlatformConfig, generateAllPlatformConfigs, getPlatformInfo, listPlatforms } from "./platforms.js";
 import { createBundle, openBundle, inspectBundle, verifyBundle } from "./bundler.js";
 import { createApplication, openApplication, inspectApplication, validateApplication } from "./app-builder.js";
+import { PluginBuilder, getPluginBuilder } from "./plugin-builder.js";
+import { PluginRegistry, getPluginRegistry } from "./plugin-registry.js";
 import { existsSync, readFileSync, readdirSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
@@ -642,6 +661,323 @@ Example: app_list({})`,
       }
     }
   );
+
+  // ═══════════════════════════════════════════════════════════
+  // 0nEngine Plugin Tools
+  // ═══════════════════════════════════════════════════════════
+
+  // ─── plugin_list ───────────────────────────────────────────
+  server.tool(
+    "plugin_list",
+    `List all available plugins — catalog services + custom plugins from ~/.0n/plugins/.
+Shows connection status, endpoint counts, capability counts, and field coverage.
+
+Example: plugin_list({})
+Example: plugin_list({ type: "email" })
+Example: plugin_list({ connected: true })`,
+    {
+      type: z.string().optional().describe("Filter by service type (email, payments, crm, etc.)"),
+      connected: z.boolean().optional().describe("Filter by connection status"),
+      search: z.string().optional().describe("Search by keyword in name/description"),
+    },
+    async ({ type, connected, search }) => {
+      try {
+        const registry = getPluginRegistry();
+
+        let plugins = registry.all();
+
+        if (type) plugins = plugins.filter(p => p.type === type);
+        if (connected !== undefined) plugins = plugins.filter(p => p.isConnected === connected);
+        if (search) {
+          const q = search.toLowerCase();
+          plugins = plugins.filter(p =>
+            p.name.toLowerCase().includes(q) ||
+            p.description.toLowerCase().includes(q) ||
+            p.key.toLowerCase().includes(q)
+          );
+        }
+
+        const list = plugins.map(p => ({
+          key: p.key,
+          name: p.name,
+          type: p.type,
+          connected: p.isConnected,
+          endpoints: Object.keys(p.endpoints).length,
+          capabilities: p.capabilities.length,
+        }));
+
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              status: "ok",
+              total: list.length,
+              plugins: list,
+              types: [...new Set(plugins.map(p => p.type))],
+            }, null, 2),
+          }],
+        };
+      } catch (err) {
+        return { content: [{ type: "text", text: JSON.stringify({ status: "failed", error: err.message }, null, 2) }] };
+      }
+    }
+  );
+
+  // ─── plugin_inspect ────────────────────────────────────────
+  server.tool(
+    "plugin_inspect",
+    `Inspect a plugin's full details — capabilities, endpoints, field mappings, and stats.
+
+Example: plugin_inspect({ service: "stripe" })`,
+    {
+      service: z.string().describe("Service key to inspect (e.g., stripe, crm, sendgrid)"),
+    },
+    async ({ service }) => {
+      try {
+        const builder = getPluginBuilder();
+        const plugin = builder.build(service);
+
+        const info = plugin.inspect();
+        const fields = builder.getServiceFields(service);
+
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              status: "ok",
+              ...info,
+              fieldMappings: fields,
+              fieldCount: Object.keys(fields).length,
+            }, null, 2),
+          }],
+        };
+      } catch (err) {
+        return { content: [{ type: "text", text: JSON.stringify({ status: "failed", error: err.message }, null, 2) }] };
+      }
+    }
+  );
+
+  // ─── plugin_execute ────────────────────────────────────────
+  server.tool(
+    "plugin_execute",
+    `Execute a plugin endpoint with automatic .0n field resolution.
+Accepts canonical .0n fields (email.0n, fullname.0n, etc.) and auto-translates
+to the service's native format. Handles auth, rate limiting, and response normalization.
+
+Example: plugin_execute({
+  service: "stripe",
+  endpoint: "create_customer",
+  params: { "email.0n": "mike@rocketopp.com", "fullname.0n": "Mike Mento" }
+})`,
+    {
+      service: z.string().describe("Service key (e.g., stripe, crm, sendgrid)"),
+      endpoint: z.string().describe("Endpoint name from the service catalog (e.g., create_customer, send_email)"),
+      params: z.record(z.any()).optional().describe("Parameters — supports .0n canonical fields (email.0n) and raw service fields"),
+      credentials: z.record(z.string()).optional().describe("One-time credentials override (otherwise uses ~/.0n/connections/)"),
+    },
+    async ({ service, endpoint, params, credentials }) => {
+      try {
+        const builder = getPluginBuilder();
+        const plugin = builder.build(service);
+
+        // Connect with provided or disk credentials
+        if (credentials) {
+          plugin.connect(credentials);
+        } else {
+          // Try to load from disk
+          const connFile = join(CONNECTIONS_DIR, `${service}.0n`);
+          const connFileJson = join(CONNECTIONS_DIR, `${service}.0n.json`);
+          const connPath = existsSync(connFile) ? connFile : existsSync(connFileJson) ? connFileJson : null;
+
+          if (connPath) {
+            const data = JSON.parse(readFileSync(connPath, "utf-8"));
+            if (data.auth?.credentials) {
+              plugin.connect(data.auth.credentials);
+            }
+          }
+        }
+
+        if (!plugin.isConnected) {
+          return {
+            content: [{
+              type: "text",
+              text: JSON.stringify({
+                status: "not_connected",
+                service,
+                message: `Plugin "${service}" has no credentials. Provide credentials or connect via connect_service.`,
+                requiredKeys: plugin.credentialKeys,
+              }, null, 2),
+            }],
+          };
+        }
+
+        const result = await plugin.execute(endpoint, params || {});
+
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify(result, null, 2),
+          }],
+        };
+      } catch (err) {
+        return { content: [{ type: "text", text: JSON.stringify({ status: "failed", error: err.message }, null, 2) }] };
+      }
+    }
+  );
+
+  // ─── plugin_build ──────────────────────────────────────────
+  server.tool(
+    "plugin_build",
+    `Build a plugin from a service key or custom spec.
+If building from catalog, returns the plugin's full tool manifest.
+If building from spec, creates a custom plugin and saves to ~/.0n/plugins/.
+
+Example (catalog): plugin_build({ service: "stripe" })
+Example (custom): plugin_build({
+  spec: {
+    service: "acme",
+    name: "Acme CRM",
+    baseUrl: "https://api.acme.com/v1",
+    authType: "api_key",
+    credentialKeys: ["apiKey"],
+    endpoints: {
+      list_contacts: { method: "GET", path: "/contacts" },
+      create_contact: { method: "POST", path: "/contacts", body: { email: "", name: "" } }
+    }
+  }
+})`,
+    {
+      service: z.string().optional().describe("Catalog service key (e.g., stripe) — builds from catalog"),
+      spec: z.record(z.any()).optional().describe("Custom plugin spec — builds from definition"),
+      save: z.boolean().optional().describe("Save custom plugin to ~/.0n/plugins/ (default: true)"),
+    },
+    async ({ service, spec, save }) => {
+      try {
+        const builder = getPluginBuilder();
+
+        if (spec) {
+          // Build from custom spec
+          const generated = builder.generate(spec);
+          const plugin = builder.buildFromSpec(generated);
+
+          if (save !== false) {
+            builder.generateAndSave(spec);
+          }
+
+          return {
+            content: [{
+              type: "text",
+              text: JSON.stringify({
+                status: "built",
+                source: "custom_spec",
+                plugin: plugin.inspect(),
+                tools: plugin.toMcpTools().map(t => t.name),
+                spec: generated,
+                saved: save !== false,
+                message: `Custom plugin "${spec.service || spec.key}" built with ${Object.keys(spec.endpoints || {}).length} endpoints.`,
+              }, null, 2),
+            }],
+          };
+        }
+
+        if (service) {
+          // Build from catalog
+          const plugin = builder.build(service);
+          const tools = plugin.toMcpTools();
+
+          return {
+            content: [{
+              type: "text",
+              text: JSON.stringify({
+                status: "built",
+                source: "catalog",
+                plugin: plugin.inspect(),
+                tools: tools.map(t => t.name),
+                toolCount: tools.length,
+                message: `Plugin "${service}" built from catalog with ${tools.length} tools.`,
+              }, null, 2),
+            }],
+          };
+        }
+
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              status: "failed",
+              error: "Provide either 'service' (catalog key) or 'spec' (custom definition).",
+            }, null, 2),
+          }],
+        };
+      } catch (err) {
+        return { content: [{ type: "text", text: JSON.stringify({ status: "failed", error: err.message }, null, 2) }] };
+      }
+    }
+  );
+
+  // ─── plugin_create ─────────────────────────────────────────
+  server.tool(
+    "plugin_create",
+    `Generate a new custom plugin spec for a service not in the catalog.
+Auto-infers capabilities from endpoints and maps .0n canonical fields.
+Saves to ~/.0n/plugins/ for automatic loading.
+
+Example: plugin_create({
+  key: "acme",
+  name: "Acme API",
+  baseUrl: "https://api.acme.com/v1",
+  authType: "api_key",
+  credentialKeys: ["apiKey"],
+  endpoints: {
+    list_users: { method: "GET", path: "/users" },
+    create_user: { method: "POST", path: "/users", body: { email: "", name: "" } },
+    get_user: { method: "GET", path: "/users/{userId}" },
+    update_user: { method: "PUT", path: "/users/{userId}", body: {} },
+    delete_user: { method: "DELETE", path: "/users/{userId}" }
+  }
+})`,
+    {
+      key: z.string().describe("Service key (lowercase, no spaces)"),
+      name: z.string().optional().describe("Display name"),
+      baseUrl: z.string().describe("API base URL"),
+      authType: z.enum(["api_key", "oauth", "basic", "none"]).optional().describe("Auth type (default: api_key)"),
+      credentialKeys: z.array(z.string()).optional().describe("Required credential keys (default: ['apiKey'])"),
+      type: z.string().optional().describe("Category type (e.g., crm, email, payments)"),
+      description: z.string().optional().describe("Service description"),
+      endpoints: z.record(z.any()).describe("Endpoint definitions { name: { method, path, body?, query? } }"),
+      fieldMappings: z.record(z.any()).optional().describe("Custom .0n field mappings { 'email.0n': 'user_email' }"),
+    },
+    async ({ key, name, baseUrl, authType, credentialKeys, type, description, endpoints, fieldMappings }) => {
+      try {
+        const builder = getPluginBuilder();
+
+        const def = { key, name, baseUrl, authType, credentialKeys, type, description, endpoints, fieldMappings };
+        const { spec, path } = builder.generateAndSave(def);
+
+        // Also register in the active registry
+        const registry = getPluginRegistry();
+        const plugin = registry.registerFromSpec(spec);
+
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              status: "created",
+              service: key,
+              path,
+              endpoints: Object.keys(endpoints).length,
+              capabilities: spec.capabilities?.length || 0,
+              fieldMappings: spec.fieldMappings ? Object.keys(spec.fieldMappings).length : 0,
+              tools: plugin.toMcpTools().map(t => t.name),
+              message: `Plugin "${key}" created and saved to ${path}. It's now available in the registry.`,
+            }, null, 2),
+          }],
+        };
+      } catch (err) {
+        return { content: [{ type: "text", text: JSON.stringify({ status: "failed", error: err.message }, null, 2) }] };
+      }
+    }
+  );
 }
 
 /**