@astramindapp/mcp-server 0.11.0 → 0.12.1

package/dist/server.js

@@ -475,7 +475,13 @@ function createMindMcpServer(client) {
         end_time: zod_1.z.string().optional().describe("End time for calendar events (ISO 8601)"),
         event_id: zod_1.z.string().optional().describe("Event ID for calendar_update/calendar_delete"),
         all_day: zod_1.z.boolean().optional().describe("Whether the calendar event is all-day"),
-    }, async ({ action, title, description, status, priority, due_date, item_id, item_ids, start_time, end_time, event_id, all_day }) => {
+        tags: zod_1.z.array(zod_1.z.string()).optional().describe("Tags for the life item (free-form strings). On update, REPLACES the existing tag list — pass the full new set."),
+        color: zod_1.z
+            .enum(["default", "red", "orange", "yellow", "green", "blue", "purple", "pink"])
+            .optional()
+            .describe("Left-border color stripe on the board card. Use to group items (e.g. Astra=red, Atlas=blue)."),
+        target_date: zod_1.z.string().optional().describe("Target completion date in YYYY-MM-DD format — when the project should be done. Powers the countdown badge on the card."),
+    }, async ({ action, title, description, status, priority, due_date, item_id, item_ids, start_time, end_time, event_id, all_day, tags, color, target_date }) => {
         try {
             switch (action) {
                 case "list": {
@@ -500,12 +506,22 @@ function createMindMcpServer(client) {
                         status: status ?? "action",
                         priority: priority ?? "medium",
                         due_date,
+                        tags,
+                        color,
+                        target_date,
                     });
+                    const extras = [];
+                    if (result.tags && result.tags.length > 0)
+                        extras.push(`tags: ${result.tags.join(", ")}`);
+                    if (result.color && result.color !== "default")
+                        extras.push(`color: ${result.color}`);
+                    if (result.target_date)
+                        extras.push(`target: ${result.target_date}`);
                     return {
                         content: [
                             {
                                 type: "text",
-                                text: `✅ Created life item: "${result.title}" (id: ${result.item_id}, priority: ${result.priority}, due: ${result.due_date ?? "none"})`,
+                                text: `✅ Created life item: "${result.title}" (id: ${result.item_id}, priority: ${result.priority}, due: ${result.due_date ?? "none"}${extras.length ? `, ${extras.join(", ")}` : ""})`,
                             },
                         ],
                     };
@@ -528,9 +544,22 @@ function createMindMcpServer(client) {
                         patch.priority = priority;
                     if (due_date)
                         patch.due_date = due_date;
+                    if (tags)
+                        patch.tags = tags;
+                    if (color)
+                        patch.color = color;
+                    if (target_date)
+                        patch.target_date = target_date;
                     const result = await client.updateLifeItem(item_id, patch);
+                    const extras = [];
+                    if (result.tags && result.tags.length > 0)
+                        extras.push(`tags: ${result.tags.join(", ")}`);
+                    if (result.color && result.color !== "default")
+                        extras.push(`color: ${result.color}`);
+                    if (result.target_date)
+                        extras.push(`target: ${result.target_date}`);
                     return {
-                        content: [{ type: "text", text: `✅ Updated: "${result.title}" (status: ${result.status})` }],
+                        content: [{ type: "text", text: `✅ Updated: "${result.title}" (status: ${result.status}${extras.length ? `, ${extras.join(", ")}` : ""})` }],
                     };
                 }
                 case "complete": {
@@ -596,8 +625,15 @@ function createMindMcpServer(client) {
                     const lines = [
                         `**${result.title}**`,
                         `Status: ${result.status ?? "—"} | Priority: ${result.priority ?? "—"} | Due: ${result.due_date ?? "none"}`,
-                        result.description ? `\n${result.description}` : "",
                     ];
+                    if (result.color && result.color !== "default")
+                        lines.push(`Color: ${result.color}`);
+                    if (result.target_date)
+                        lines.push(`Target: ${result.target_date}`);
+                    if (result.tags && result.tags.length > 0)
+                        lines.push(`Tags: ${result.tags.join(", ")}`);
+                    if (result.description)
+                        lines.push(`\n${result.description}`);
                     return { content: [{ type: "text", text: lines.join("\n") }] };
                 }
                 case "calendar_list": {
@@ -2328,8 +2364,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."),
@@ -2396,8 +2436,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}.`;
@@ -2446,6 +2507,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 {
@@ -2455,17 +2539,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");
@@ -2837,6 +2927,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) {