eassist-mcp 1.0.0

package/build/tools/actions.d.ts

@@ -0,0 +1,200 @@
+export declare const actionToolSchemas: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            title: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            initiative: {
+                type: string;
+                description: string;
+            };
+            assignees: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            priority: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            due_date: {
+                type: string;
+                description: string;
+            };
+            action_id?: undefined;
+            status?: undefined;
+            action_ids?: undefined;
+            content?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            action_id: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description?: undefined;
+            };
+            description: {
+                type: string;
+                description?: undefined;
+            };
+            status: {
+                type: string;
+                description: string;
+            };
+            priority: {
+                type: string;
+                enum: string[];
+                description?: undefined;
+            };
+            due_date: {
+                type: string;
+                description: string;
+            };
+            assignees: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            initiative?: undefined;
+            action_ids?: undefined;
+            content?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            action_id: {
+                type: string;
+                description: string;
+            };
+            title?: undefined;
+            description?: undefined;
+            initiative?: undefined;
+            assignees?: undefined;
+            priority?: undefined;
+            due_date?: undefined;
+            status?: undefined;
+            action_ids?: undefined;
+            content?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            action_id: {
+                type: string;
+                description: string;
+            };
+            assignees: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            title?: undefined;
+            description?: undefined;
+            initiative?: undefined;
+            priority?: undefined;
+            due_date?: undefined;
+            status?: undefined;
+            action_ids?: undefined;
+            content?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            action_ids: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            status: {
+                type: string;
+                description: string;
+            };
+            priority: {
+                type: string;
+                enum: string[];
+                description?: undefined;
+            };
+            assignees: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            title?: undefined;
+            description?: undefined;
+            initiative?: undefined;
+            due_date?: undefined;
+            action_id?: undefined;
+            content?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            action_id: {
+                type: string;
+                description: string;
+            };
+            content: {
+                type: string;
+                description: string;
+            };
+            title?: undefined;
+            description?: undefined;
+            initiative?: undefined;
+            assignees?: undefined;
+            priority?: undefined;
+            due_date?: undefined;
+            status?: undefined;
+            action_ids?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare function handleActionTool(name: string, args: Record<string, unknown>): Promise<string>;

package/build/tools/actions.js

@@ -0,0 +1,207 @@
+import { apiPost, apiPatch, apiDelete } from '../client.js';
+import { fmtAction, fmtActionTable } from '../format.js';
+import { resolveUser, resolveInitiative, clearCache } from '../resolve.js';
+export const actionToolSchemas = [
+    {
+        name: 'create_action',
+        description: 'Create a new action. Can be linked to an initiative or standalone. Assignees are resolved by name/email.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                title: { type: 'string', description: 'Action title' },
+                description: { type: 'string', description: 'Optional description' },
+                initiative: { type: 'string', description: 'Initiative name or ID to link this action to (optional)' },
+                assignees: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'List of assignee names or emails (fuzzy matched)',
+                },
+                priority: { type: 'string', enum: ['urgent', 'high', 'medium', 'low'], description: 'Priority (default: medium)' },
+                due_date: { type: 'string', description: 'Due date in ISO format (e.g. 2025-06-01)' },
+            },
+            required: ['title'],
+        },
+    },
+    {
+        name: 'update_action',
+        description: 'Update an existing action — change title, description, status, priority, due date, or assignees.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action_id: { type: 'string', description: 'Action ID' },
+                title: { type: 'string' },
+                description: { type: 'string' },
+                status: { type: 'string', description: 'open, in_progress, completed, cancelled' },
+                priority: { type: 'string', enum: ['urgent', 'high', 'medium', 'low'] },
+                due_date: { type: 'string', description: 'ISO date string' },
+                assignees: { type: 'array', items: { type: 'string' }, description: 'New list of assignees (replaces existing)' },
+            },
+            required: ['action_id'],
+        },
+    },
+    {
+        name: 'complete_action',
+        description: 'Mark an action as completed.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action_id: { type: 'string', description: 'Action ID to mark complete' },
+            },
+            required: ['action_id'],
+        },
+    },
+    {
+        name: 'assign_action',
+        description: 'Assign (or reassign) an action to one or more people by name or email.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action_id: { type: 'string', description: 'Action ID' },
+                assignees: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Names or emails of assignees (fuzzy matched)',
+                },
+            },
+            required: ['action_id', 'assignees'],
+        },
+    },
+    {
+        name: 'delete_action',
+        description: 'Delete an action permanently. Use with care.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action_id: { type: 'string', description: 'Action ID to delete' },
+            },
+            required: ['action_id'],
+        },
+    },
+    {
+        name: 'bulk_update_actions',
+        description: 'Update status or assignees on multiple actions at once.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action_ids: { type: 'array', items: { type: 'string' }, description: 'List of action IDs' },
+                status: { type: 'string', description: 'New status for all actions' },
+                priority: { type: 'string', enum: ['urgent', 'high', 'medium', 'low'] },
+                assignees: { type: 'array', items: { type: 'string' }, description: 'New assignees (replaces existing on all)' },
+            },
+            required: ['action_ids'],
+        },
+    },
+    {
+        name: 'add_comment',
+        description: 'Add a comment/update to an action.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action_id: { type: 'string', description: 'Action ID' },
+                content: { type: 'string', description: 'Comment text' },
+            },
+            required: ['action_id', 'content'],
+        },
+    },
+];
+async function resolveAssignees(names) {
+    const ids = [];
+    const errors = [];
+    for (const name of names) {
+        const r = await resolveUser(name);
+        if ('error' in r)
+            errors.push(r.error);
+        else
+            ids.push(r.id);
+    }
+    return { ids, errors };
+}
+export async function handleActionTool(name, args) {
+    switch (name) {
+        case 'create_action': {
+            let initiativeId;
+            if (args.initiative) {
+                const resolved = await resolveInitiative(args.initiative);
+                if ('error' in resolved)
+                    return resolved.error;
+                initiativeId = resolved.id;
+            }
+            const assigneeIds = [];
+            if (Array.isArray(args.assignees) && args.assignees.length) {
+                const { ids, errors } = await resolveAssignees(args.assignees);
+                if (errors.length)
+                    return errors.join('\n');
+                assigneeIds.push(...ids);
+            }
+            const body = {
+                title: args.title,
+                description: args.description ?? null,
+                priority: args.priority ?? 'medium',
+                dueDate: args.due_date ?? null,
+                assigneeIds,
+            };
+            const url = initiativeId ? `/initiatives/${initiativeId}/actions` : '/actions';
+            const action = await apiPost(url, body);
+            clearCache();
+            return `Action created successfully.\n\n${fmtAction(action)}`;
+        }
+        case 'update_action': {
+            const body = {};
+            if (args.title !== undefined)
+                body.title = args.title;
+            if (args.description !== undefined)
+                body.description = args.description;
+            if (args.status !== undefined)
+                body.status = args.status;
+            if (args.priority !== undefined)
+                body.priority = args.priority;
+            if (args.due_date !== undefined)
+                body.dueDate = args.due_date;
+            if (Array.isArray(args.assignees) && args.assignees.length) {
+                const { ids, errors } = await resolveAssignees(args.assignees);
+                if (errors.length)
+                    return errors.join('\n');
+                body.assigneeIds = ids;
+            }
+            const action = await apiPatch(`/actions/${args.action_id}`, body);
+            return `Action updated.\n\n${fmtAction(action)}`;
+        }
+        case 'complete_action': {
+            const action = await apiPatch(`/actions/${args.action_id}`, { status: 'completed' });
+            return `Marked as completed: **${action.title}**`;
+        }
+        case 'assign_action': {
+            const { ids, errors } = await resolveAssignees(args.assignees);
+            if (errors.length)
+                return errors.join('\n');
+            const action = await apiPatch(`/actions/${args.action_id}`, { assigneeIds: ids });
+            return `Assigned **${action.title}** to ${action.assignees.map(u => u.name).join(', ')}.`;
+        }
+        case 'delete_action': {
+            await apiDelete(`/actions/${args.action_id}`);
+            return `Action ${args.action_id} deleted.`;
+        }
+        case 'bulk_update_actions': {
+            const ids = args.action_ids;
+            const body = { actionIds: ids };
+            if (args.status)
+                body.status = args.status;
+            if (args.priority)
+                body.priority = args.priority;
+            if (Array.isArray(args.assignees) && args.assignees.length) {
+                const { ids: assigneeIds, errors } = await resolveAssignees(args.assignees);
+                if (errors.length)
+                    return errors.join('\n');
+                body.assigneeIds = assigneeIds;
+            }
+            const result = await apiPatch('/actions/bulk', body);
+            return `Updated ${result.updated ?? ids.length} actions.\n\n${fmtActionTable(result.actions ?? [])}`;
+        }
+        case 'add_comment': {
+            await apiPost(`/actions/${args.action_id}/updates`, { content: args.content });
+            return `Comment added to action ${args.action_id}.`;
+        }
+        default:
+            return `Unknown tool: ${name}`;
+    }
+}

package/build/tools/initiatives.d.ts

@@ -0,0 +1,41 @@
+export declare const initiativeToolSchemas: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            title: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            priority: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            due_date: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            title?: undefined;
+            description?: undefined;
+            priority?: undefined;
+            due_date?: undefined;
+        };
+        required?: undefined;
+    };
+})[];
+export declare function handleInitiativeTool(name: string, args: Record<string, unknown>): Promise<string>;

package/build/tools/initiatives.js

@@ -0,0 +1,68 @@
+import { apiGet, apiPost } from '../client.js';
+import { clearCache } from '../resolve.js';
+export const initiativeToolSchemas = [
+    {
+        name: 'create_initiative',
+        description: 'Create a new initiative.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                title: { type: 'string', description: 'Initiative title' },
+                description: { type: 'string', description: 'Optional description' },
+                priority: { type: 'string', enum: ['urgent', 'high', 'medium', 'low'], description: 'Priority (default: medium)' },
+                due_date: { type: 'string', description: 'Due date in ISO format (e.g. 2025-12-31)' },
+            },
+            required: ['title'],
+        },
+    },
+    {
+        name: 'list_members',
+        description: 'List all members across all initiatives. Useful to look up names and emails before assigning actions.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+];
+export async function handleInitiativeTool(name, args) {
+    switch (name) {
+        case 'create_initiative': {
+            const body = {
+                title: args.title,
+                description: args.description ?? null,
+                priority: args.priority ?? 'medium',
+                dueDate: args.due_date ?? null,
+            };
+            const init = await apiPost('/initiatives', body);
+            clearCache();
+            return `Initiative created: **${init.title}** (ID: ${init.id})`;
+        }
+        case 'list_members': {
+            const data = await apiGet('/initiatives');
+            const seen = new Set();
+            const members = [];
+            for (const init of data.initiatives) {
+                try {
+                    const m = await apiGet(`/initiatives/${init.id}/members`);
+                    for (const member of m.members) {
+                        if (!seen.has(member.user.id)) {
+                            seen.add(member.user.id);
+                            members.push({
+                                id: member.user.id,
+                                name: member.user.name,
+                                email: member.user.email,
+                                department: member.department,
+                            });
+                        }
+                    }
+                }
+                catch { /* skip inaccessible */ }
+            }
+            if (members.length === 0)
+                return '_No members found._';
+            const header = '| Name | Email | Department |';
+            const sep = '|------|-------|------------|';
+            const rows = members.map(m => `| ${m.name} | ${m.email} | ${m.department ?? '—'} |`);
+            return `## Members (${members.length})\n\n${[header, sep, ...rows].join('\n')}`;
+        }
+        default:
+            return `Unknown tool: ${name}`;
+    }
+}

package/build/tools/reporting.d.ts

@@ -0,0 +1,144 @@
+export declare const reportingToolSchemas: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            limit: {
+                type: string;
+                description: string;
+            };
+            user?: undefined;
+            status?: undefined;
+            query?: undefined;
+            priority?: undefined;
+            action_id?: undefined;
+            initiative?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            user: {
+                type: string;
+                description: string;
+            };
+            status: {
+                type: string;
+                description: string;
+            };
+            limit?: undefined;
+            query?: undefined;
+            priority?: undefined;
+            action_id?: undefined;
+            initiative?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            limit?: undefined;
+            user?: undefined;
+            status?: undefined;
+            query?: undefined;
+            priority?: undefined;
+            action_id?: undefined;
+            initiative?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            status: {
+                type: string;
+                description: string;
+            };
+            priority: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            user?: undefined;
+            action_id?: undefined;
+            initiative?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            action_id: {
+                type: string;
+                description: string;
+            };
+            limit?: undefined;
+            user?: undefined;
+            status?: undefined;
+            query?: undefined;
+            priority?: undefined;
+            initiative?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            status: {
+                type: string;
+                description: string;
+            };
+            limit?: undefined;
+            user?: undefined;
+            query?: undefined;
+            priority?: undefined;
+            action_id?: undefined;
+            initiative?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            initiative: {
+                type: string;
+                description: string;
+            };
+            limit?: undefined;
+            user?: undefined;
+            status?: undefined;
+            query?: undefined;
+            priority?: undefined;
+            action_id?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare function handleReportingTool(name: string, args: Record<string, unknown>): Promise<string>;