@astramindapp/mcp-server 0.12.1 → 0.13.0

package/dist/server.js

@@ -1163,18 +1163,22 @@ function createMindMcpServer(client) {
     // ─── mind_admin ─────────────────────────────────────────
     // Admin-only operations. Requires an admin API key.
     // Create users, manage featured minds, list/update users.
-    server.tool("mind_admin", "Admin-only tool for managing MIND users and featured minds. Requires an admin API key. Use to create new user accounts, provision featured minds, list users, and manage the featured minds catalog.", {
+    server.tool("mind_admin", "Admin-only tool for managing MIND users and the Featured Minds Portal. Requires an admin API key. Full CRUD over featured minds (create / list / get_full / update / update_owner_profile / reorder / delete), plus user provisioning and tier/credit management. The Featured Minds Portal at /admin/featuredmindsportal uses these same endpoints — get_featured_mind_full + update_featured_mind_owner_profile let you edit the linked user's LLM model, public chat prompt, temperature, reasoning effort, brand fields, and avatar/banner from any MCP client.", {
         action: zod_1.z
             .enum([
             "create_user",
             "create_featured_mind",
             "list_featured_minds",
+            "get_featured_mind_full",
             "update_featured_mind",
+            "update_featured_mind_owner_profile",
+            "reorder_featured_minds",
+            "delete_featured_mind",
             "list_users",
             "update_user_tier",
             "adjust_user_credits",
         ])
-            .describe("Admin action: create_user, create_featured_mind, list_featured_minds, update_featured_mind, list_users, update_user_tier, adjust_user_credits"),
+            .describe("Admin action. Featured Minds Portal actions: create_featured_mind, list_featured_minds, get_featured_mind_full (bundled view + owner profile + model catalog), update_featured_mind (catalog fields: title/description/tags/featured/display_order/is_public/avatar_url/banner_url/subtitle/price), update_featured_mind_owner_profile (write-through to linked user_profiles: preferred_llm_model, public_mind_prompt, chat_temperature, chat_reasoning_effort, public_mind_enabled, public_mind_tagline/greeting/persona, bio, avatar_url, banner_url), reorder_featured_minds (bulk display_order via ordered_mind_ids list), delete_featured_mind. User actions: create_user, list_users, update_user_tier, adjust_user_credits."),
         // create_user fields
         username: zod_1.z.string().optional().describe("Username for new user (3-30 chars, letters/numbers/underscores)"),
         email: zod_1.z.string().optional().describe("Email for new user"),
@@ -1182,23 +1186,53 @@ function createMindMcpServer(client) {
         source: zod_1.z.string().optional().describe("Source app/partner that created this user (e.g. 'myapp')"),
         generate_api_key: zod_1.z.boolean().optional().describe("If true, also generate a developer API key (mind_...) for the new user"),
         api_key_name: zod_1.z.string().optional().describe("Name for the generated API key (defaults to '{source} integration')"),
-        // featured mind fields
-        mind_id: zod_1.z.string().optional().describe("Featured mind ID for update operations"),
+        // featured mind catalog fields
+        mind_id: zod_1.z.string().optional().describe("Featured mind ID — required for get_featured_mind_full / update_featured_mind / update_featured_mind_owner_profile / delete_featured_mind"),
         title: zod_1.z.string().optional().describe("Display title for the featured mind"),
-        description: zod_1.z.string().optional().describe("Description of the featured mind"),
+        subtitle: zod_1.z.string().optional().describe("One-line hook shown under the title on portal cards (≤140 chars)"),
+        description: zod_1.z.string().optional().describe("Long-form description shown on the public profile"),
         tags: zod_1.z.array(zod_1.z.string()).optional().describe("Tags for the featured mind"),
         price: zod_1.z.number().optional().describe("Subscription price (0 = free)"),
-        featured: zod_1.z.boolean().optional().describe("Whether to show in featured section"),
-        display_order: zod_1.z.number().optional().describe("Sort order in featured list"),
-        is_public: zod_1.z.boolean().optional().describe("If true, anyone can query this mind"),
-        avatar_url: zod_1.z.string().optional().describe("Avatar image URL"),
+        featured: zod_1.z.boolean().optional().describe("Whether to show in the featured grid on /discover"),
+        display_order: zod_1.z.number().optional().describe("Sort order in featured list (lower = earlier)"),
+        is_public: zod_1.z.boolean().optional().describe("If true, anyone can query this mind at normal credit rate (marketplace public)"),
+        avatar_url: zod_1.z.string().optional().describe("Avatar image URL (S3-hosted). Writes-through to user_profiles when used with update_featured_mind_owner_profile."),
+        banner_url: zod_1.z.string().optional().describe("Banner image URL (S3-hosted). Writes-through to user_profiles when used with update_featured_mind_owner_profile."),
+        // owner_profile fields (write-through to user_profiles)
+        preferred_llm_model: zod_1.z
+            .union([zod_1.z.string(), zod_1.z.null()])
+            .optional()
+            .describe("LLM model id (e.g. 'openai/gpt-4o', 'anthropic/claude-sonnet-4.6'). Used by the public chat at /m/{username}. Pass null to clear and fall back to platform default. Use mind_admin with action=list_featured_minds then get_featured_mind_full to see available_models."),
+        public_mind_enabled: zod_1.z.boolean().optional().describe("Whether anonymous visitors can chat with this MIND at /m/{username}"),
+        public_mind_prompt: zod_1.z
+            .string()
+            .max(3000)
+            .optional()
+            .describe("System prompt used by the public chat (≤3000 chars). Empty string clears it and the auto-built default is used."),
+        public_mind_tagline: zod_1.z.string().max(160).optional().describe("Public landing tagline (≤160 chars)"),
+        public_mind_greeting: zod_1.z.string().max(500).optional().describe("Public landing greeting message (≤500 chars)"),
+        public_mind_persona: zod_1.z.string().max(800).optional().describe("Persona description used inside the auto-built default prompt (≤800 chars)"),
+        chat_temperature: zod_1.z
+            .union([zod_1.z.number().min(0).max(2), zod_1.z.null()])
+            .optional()
+            .describe("Per-MIND temperature override (0.0–2.0). Null clears to provider default."),
+        chat_reasoning_effort: zod_1.z
+            .union([zod_1.z.enum(["minimal", "low", "medium", "high"]), zod_1.z.null()])
+            .optional()
+            .describe("Per-MIND reasoning_effort override. Only honored for thinking-capable models (supports_reasoning_effort=true)."),
+        bio: zod_1.z.string().max(500).optional().describe("Owner bio (shown across MIND profile surfaces, ≤500 chars)"),
+        // reorder
+        ordered_mind_ids: zod_1.z
+            .array(zod_1.z.string())
+            .optional()
+            .describe("For reorder_featured_minds: full list of mind_ids in the order you want. Index in the list becomes display_order."),
         // user management fields
         tier: zod_1.z.string().optional().describe("Subscription tier: free, pro, enterprise"),
         credits: zod_1.z.number().optional().describe("Credits to add (positive) or deduct (negative)"),
         // list fields
         query: zod_1.z.string().optional().describe("Search query for list_users"),
         page: zod_1.z.number().optional().describe("Page number for paginated results"),
-    }, async ({ action, username, email, password, source, generate_api_key, api_key_name, mind_id, title, description, tags, price, featured, display_order, is_public, avatar_url, tier, credits, query, page }) => {
+    }, async ({ action, username, email, password, source, generate_api_key, api_key_name, mind_id, title, subtitle, description, tags, price, featured, display_order, is_public, avatar_url, banner_url, preferred_llm_model, public_mind_enabled, public_mind_prompt, public_mind_tagline, public_mind_greeting, public_mind_persona, chat_temperature, chat_reasoning_effort, bio, ordered_mind_ids, tier, credits, query, page }) => {
         try {
             switch (action) {
                 case "create_user": {
@@ -1262,6 +1296,8 @@ function createMindMcpServer(client) {
                     const patch = {};
                     if (title !== undefined)
                         patch.title = title;
+                    if (subtitle !== undefined)
+                        patch.subtitle = subtitle;
                     if (description !== undefined)
                         patch.description = description;
                     if (tags !== undefined)
@@ -1276,11 +1312,131 @@ function createMindMcpServer(client) {
                         patch.is_public = is_public;
                     if (avatar_url !== undefined)
                         patch.avatar_url = avatar_url;
+                    if (banner_url !== undefined)
+                        patch.banner_url = banner_url;
                     const result = await client.adminUpdateFeaturedMind(mind_id, patch);
                     return {
                         content: [{ type: "text", text: `✅ Updated featured mind: "${result.title}"` }],
                     };
                 }
+                case "get_featured_mind_full": {
+                    if (!mind_id) {
+                        return {
+                            content: [{ type: "text", text: "Error: mind_id is required for get_featured_mind_full" }],
+                            isError: true,
+                        };
+                    }
+                    const full = await client.adminGetFeaturedMindFull(mind_id);
+                    const op = full.owner_profile;
+                    const fm = full.featured_mind;
+                    const modelLines = full.available_models
+                        .slice(0, 8)
+                        .map((m) => `  • ${m.id} — ${m.name} (${m.provider})`)
+                        .join("\n");
+                    const more = full.available_models.length > 8 ? `  …and ${full.available_models.length - 8} more` : "";
+                    const ownerLines = [
+                        `@${op.username}`,
+                        `  preferred_llm_model: ${op.preferred_llm_model ?? "(platform default)"}`,
+                        `  public_mind_enabled: ${op.public_mind_enabled}`,
+                        `  public_mind_prompt: ${op.public_mind_prompt ? `${op.public_mind_prompt.slice(0, 80)}${op.public_mind_prompt.length > 80 ? "…" : ""}` : "(default)"}`,
+                        `  tagline: ${op.public_mind_tagline || "—"}`,
+                        `  greeting: ${op.public_mind_greeting ? op.public_mind_greeting.slice(0, 60) + (op.public_mind_greeting.length > 60 ? "…" : "") : "—"}`,
+                        `  persona: ${op.public_mind_persona ? op.public_mind_persona.slice(0, 60) + (op.public_mind_persona.length > 60 ? "…" : "") : "—"}`,
+                        `  temperature: ${op.chat_temperature ?? "(default)"}`,
+                        `  reasoning_effort: ${op.chat_reasoning_effort ?? "(default)"}`,
+                        `  avatar_url: ${op.avatar_url ? "✓ set" : "—"}`,
+                        `  banner_url: ${op.banner_url ? "✓ set" : "—"}`,
+                    ].join("\n");
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Featured mind: "${fm.title}" (id: ${fm.mind_id}, order: ${fm.display_order}, featured: ${fm.featured}, public: ${fm.is_public ?? false})\n\nOwner profile (write-through target):\n${ownerLines}\n\nAvailable models (${full.available_models.length} total):\n${modelLines}${more ? "\n" + more : ""}`,
+                            },
+                        ],
+                    };
+                }
+                case "update_featured_mind_owner_profile": {
+                    if (!mind_id) {
+                        return {
+                            content: [{ type: "text", text: "Error: mind_id is required for update_featured_mind_owner_profile" }],
+                            isError: true,
+                        };
+                    }
+                    const patch = {};
+                    if (preferred_llm_model !== undefined)
+                        patch.preferred_llm_model = preferred_llm_model;
+                    if (public_mind_enabled !== undefined)
+                        patch.public_mind_enabled = public_mind_enabled;
+                    if (public_mind_prompt !== undefined)
+                        patch.public_mind_prompt = public_mind_prompt;
+                    if (public_mind_tagline !== undefined)
+                        patch.public_mind_tagline = public_mind_tagline;
+                    if (public_mind_greeting !== undefined)
+                        patch.public_mind_greeting = public_mind_greeting;
+                    if (public_mind_persona !== undefined)
+                        patch.public_mind_persona = public_mind_persona;
+                    if (chat_temperature !== undefined)
+                        patch.chat_temperature = chat_temperature;
+                    if (chat_reasoning_effort !== undefined)
+                        patch.chat_reasoning_effort = chat_reasoning_effort;
+                    if (bio !== undefined)
+                        patch.bio = bio;
+                    if (avatar_url !== undefined)
+                        patch.avatar_url = avatar_url;
+                    if (banner_url !== undefined)
+                        patch.banner_url = banner_url;
+                    if (Object.keys(patch).length === 0) {
+                        return {
+                            content: [{ type: "text", text: "Nothing to update — pass at least one owner_profile field." }],
+                            isError: true,
+                        };
+                    }
+                    const result = await client.adminUpdateFeaturedMindOwnerProfile(mind_id, patch);
+                    const changed = Object.keys(patch).join(", ");
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `✅ Owner-profile write-through for @${result.username}: ${changed}`,
+                            },
+                        ],
+                    };
+                }
+                case "reorder_featured_minds": {
+                    if (!ordered_mind_ids || ordered_mind_ids.length === 0) {
+                        return {
+                            content: [{ type: "text", text: "Error: ordered_mind_ids (full ordered list) is required" }],
+                            isError: true,
+                        };
+                    }
+                    const result = await client.adminReorderFeaturedMinds(ordered_mind_ids);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `✅ Reordered ${result.total} featured mind(s) — ${result.updated} display_order value(s) changed`,
+                            },
+                        ],
+                    };
+                }
+                case "delete_featured_mind": {
+                    if (!mind_id) {
+                        return {
+                            content: [{ type: "text", text: "Error: mind_id is required for delete_featured_mind" }],
+                            isError: true,
+                        };
+                    }
+                    const result = await client.adminDeleteFeaturedMind(mind_id);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `✅ Featured mind removed (${result.status}). The user's underlying MIND is not deleted.`,
+                            },
+                        ],
+                    };
+                }
                 case "list_users": {
                     const result = await client.adminListUsers({ q: query, page: page ?? 1 });
                     const users = result.users ?? [];