@astramindapp/mcp-server 0.12.0 → 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 ?? [];
@@ -2364,8 +2520,12 @@ function createMindMcpServer(client) {
             "link_invoice",
             "unlink_invoice",
             "create_invoice",
+            "list_workflows",
+            "link_workflow",
+            "unlink_workflow",
+            "used_by",
         ])
-            .describe("Action: list (filter+stats), get (detail+recent activities), create, update (partial), delete (soft archive; pass hard=true to remove), heartbeat (push from agent runtime), probe (HTTP/OpenClaw liveness probe), log_activity (manual note), list_activities, import_from_mind (enrich from agent-identity docs), seed_known (idempotent upsert of canonical seed), set_status (shortcut update), set_current_job (shortcut update), transfer_owner (move the agent to another account's board — needs owner_username), share (grant another account access — needs grantee_username + share_role), list_shares (who the agent is shared with), revoke_share (drop a share grant — needs share_id), list_invoices (invoices linked to an agent), link_invoice (attach an existing invoice id), unlink_invoice (detach an invoice id), create_invoice (create a new Invoice Agent draft + link it)"),
+            .describe("Action: list (filter+stats), get (detail+recent activities), create, update (partial), delete (soft archive; pass hard=true to remove), heartbeat (push from agent runtime), probe (HTTP/OpenClaw liveness probe), log_activity (manual note), list_activities, import_from_mind (enrich from agent-identity docs), seed_known (idempotent upsert of canonical seed), set_status (shortcut update), set_current_job (shortcut update), transfer_owner (move the agent to another account's board — needs owner_username), share (grant another account access — needs grantee_username + share_role), list_shares (who the agent is shared with), revoke_share (drop a share grant — needs share_id), list_invoices (invoices linked to an agent), link_invoice (attach an existing invoice id), unlink_invoice (detach an invoice id), create_invoice (create a new Invoice Agent draft + link it), list_workflows (workflows linked to an agent), link_workflow (attach an existing workflow slug — needs workflow_slug), unlink_workflow (detach a workflow — needs workflow_slug), used_by (inverse view: which agents call this workflow)"),
         slug: zod_1.z.string().optional().describe("Agent slug (lowercase, dashes). Required for get/update/delete/heartbeat/probe/activities/set_*/transfer_owner/share/list_shares/revoke_share."),
         // ownership / sharing
         owner_username: zod_1.z.string().optional().describe("MIND account username to transfer the agent to (action=transfer_owner). The account must already exist."),
@@ -2432,8 +2592,29 @@ function createMindMcpServer(client) {
         unit_price: zod_1.z.number().optional().describe("Line-item unit price for create_invoice (default 0)."),
         currency: zod_1.z.string().optional().describe("Invoice currency for create_invoice (default USD)."),
         invoice_notes: zod_1.z.string().optional().describe("Notes shown on the invoice for create_invoice."),
+        // workflow linking + kind discriminator
+        kind: zod_1.z
+            .enum(["agent", "workflow"])
+            .optional()
+            .describe("Registry kind. Pass on create to scaffold a Workflow card instead of an Agent. Pass on action=list (via list_kind) to filter the board."),
+        list_kind: zod_1.z
+            .enum(["agent", "workflow"])
+            .optional()
+            .describe("Filter the board by kind when listing — 'agent' or 'workflow'. Omit to return both."),
+        workflow_slug: zod_1.z.string().optional().describe("Workflow slug — required for link_workflow / unlink_workflow."),
+        trigger_summary: zod_1.z.string().optional().describe("One-line description of what fires this workflow (kind='workflow' only)."),
+        inputs_summary: zod_1.z.string().optional().describe("One-line description of the data this workflow consumes."),
+        outputs_summary: zod_1.z.string().optional().describe("One-line description of the artifacts this workflow produces."),
+        credentials_required: zod_1.z
+            .array(zod_1.z.string())
+            .optional()
+            .describe("Named credentials this workflow touches (e.g. ['OpenAI API key', 'Resend API key', 'MIND tenant key'])."),
+        steps_json: zod_1.z
+            .string()
+            .optional()
+            .describe("JSON-encoded array of WorkflowStep dicts (kind='workflow' only). Each step: {order, name, description, kind, credentials[], inputs[], outputs[], notes}. Step kind ∈ {trigger, action, ai, branch, loop, wait, notify, output}."),
     }, async (args) => {
-        const { action, slug, name, description, status, cadence, host, host_address, port, health_url, source_path, source_repo, mind_identity_doc_id, responsibilities, triggers, tags, owner_email, owner_username, grantee_username, share_role, share_id, expected_interval_seconds, authority_can_autonomous, authority_requires_approval, hard, current_job, metrics, note, source, activity_type, activity_payload, list_status, list_host, list_tag, list_query, include_archived, limit, overwrite, invoice_id, bill_to_name, bill_to_company, bill_to_email, line_item_description, quantity, unit_price, currency, invoice_notes, } = args;
+        const { action, slug, name, description, status, cadence, host, host_address, port, health_url, source_path, source_repo, mind_identity_doc_id, responsibilities, triggers, tags, owner_email, owner_username, grantee_username, share_role, share_id, expected_interval_seconds, authority_can_autonomous, authority_requires_approval, hard, current_job, metrics, note, source, activity_type, activity_payload, list_status, list_host, list_tag, list_query, include_archived, limit, overwrite, invoice_id, bill_to_name, bill_to_company, bill_to_email, line_item_description, quantity, unit_price, currency, invoice_notes, kind, list_kind, workflow_slug, trigger_summary, inputs_summary, outputs_summary, credentials_required, steps_json, } = args;
         const requireSlug = (label) => {
             if (!slug) {
                 return `Error: 'slug' is required for action=${label}.`;
@@ -2482,6 +2663,29 @@ function createMindMcpServer(client) {
                     requires_approval: authority_requires_approval ?? [],
                 };
             }
+            // Workflow-specific create/update fields. `kind` defaults server-side
+            // to "agent" so it's only sent when the caller passes it explicitly.
+            if (kind !== undefined)
+                payload.kind = kind;
+            if (trigger_summary !== undefined)
+                payload.trigger_summary = trigger_summary;
+            if (inputs_summary !== undefined)
+                payload.inputs_summary = inputs_summary;
+            if (outputs_summary !== undefined)
+                payload.outputs_summary = outputs_summary;
+            if (credentials_required !== undefined)
+                payload.credentials_required = credentials_required;
+            if (steps_json !== undefined) {
+                try {
+                    const parsed = JSON.parse(steps_json);
+                    if (Array.isArray(parsed))
+                        payload.steps = parsed;
+                }
+                catch {
+                    // Surface a clear error rather than silently sending invalid JSON.
+                    throw new Error("steps_json must be a JSON-encoded array of WorkflowStep dicts.");
+                }
+            }
             return payload;
         };
         try {
@@ -2491,17 +2695,23 @@ function createMindMcpServer(client) {
                         status: list_status,
                         host: list_host,
                         tag: list_tag,
+                        kind: list_kind,
                         q: list_query,
                         include_archived,
                     });
                     const lines = [];
                     const s = result.stats;
-                    lines.push(`Agent fleet: ${s.total} total · ${s.running} running · ${s.planned} planned · ${s.paused} paused · ${s.error} errored`, `Live: ${s.online} online · ${s.stale} stale · ${s.offline} offline`, "");
+                    const get = (k) => s[k] ?? 0;
+                    const kindLine = s.agents !== undefined || s.workflows !== undefined
+                        ? `Kind: ${get("agents")} agents · ${get("workflows")} workflows`
+                        : "";
+                    lines.push(`Registry: ${get("total")} total · ${get("running")} running · ${get("planned")} planned · ${get("paused")} paused · ${get("error")} errored`, `Live: ${get("online")} online · ${get("stale")} stale · ${get("offline")} offline`, kindLine, "");
                     for (const a of result.agents) {
                         const host = a.host ?? "—";
-                        lines.push(`• [${a.status.padEnd(8)}] ${a.slug.padEnd(28)} ${a.live_status.padEnd(7)} host=${host} owner=${a.owner_username ?? "—"} — ${a.name}`);
+                        const kindIcon = a.kind === "workflow" ? "⚙" : "🧠";
+                        lines.push(`• ${kindIcon} [${a.status.padEnd(8)}] ${a.slug.padEnd(28)} ${a.live_status.padEnd(7)} host=${host} owner=${a.owner_username ?? "—"} — ${a.name}`);
                     }
-                    return { content: [{ type: "text", text: lines.join("\n") }] };
+                    return { content: [{ type: "text", text: lines.filter(Boolean).join("\n") }] };
                 }
                 case "get": {
                     const err = requireSlug("get");
@@ -2873,6 +3083,86 @@ function createMindMcpServer(client) {
                         ],
                     };
                 }
+                case "list_workflows": {
+                    const err = requireSlug("list_workflows");
+                    if (err)
+                        return { content: [{ type: "text", text: err }], isError: true };
+                    const result = await client.listAgentWorkflows(slug);
+                    if (!result.workflows.length) {
+                        return { content: [{ type: "text", text: `No workflows linked to ${slug}.` }] };
+                    }
+                    const lines = result.workflows.map((w) => `  ⚙ ${w.slug.padEnd(28)} steps=${String(w.step_count).padStart(2)} · ${w.trigger_summary ?? "(no trigger summary)"} — ${w.name}`);
+                    return {
+                        content: [
+                            { type: "text", text: `Workflows linked to ${slug}:\n${lines.join("\n")}` },
+                        ],
+                    };
+                }
+                case "link_workflow": {
+                    const err = requireSlug("link_workflow");
+                    if (err)
+                        return { content: [{ type: "text", text: err }], isError: true };
+                    if (!workflow_slug) {
+                        return {
+                            content: [{ type: "text", text: "Error: 'workflow_slug' is required for link_workflow." }],
+                            isError: true,
+                        };
+                    }
+                    const updated = await client.linkAgentWorkflow(slug, workflow_slug);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `🔗 Linked workflow ${workflow_slug} to ${updated.slug} (${updated.linked_workflows.length} total).`,
+                            },
+                        ],
+                    };
+                }
+                case "unlink_workflow": {
+                    const err = requireSlug("unlink_workflow");
+                    if (err)
+                        return { content: [{ type: "text", text: err }], isError: true };
+                    if (!workflow_slug) {
+                        return {
+                            content: [{ type: "text", text: "Error: 'workflow_slug' is required for unlink_workflow." }],
+                            isError: true,
+                        };
+                    }
+                    const updated = await client.unlinkAgentWorkflow(slug, workflow_slug);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `✂️ Unlinked workflow ${workflow_slug} from ${updated.slug} (${updated.linked_workflows.length} remain).`,
+                            },
+                        ],
+                    };
+                }
+                case "used_by": {
+                    const err = requireSlug("used_by");
+                    if (err)
+                        return { content: [{ type: "text", text: err }], isError: true };
+                    const result = await client.workflowUsedBy(slug);
+                    if (!result.agents.length) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: `${result.kind === "workflow" ? "Workflow" : "Agent"} ${result.slug} is not linked from any agent yet.`,
+                                },
+                            ],
+                        };
+                    }
+                    const lines = result.agents.map((a) => `  🧠 ${a.slug.padEnd(28)} host=${a.host ?? "—"} owner=${a.owner_username ?? "—"} — ${a.name}`);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `${result.name} is linked from ${result.agents.length} agent(s):\n${lines.join("\n")}`,
+                            },
+                        ],
+                    };
+                }
             }
         }
         catch (err) {