@muxoai/platform 1.2.3 → 1.3.1

package/dist/mcp.js

@@ -2,11 +2,18 @@ import crypto from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
 import { ROOT_DIR } from "./config.js";
+const DEFAULT_TOOL_SECURITY_SCHEMES = [
+    { type: "noauth" },
+    {
+        type: "oauth2",
+        scopes: ["muxo:mcp", "muxo:read", "muxo:execute", "muxo:provision"],
+    },
+];
 /**
  * Concise server instructions (<512 chars) per OpenAI Plugin MCP Server specification:
  * https://developers.openai.com/plugins/build/mcp-server
  */
-export const MUXO_MCP_SERVER_INSTRUCTIONS = "Muxo governs SaaS actions (Composio app.*), Instant tools (instant.*), Cloud Infrastructure (Stripe Projects resource.*), Supermemory v5 recall, and Microsoft Agent Governance Ed25519 receipts. Workflow: 1) search_tools & inspect_tool. 2) plan_action to get a plan_*. 3) If authHandoff.required is true, show redirectUrl and call wait_for_connection. 4) Execute via the matching risk tool (execute_read/write/admin/financial/provisioning/destructive). 5) Verify via get_receipt.";
+export const MUXO_MCP_SERVER_INSTRUCTIONS = "Muxo governs SaaS actions (Connected Apps: app.*), Instant tools (instant.*), Cloud Infrastructure (resource.*), Workspace Memory recall, and verifiable audit records. Workflow: 1) search_tools & inspect_tool. 2) plan_action to get a plan_*. 3) If authHandoff.required is true, show redirectUrl and call wait_for_connection. 4) Execute via the matching risk tool (execute_read/write/admin/financial/provisioning/destructive). 5) Verify via get_receipt.";
 export const MUXO_MCP_TOOLS = [
     {
         name: "get_profile",
@@ -18,17 +25,59 @@ export const MUXO_MCP_TOOLS = [
             additionalProperties: false,
         },
         outputSchema: {
+            $schema: "https://json-schema.org/draft/2020-12/schema",
             type: "object",
             properties: {
-                id: { type: "string", description: "Unique user identifier" },
-                name: { type: "string", description: "Display name" },
-                email: { type: "string", description: "Email address" },
-                workspaceId: { type: "string", description: "Active workspace ID" },
-                workspaceName: { type: "string", description: "Active workspace name" },
-                tier: { type: "string", description: "Workspace subscription tier" },
+                id: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "\\S",
+                    description: "Unique identifier for the user.",
+                },
+                name: {
+                    type: "string",
+                    description: "Full name of the user.",
+                },
+                email: {
+                    type: "string",
+                    description: "Email address of the user.",
+                },
+                nickname: {
+                    type: "string",
+                    description: "Handle or username of the user.",
+                },
+                workspaceId: {
+                    type: "string",
+                    description: "Active workspace ID.",
+                },
+                workspaceName: {
+                    type: "string",
+                    description: "Active workspace name.",
+                },
+                tier: {
+                    type: "string",
+                    description: "Workspace subscription tier.",
+                },
+                authType: {
+                    type: "string",
+                    description: "Authentication type (session or api_key).",
+                },
+                actorId: {
+                    type: "string",
+                    description: "Actor identifier.",
+                },
+                user: {
+                    type: "object",
+                    description: "User profile record.",
+                },
             },
             required: ["id"],
+            additionalProperties: false,
         },
+        securitySchemes: [
+            { type: "noauth" },
+            { type: "oauth2", scopes: ["muxo:read"] },
+        ],
         annotations: {
             readOnlyHint: true,
             destructiveHint: false,
@@ -56,7 +105,7 @@ export const MUXO_MCP_TOOLS = [
     {
         name: "search_tools",
         title: "Search Unified Tool Catalog",
-        description: "Search the unified Muxo catalog across Connected Apps (Composio SDK: app.*), Instant Tools (Composio Instant: instant.*), and Cloud Infrastructure (Stripe Projects: resource.*).",
+        description: "Search the unified Muxo catalog across Connected Apps (app.*), Instant Tools (instant.*), and Cloud Infrastructure (resource.*).",
         inputSchema: {
             type: "object",
             properties: {
@@ -114,7 +163,7 @@ export const MUXO_MCP_TOOLS = [
     {
         name: "connection_status",
         title: "Check Connection Status",
-        description: "Check connection status across Composio OAuth apps, Instant wallet, and linked Stripe Projects cloud providers.",
+        description: "Check connection status across Connected Apps, Instant Tools, and linked Cloud Infrastructure providers.",
         inputSchema: {
             type: "object",
             properties: {
@@ -125,7 +174,7 @@ export const MUXO_MCP_TOOLS = [
                 sync_live: {
                     type: "boolean",
                     default: true,
-                    description: "Whether to sync live status from upstream Composio and Stripe Projects",
+                    description: "Whether to sync live connection status from upstream providers",
                 },
             },
             additionalProperties: false,
@@ -139,7 +188,7 @@ export const MUXO_MCP_TOOLS = [
     {
         name: "start_connection",
         title: "Start OAuth Connection Handoff",
-        description: "Initiate a managed OAuth connection handoff for a Connected App (Composio) or link a cloud provider (Stripe Projects).",
+        description: "Initiate a managed OAuth connection handoff for a Connected App or link a Cloud Infrastructure provider.",
         inputSchema: {
             type: "object",
             required: ["provider"],
@@ -195,15 +244,18 @@ export const MUXO_MCP_TOOLS = [
     {
         name: "plan_action",
         title: "Create Governed Action Plan",
-        description: "Create a governed execution plan (plan_*) for any tool or infrastructure provisioning operation. Evaluates workspace policy, risk level, Supermemory v5 recall, Ed25519 signature, and credit balance.",
+        description: "Create a governed execution plan (plan_*) for any tool, billing operation, or infrastructure provisioning operation. Accepts either an exact tool_slug (e.g. 'instant.seo.audit', 'billing.credits.topup', 'resource.turso.database') or a natural-language instruction (e.g. 'audit seo for https://muxo.ai'). Evaluates workspace policy, risk level, Workspace Memory recall, safety guardrails, BYOK vs Muxo-funded mode, and credit balance.",
         inputSchema: {
             type: "object",
             required: ["tool_slug"],
             properties: {
-                tool_slug: { type: "string", description: "Muxo tool slug to plan" },
+                tool_slug: {
+                    type: "string",
+                    description: "Muxo tool slug (e.g. 'instant.seo.audit', 'billing.credits.topup') or natural-language request",
+                },
                 input: {
                     type: "object",
-                    description: "Arguments matching the tool's inputSchema",
+                    description: "Arguments matching the tool's inputSchema (auto-extracted when tool_slug is natural language)",
                 },
                 reason: {
                     type: "string",
@@ -523,6 +575,8 @@ description: Guided onboarding skill for setting up the Muxo plugin in OpenAI Ch
 
 Call \`get_profile\` and \`get_organization\` to verify your workspace connection, or run \`npx -y @muxoai/cli@latest login --signup\` in a terminal.
 `);
+    const muxoOpenaiYaml = readSkillFileOrDefault("muxo/agents/openai.yaml", `interface:\n  display_name: "Muxo"\n  short_description: "Governed SaaS, Instant Web/SEO tools, Cloud Infrastructure, and Workspace Memory"\n  default_prompt: "Audit https://muxo.ai for technical SEO and crawl its top pages."\n\ndependencies:\n  tools:\n    - type: "mcp"\n      value: "muxo"\n      description: "Muxo Governed Execution, Instant Web/SEO Tools, Connected Apps, and Cloud Infrastructure MCP Server"\n      transport: "streamable_http"\n      url: "https://api.muxo.ai/mcp"\n`);
+    const setupOpenaiYaml = readSkillFileOrDefault("setup/agents/openai.yaml", `interface:\n  display_name: "Muxo Setup"\n  short_description: "Guided onboarding and connection verification for Muxo in ChatGPT and Codex"\n  default_prompt: "Check my Muxo profile and organization status."\n\ndependencies:\n  tools:\n    - type: "mcp"\n      value: "muxo"\n      description: "Muxo Governed Execution, Instant Web/SEO Tools, Connected Apps, and Cloud Infrastructure MCP Server"\n      transport: "streamable_http"\n      url: "https://api.muxo.ai/mcp"\n`);
     const muxoFm = parseFrontmatter(muxoSkillMd);
     const setupFm = parseFrontmatter(setupSkillMd);
     const muxoFiles = [
@@ -534,6 +588,14 @@ Call \`get_profile\` and \`get_organization\` to verify your workspace connectio
             mimeType: "text/markdown",
             content: muxoSkillMd,
         },
+        {
+            path: "agents/openai.yaml",
+            uri: "skill://muxo/muxo/agents/openai.yaml",
+            size: Buffer.byteLength(muxoOpenaiYaml, "utf8"),
+            digest: sha256Digest(muxoOpenaiYaml),
+            mimeType: "application/yaml",
+            content: muxoOpenaiYaml,
+        },
         {
             path: "references/cli.md",
             uri: "skill://muxo/muxo/references/cli.md",
@@ -560,6 +622,14 @@ Call \`get_profile\` and \`get_organization\` to verify your workspace connectio
             mimeType: "text/markdown",
             content: setupSkillMd,
         },
+        {
+            path: "agents/openai.yaml",
+            uri: "skill://muxo/setup/agents/openai.yaml",
+            size: Buffer.byteLength(setupOpenaiYaml, "utf8"),
+            digest: sha256Digest(setupOpenaiYaml),
+            mimeType: "application/yaml",
+            content: setupOpenaiYaml,
+        },
     ];
     const muxoName = muxoFm.name || "muxo";
     const muxoDesc = muxoFm.description ||
@@ -627,8 +697,13 @@ export async function dispatchMcpToolCall(engine, ctx, toolName, args = {}) {
             });
         case "plan_action":
             return engine.planAction(ctx, {
-                toolSlug: String(args.tool_slug || args.slug || ""),
-                input: args.input || {},
+                toolSlug: String(args.tool_slug ||
+                    args.slug ||
+                    args.tool_id ||
+                    args.prompt ||
+                    args.instruction ||
+                    ""),
+                input: (args.input || args.arguments) || {},
                 reason: args.reason ? String(args.reason) : undefined,
             });
         case "get_plan":
@@ -738,7 +813,7 @@ export async function handleJsonRpcMcpRequest(engine, ctx, rpc) {
                     instructions: MUXO_MCP_SERVER_INSTRUCTIONS,
                     serverInfo: {
                         name: "muxo-mcp-server",
-                        version: "1.2.3",
+                        version: "1.3.1",
                     },
                     capabilities: {
                         tools: { listChanged: false },
@@ -758,7 +833,10 @@ export async function handleJsonRpcMcpRequest(engine, ctx, rpc) {
                 jsonrpc: "2.0",
                 id,
                 result: {
-                    tools: MUXO_MCP_TOOLS,
+                    tools: MUXO_MCP_TOOLS.map((t) => ({
+                        ...t,
+                        securitySchemes: t.securitySchemes || DEFAULT_TOOL_SECURITY_SCHEMES,
+                    })),
                 },
             };
         }
@@ -787,9 +865,14 @@ export async function handleJsonRpcMcpRequest(engine, ctx, rpc) {
         // SEP-2640 Skills Import Extension (`io.modelcontextprotocol/skills`)
         if (method === "skills/list") {
             const skills = getMuxoMcpSkills().map((s) => ({
+                uri: s.uri,
+                frontmatter: s.frontmatter,
+                resources: s.files.map((f) => ({
+                    uri: f.uri,
+                    digest: f.digest,
+                })),
                 name: s.name,
                 description: s.description,
-                uri: s.uri,
                 version: s.version,
                 digest: s.files[0]?.digest || "",
                 files: s.files.length,
@@ -801,30 +884,39 @@ export async function handleJsonRpcMcpRequest(engine, ctx, rpc) {
             };
         }
         if (method === "skills/get") {
+            const requestedUri = String(params.uri || "").trim();
             const requestedName = String(params.name || "muxo").trim();
-            const skill = getMuxoMcpSkills().find((s) => s.name === requestedName);
+            const skill = getMuxoMcpSkills().find((s) => s.uri === requestedUri || s.name === requestedName);
             if (!skill) {
                 return {
                     jsonrpc: "2.0",
                     id,
                     error: {
                         code: -32602,
-                        message: `Skill not found: ${requestedName}`,
+                        message: `Skill not found: ${requestedUri || requestedName}`,
                     },
                 };
             }
+            const resources = skill.files.map((f) => ({
+                uri: f.uri,
+                digest: f.digest,
+            }));
             return {
                 jsonrpc: "2.0",
                 id,
                 result: {
                     skill: {
+                        uri: skill.uri,
+                        frontmatter: skill.frontmatter,
+                        resources,
                         name: skill.name,
                         description: skill.description,
-                        uri: skill.uri,
                         version: skill.version,
                         digest: skill.files[0]?.digest || "",
                     },
+                    uri: skill.uri,
                     frontmatter: skill.frontmatter,
+                    resources,
                     files: skill.files.map((f) => ({
                         path: f.path,
                         uri: f.uri,
@@ -886,17 +978,19 @@ export async function handleJsonRpcMcpRequest(engine, ctx, rpc) {
         };
     }
     catch (err) {
+        const errPayload = {
+            ok: false,
+            error: String(err?.message || err || "MCP tool execution failed"),
+        };
         return {
             jsonrpc: "2.0",
             id,
             result: {
+                structuredContent: errPayload,
                 content: [
                     {
                         type: "text",
-                        text: JSON.stringify({
-                            ok: false,
-                            error: String(err?.message || err || "MCP tool execution failed"),
-                        }, null, 2),
+                        text: JSON.stringify(errPayload, null, 2),
                     },
                 ],
                 isError: true,

package/dist/nl.d.ts

@@ -0,0 +1,34 @@
+import type { ToolDescriptor } from "./types.js";
+export interface NaturalLanguageResolution {
+    resolved: boolean;
+    tool: ToolDescriptor | null;
+    toolSlug: string | null;
+    input: Record<string, unknown>;
+    extractedInput: Record<string, unknown>;
+    reason: string;
+    confidence: number;
+    resolutionMethod: "exact_slug" | "byok_llm" | "semantic_router";
+    byokUsed: string | null;
+    humanSummary: string;
+    missingInputs: string[];
+    needsConnection: boolean;
+    suggestedByokProvider: string | null;
+    alternatives: Array<{
+        slug: string;
+        name: string;
+        riskLevel: string;
+        creditCost: number;
+    }>;
+}
+export declare function extractParametersFromNaturalLanguage(prompt: string, tool: ToolDescriptor, explicitInput?: Record<string, unknown>): {
+    input: Record<string, unknown>;
+    missingInputs: string[];
+};
+export declare function resolveNaturalLanguageIntent(params: {
+    prompt: string;
+    tools: ToolDescriptor[];
+    explicitInput?: Record<string, unknown>;
+    byokKeys?: Record<string, string>;
+    activeConnectionProviders?: Set<string>;
+    preferByokLlm?: boolean;
+}): Promise<NaturalLanguageResolution>;