0nmcp 2.6.0 → 2.7.0

package/cli.js

@@ -76,6 +76,14 @@ async function main() {
     return;
   }
 
+  // ── Install (full onboarding — no login required) ─────────
+
+  if (command === 'install') {
+    const { install } = await import('./install.js');
+    await install();
+    return;
+  }
+
   // ── Auth commands (no login required) ──────────────────────
 
   if (command === 'login') {
@@ -194,7 +202,7 @@ ${c.bright}Links:${c.reset}
 
   // ── Auth Gate ──────────────────────────────────────────────
   // All commands below this point require authentication.
-  const AUTH_FREE = ['help', '--help', '-h', 'login', 'logout', 'whoami', 'version', '--version', '-v'];
+  const AUTH_FREE = ['help', '--help', '-h', 'login', 'logout', 'whoami', 'version', '--version', '-v', 'install'];
   if (!AUTH_FREE.includes(command)) {
     try {
       const { isAuthenticated } = await import('./auth.js');

package/crm/objects.js

@@ -155,36 +155,8 @@ export default [
 
   // ── Associations ────────────────────────────────────────────
 
-  {
-    name: "crm_list_associations",
-    description: "List all association definitions for a custom object schema in a CRM location.",
-    method: "GET",
-    path: "/associations/",
-    params: {
-      locationId: { type: "string", description: "Location / sub-account ID", required: true, in: "query" },
-      schemaKey: { type: "string", description: "Custom object schema key to list associations for", required: true, in: "query" },
-    },
-    query: ["locationId", "schemaKey"],
-    body: [],
-  },
-
-  {
-    name: "crm_create_association",
-    description: "Create a new association definition between two custom object schemas.",
-    method: "POST",
-    path: "/associations/",
-    params: {
-      locationId: { type: "string", description: "Location / sub-account ID", required: true, in: "body" },
-      name: { type: "string", description: "Display name for the association", required: true, in: "body" },
-      key: { type: "string", description: "Unique key for the association (lowercase, no spaces)", required: true, in: "body" },
-      fromSchemaKey: { type: "string", description: "Schema key of the source object", required: true, in: "body" },
-      toSchemaKey: { type: "string", description: "Schema key of the target object", required: true, in: "body" },
-      fromDisplayField: { type: "string", description: "Field key shown when viewing from the source side", required: false, in: "body" },
-      toDisplayField: { type: "string", description: "Field key shown when viewing from the target side", required: false, in: "body" },
-    },
-    query: [],
-    body: ["locationId", "name", "key", "fromSchemaKey", "toSchemaKey", "fromDisplayField", "toDisplayField"],
-  },
+  // crm_list_associations — defined in funnels.js
+  // crm_create_association — defined in funnels.js
 
   // ── Email Builder ───────────────────────────────────────────
 
@@ -310,45 +282,9 @@ export default [
 
   // ── Snapshots ───────────────────────────────────────────────
 
-  {
-    name: "crm_list_snapshots",
-    description: "List all snapshots available for a CRM company.",
-    method: "GET",
-    path: "/snapshots/",
-    params: {
-      companyId: { type: "string", description: "Company / agency ID", required: true, in: "query" },
-    },
-    query: ["companyId"],
-    body: [],
-  },
-
-  {
-    name: "crm_create_snapshot_share_link",
-    description: "Create a shareable link for a snapshot so it can be pushed to other locations.",
-    method: "POST",
-    path: "/snapshots/share/link",
-    params: {
-      companyId: { type: "string", description: "Company / agency ID", required: true, in: "body" },
-      snapshotId: { type: "string", description: "Snapshot ID to share", required: true, in: "body" },
-      shareType: { type: "string", description: "Type of share (e.g. link, permanent)", required: true, in: "body" },
-      relationshipNumber: { type: "string", description: "Relationship number for the share link", required: false, in: "body" },
-    },
-    query: [],
-    body: ["companyId", "snapshotId", "shareType", "relationshipNumber"],
-  },
-
-  {
-    name: "crm_get_snapshot_push_status",
-    description: "Get the push status between a snapshot and a specific location.",
-    method: "GET",
-    path: "/snapshots/snapshot-status/:snapshotId/:locationId",
-    params: {
-      snapshotId: { type: "string", description: "Snapshot ID to check", required: true, in: "path" },
-      locationId: { type: "string", description: "Location / sub-account ID to check status against", required: true, in: "path" },
-    },
-    query: [],
-    body: [],
-  },
+  // crm_list_snapshots — defined in funnels.js
+  // crm_create_snapshot_share_link — defined in funnels.js
+  // crm_get_snapshot_push_status — defined in funnels.js
 
   // ── Trigger Links ───────────────────────────────────────────
 

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/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) }] };
+      }
+    }
+  );
 }
 
 /**