@studiometa/productive-mcp 0.10.1 → 0.10.3

package/dist/{handlers-DWowqxFA.js → handlers-CaOBYauF.js}

@@ -1,5 +1,5 @@
-import { ProductiveApi, formatAttachment, formatBooking, formatComment, formatCompany, formatDeal, formatDiscussion, formatListResponse, formatPage, formatPerson, formatProject, formatService, formatTask, formatTimeEntry, formatTimer } from "@studiometa/productive-api";
-import { RESOURCES, ResolveError, VALID_REPORT_TYPES, createBooking, createComment, createCompany, createDeal, createDiscussion, createPage, createTask, createTimeEntry, deleteAttachment, deleteDiscussion, deletePage, deleteTimeEntry, fromHandlerContext, getAttachment, getBooking, getComment, getCompany, getDeal, getDiscussion, getPage, getPerson, getProject, getReport, getTask, getTimeEntry, getTimer, listAttachments, listBookings, listComments, listCompanies, listDeals, listDiscussions, listPages, listPeople, listProjects, listServices, listTasks, listTimeEntries, listTimers, reopenDiscussion, resolveDiscussion, resolveResource, startTimer, stopTimer, updateBooking, updateComment, updateCompany, updateDeal, updateDiscussion, updatePage, updateTask, updateTimeEntry } from "@studiometa/productive-core";
+import { ProductiveApi, formatActivity, formatAttachment, formatBooking, formatComment, formatCompany, formatDeal, formatDiscussion, formatListResponse, formatPage, formatPerson, formatProject, formatService, formatTask, formatTimeEntry, formatTimer } from "@studiometa/productive-api";
+import { RESOURCES, ResolveError, VALID_REPORT_TYPES, completeTask, createBooking, createComment, createCompany, createDeal, createDiscussion, createPage, createTask, createTimeEntry, deleteAttachment, deleteDiscussion, deletePage, deleteTimeEntry, fromHandlerContext, getAttachment, getBooking, getComment, getCompany, getDeal, getDealContext, getDiscussion, getMyDaySummary, getPage, getPerson, getProject, getProjectContext, getProjectHealthSummary, getReport, getTask, getTaskContext, getTeamPulseSummary, getTimeEntry, getTimer, listActivities, listAttachments, listBookings, listComments, listCompanies, listDeals, listDiscussions, listPages, listPeople, listProjects, listServices, listTasks, listTimeEntries, listTimers, logDay, reopenDiscussion, resolveDiscussion, resolveResource, startTimer, stopTimer, updateBooking, updateComment, updateCompany, updateDeal, updateDiscussion, updatePage, updateTask, updateTimeEntry, weeklyStandup } from "@studiometa/productive-core";
 /**
 * Custom error classes for MCP server
 *
@@ -233,6 +233,12 @@ function formatDiscussion$1(discussion, options) {
 	if (options?.compact) return compactify(result, ["body"]);
 	return result;
 }
+function formatActivity$1(activity, options) {
+	return formatActivity(activity, {
+		...MCP_FORMAT_OPTIONS,
+		included: options?.included
+	});
+}
 /**
 * Format list response with pagination
 *
@@ -251,6 +257,337 @@ function formatListResponse$1(data, formatter, meta, options) {
 	});
 }
 /**
+* Get today's date string in YYYY-MM-DD format
+*/
+function getToday() {
+	return (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+}
+/**
+* Get suggestions for tasks.list response.
+*
+* - Warns about overdue tasks (due_date < today and not closed)
+* - Informs about unassigned tasks
+*/
+function getTaskListSuggestions(tasks) {
+	const suggestions = [];
+	if (!tasks || tasks.length === 0) return suggestions;
+	const today = getToday();
+	let overdueCount = 0;
+	let unassignedCount = 0;
+	for (const task of tasks) {
+		const attrs = task.attributes;
+		const relationships = task.relationships;
+		const dueDate = attrs.due_date;
+		const closed = attrs.closed;
+		const closedAt = attrs.closed_at;
+		if (dueDate && dueDate < today && !closed && !closedAt) overdueCount++;
+		if (!(relationships?.assignee)?.data) unassignedCount++;
+	}
+	if (overdueCount > 0) suggestions.push(`⚠️ ${overdueCount} task(s) are overdue`);
+	if (unassignedCount > 0) suggestions.push(`ℹ️ ${unassignedCount} task(s) have no assignee`);
+	return suggestions;
+}
+/**
+* Get suggestions for tasks.get response.
+*
+* - Warns if the single task is overdue (and by how many days)
+* - Informs if no time has been logged (only when time_entries are included)
+*/
+function getTaskGetSuggestions(task, included) {
+	const suggestions = [];
+	if (!task) return suggestions;
+	const attrs = task.attributes;
+	const today = getToday();
+	const dueDate = attrs.due_date;
+	const closed = attrs.closed;
+	const closedAt = attrs.closed_at;
+	if (dueDate && dueDate < today && !closed && !closedAt) {
+		const due = new Date(dueDate);
+		const now = new Date(today);
+		const diffDays = Math.round((now.getTime() - due.getTime()) / (1e3 * 60 * 60 * 24));
+		suggestions.push(`⚠️ Task is ${diffDays} day(s) overdue`);
+	}
+	if (included && included.length > 0) {
+		const taskId = task.id;
+		if (included.filter((r) => {
+			if (r.type !== "time_entries") return false;
+			return ((r.relationships?.task)?.data)?.id === taskId;
+		}).length === 0) suggestions.push("ℹ️ No time entries on this task");
+	}
+	return suggestions;
+}
+/**
+* Get suggestions for time.list response.
+*
+* - Shows total hours logged across all entries in the response.
+* - If filtered by today, shows hours vs 8h target.
+*/
+function getTimeListSuggestions(entries, filter) {
+	const suggestions = [];
+	if (!entries || entries.length === 0) return suggestions;
+	const totalMinutes = entries.reduce((sum, entry) => {
+		return sum + (entry.attributes.time || 0);
+	}, 0);
+	const totalHours = +(totalMinutes / 60).toFixed(1);
+	const today = getToday();
+	if (filter?.after === today && filter?.before === today) suggestions.push(`📊 ${totalHours}h/8h logged today`);
+	else if (totalMinutes > 0) suggestions.push(`📊 Total: ${totalHours}h logged`);
+	return suggestions;
+}
+/**
+* Get suggestions for summaries.my_day response.
+*
+* - Warns if no time has been logged today.
+* - Warns if a timer has been running for more than 2 hours.
+*/
+function getMyDaySuggestions(data) {
+	const suggestions = [];
+	if (!data) return suggestions;
+	if (data.time.logged_today_minutes === 0 && data.time.entries_today === 0) suggestions.push("⚠️ No time logged today");
+	if (data.timers && data.timers.length > 0) {
+		for (const timer of data.timers) if (timer.total_time > 120) {
+			const hours = +(timer.total_time / 60).toFixed(1);
+			suggestions.push(`⏱️ Timer running for ${hours}h — remember to stop it`);
+		}
+	}
+	return suggestions;
+}
+/**
+* Helper to create a successful JSON response
+*/
+function jsonResult(data) {
+	return { content: [{
+		type: "text",
+		text: JSON.stringify(data, null, 2)
+	}] };
+}
+/**
+* Helper to create an error response from a string message
+*/
+function errorResult(message) {
+	return {
+		content: [{
+			type: "text",
+			text: `**Error:** ${message}`
+		}],
+		isError: true
+	};
+}
+/**
+* Helper to create an error response from a UserInputError
+* Includes formatted hints for LLM consumption
+*/
+function inputErrorResult(error) {
+	return {
+		content: [{
+			type: "text",
+			text: error.toFormattedMessage()
+		}],
+		isError: true
+	};
+}
+/**
+* Helper to create an error response from any error type
+* Automatically formats UserInputError with hints
+*/
+function formatError(error) {
+	if (isUserInputError(error)) return inputErrorResult(error);
+	return errorResult(error instanceof Error ? error.message : String(error));
+}
+/**
+* Convert unknown filter to string filter for API
+*/
+function toStringFilter(filter) {
+	if (!filter) return void 0;
+	const result = {};
+	for (const [key, value] of Object.entries(filter)) if (value !== void 0 && value !== null) result[key] = String(value);
+	return Object.keys(result).length > 0 ? result : void 0;
+}
+/**
+* Resolve handler for MCP.
+*
+* Thin wrapper around core's resource resolver.
+* Provides handleResolve for the MCP 'resolve' action.
+*/
+/**
+* Handle resolve action for a resource.
+*
+* Delegates to core's resolveResource function and wraps
+* errors in MCP-friendly format.
+*/
+async function handleResolve(args, ctx) {
+	const { query, type, project_id } = args;
+	if (!query) return errorResult("query is required for resolve action");
+	try {
+		const results = await resolveResource(ctx.executor().api, query, {
+			type,
+			projectId: project_id
+		});
+		return jsonResult({
+			query,
+			matches: results,
+			exact: results.length === 1 && results[0].exact
+		});
+	} catch (error) {
+		if (error instanceof ResolveError) return inputErrorResult(new UserInputError(error.message, [`Query: "${error.query}"`, ...error.type ? [`Type: ${error.type}`] : []]));
+		throw error;
+	}
+}
+/**
+* Merge user includes with defaults, ensuring no duplicates
+*/
+function mergeIncludes(userInclude, defaults) {
+	if (!userInclude?.length && !defaults?.length) return void 0;
+	if (!userInclude?.length) return defaults;
+	if (!defaults?.length) return userInclude;
+	return [...new Set([...defaults, ...userInclude])];
+}
+/**
+* Create a resource handler function from configuration.
+*
+* @example
+* ```typescript
+* export const handleProjects = createResourceHandler({
+*   resource: 'projects',
+*   actions: ['list', 'get', 'resolve'],
+*   formatter: formatProject,
+*   hints: (data, id) => getProjectHints(id),
+*   supportsResolve: true,
+*   executors: {
+*     list: listProjects,
+*     get: getProject,
+*   },
+* });
+* ```
+*/
+function createResourceHandler(config) {
+	const { resource, displayName = resource, actions, formatter, hints, defaultInclude, supportsResolve, listFilterFromArgs, resolveArgsFromArgs, customActions, create: createConfig, update: updateConfig, executors } = config;
+	return async (action, args, ctx) => {
+		const { formatOptions, filter, page, perPage, include: userInclude } = ctx;
+		const { id, query, type } = args;
+		const execCtx = ctx.executor();
+		if (customActions?.[action]) return customActions[action](args, ctx, execCtx);
+		if (action === "resolve") {
+			if (!supportsResolve) return inputErrorResult(ErrorMessages.invalidAction(action, resource, actions));
+			return handleResolve({
+				query,
+				type,
+				...resolveArgsFromArgs?.(args)
+			}, ctx);
+		}
+		if (action === "get") {
+			if (!executors.get) return inputErrorResult(ErrorMessages.invalidAction(action, resource, actions));
+			if (!id) return inputErrorResult(ErrorMessages.missingId("get"));
+			const include = mergeIncludes(userInclude, defaultInclude?.get);
+			const result = await executors.get({
+				id,
+				include
+			}, execCtx);
+			const getResponseData = { ...formatter(result.data, {
+				...formatOptions,
+				included: result.included
+			}) };
+			if (ctx.includeHints) {
+				if (hints) getResponseData._hints = hints(result.data, id);
+			}
+			if (ctx.includeSuggestions !== false) {
+				let getSuggestions = [];
+				if (resource === "tasks") getSuggestions = getTaskGetSuggestions(result.data, result.included);
+				if (getSuggestions.length > 0) getResponseData._suggestions = getSuggestions;
+			}
+			return jsonResult(getResponseData);
+		}
+		if (action === "create") {
+			if (!executors.create || !createConfig) return inputErrorResult(ErrorMessages.invalidAction(action, resource, actions));
+			const missingFields = createConfig.required.filter((field) => !args[field]);
+			if (missingFields.length > 0) return inputErrorResult(ErrorMessages.missingRequiredFields(displayName, missingFields));
+			if (createConfig.validateArgs) {
+				const errorResult = createConfig.validateArgs(args);
+				if (errorResult) return errorResult;
+			}
+			const options = createConfig.mapOptions(args);
+			return jsonResult({
+				success: true,
+				...formatter((await executors.create(options, execCtx)).data, formatOptions)
+			});
+		}
+		if (action === "update") {
+			if (!executors.update || !updateConfig) return inputErrorResult(ErrorMessages.invalidAction(action, resource, actions));
+			if (!id) return inputErrorResult(ErrorMessages.missingId("update"));
+			if (updateConfig.allowedFields && updateConfig.allowedFields.length > 0) {
+				if (!updateConfig.allowedFields.some((field) => args[field] !== void 0)) return inputErrorResult(ErrorMessages.noUpdateFieldsSpecified(updateConfig.allowedFields));
+			}
+			const options = {
+				id,
+				...updateConfig.mapOptions(args)
+			};
+			return jsonResult({
+				success: true,
+				...formatter((await executors.update(options, execCtx)).data, formatOptions)
+			});
+		}
+		if (action === "delete") {
+			if (!executors.delete) return inputErrorResult(ErrorMessages.invalidAction(action, resource, actions));
+			if (!id) return inputErrorResult(ErrorMessages.missingId("delete"));
+			await executors.delete({ id }, execCtx);
+			return jsonResult({
+				success: true,
+				deleted: id
+			});
+		}
+		if (action === "list") {
+			const include = mergeIncludes(userInclude, defaultInclude?.list);
+			const additionalFilters = {
+				...filter,
+				...listFilterFromArgs?.(args)
+			};
+			const result = await executors.list({
+				page,
+				perPage,
+				additionalFilters,
+				include
+			}, execCtx);
+			const listResponseData = { ...formatListResponse$1(result.data, formatter, result.meta, {
+				...formatOptions,
+				included: result.included
+			}) };
+			if (result.resolved && Object.keys(result.resolved).length > 0) listResponseData._resolved = result.resolved;
+			if (ctx.includeSuggestions !== false) {
+				let listSuggestions = [];
+				if (resource === "tasks") listSuggestions = getTaskListSuggestions(result.data);
+				else if (resource === "time") listSuggestions = getTimeListSuggestions(result.data, additionalFilters);
+				if (listSuggestions.length > 0) listResponseData._suggestions = listSuggestions;
+			}
+			return jsonResult(listResponseData);
+		}
+		return inputErrorResult(ErrorMessages.invalidAction(action, resource, actions));
+	};
+}
+/**
+* Activities MCP handler.
+*
+* Uses the createResourceHandler factory for the common list pattern.
+* Activities are read-only — only `list` is supported.
+*/
+/**
+* Handle activities resource.
+*
+* Supports: list
+*/
+const handleActivities = createResourceHandler({
+	resource: "activities",
+	actions: ["list"],
+	formatter: formatActivity$1,
+	executors: { list: listActivities },
+	defaultInclude: { list: ["creator"] },
+	listFilterFromArgs: (args) => {
+		const filter = {};
+		if (args.after) filter.after = args.after;
+		if (args.event) filter.event = args.event;
+		return filter;
+	}
+});
+/**
 * Generate hints for a task
 */
 function getTaskHints(taskId, serviceId) {
@@ -470,6 +807,25 @@ function getPersonHints(personId) {
 	] };
 }
 /**
+* Generate hints for a services list response.
+*
+* When the query doesn't already filter by deal_id, suggests filtering
+* by deal_id to scope services to a specific budget/deal.
+*
+* @param currentFilter - The filter object currently applied to the list query
+*/
+function getServiceListHints(currentFilter) {
+	if (currentFilter?.deal_id) return null;
+	return { common_actions: [{
+		action: "Filter services by deal to see budget line items for a specific deal",
+		example: {
+			resource: "services",
+			action: "list",
+			filter: { deal_id: "<deal_id>" }
+		}
+	}] };
+}
+/**
 * Generate hints for a company
 */
 function getCompanyHints(companyId) {
@@ -724,240 +1080,36 @@ function getDiscussionHints(discussionId, pageId) {
 		example: {
 			resource: "pages",
 			action: "get",
-			id: pageId
-		}
-	});
-	return hints;
-}
-/**
-* Generate hints for a timer
-*/
-function getTimerHints(timerId, serviceId) {
-	const hints = {
-		common_actions: [{
-			action: "Stop this timer",
-			example: {
-				resource: "timers",
-				action: "stop",
-				id: timerId
-			}
-		}],
-		related_resources: []
-	};
-	if (serviceId) hints.related_resources.push({
-		resource: "services",
-		description: "Get the service this timer is running on",
-		example: {
-			resource: "services",
-			action: "get",
-			id: serviceId
-		}
-	});
-	return hints;
-}
-/**
-* Helper to create a successful JSON response
-*/
-function jsonResult(data) {
-	return { content: [{
-		type: "text",
-		text: JSON.stringify(data, null, 2)
-	}] };
-}
-/**
-* Helper to create an error response from a string message
-*/
-function errorResult(message) {
-	return {
-		content: [{
-			type: "text",
-			text: `**Error:** ${message}`
-		}],
-		isError: true
-	};
-}
-/**
-* Helper to create an error response from a UserInputError
-* Includes formatted hints for LLM consumption
-*/
-function inputErrorResult(error) {
-	return {
-		content: [{
-			type: "text",
-			text: error.toFormattedMessage()
-		}],
-		isError: true
-	};
-}
-/**
-* Helper to create an error response from any error type
-* Automatically formats UserInputError with hints
-*/
-function formatError(error) {
-	if (isUserInputError(error)) return inputErrorResult(error);
-	return errorResult(error instanceof Error ? error.message : String(error));
-}
-/**
-* Convert unknown filter to string filter for API
-*/
-function toStringFilter(filter) {
-	if (!filter) return void 0;
-	const result = {};
-	for (const [key, value] of Object.entries(filter)) if (value !== void 0 && value !== null) result[key] = String(value);
-	return Object.keys(result).length > 0 ? result : void 0;
-}
-/**
-* Resolve handler for MCP.
-*
-* Thin wrapper around core's resource resolver.
-* Provides handleResolve for the MCP 'resolve' action.
-*/
-/**
-* Handle resolve action for a resource.
-*
-* Delegates to core's resolveResource function and wraps
-* errors in MCP-friendly format.
-*/
-async function handleResolve(args, ctx) {
-	const { query, type, project_id } = args;
-	if (!query) return errorResult("query is required for resolve action");
-	try {
-		const results = await resolveResource(ctx.executor().api, query, {
-			type,
-			projectId: project_id
-		});
-		return jsonResult({
-			query,
-			matches: results,
-			exact: results.length === 1 && results[0].exact
-		});
-	} catch (error) {
-		if (error instanceof ResolveError) return inputErrorResult(new UserInputError(error.message, [`Query: "${error.query}"`, ...error.type ? [`Type: ${error.type}`] : []]));
-		throw error;
-	}
-}
-/**
-* Merge user includes with defaults, ensuring no duplicates
-*/
-function mergeIncludes(userInclude, defaults) {
-	if (!userInclude?.length && !defaults?.length) return void 0;
-	if (!userInclude?.length) return defaults;
-	if (!defaults?.length) return userInclude;
-	return [...new Set([...defaults, ...userInclude])];
-}
-/**
-* Create a resource handler function from configuration.
-*
-* @example
-* ```typescript
-* export const handleProjects = createResourceHandler({
-*   resource: 'projects',
-*   actions: ['list', 'get', 'resolve'],
-*   formatter: formatProject,
-*   hints: (data, id) => getProjectHints(id),
-*   supportsResolve: true,
-*   executors: {
-*     list: listProjects,
-*     get: getProject,
-*   },
-* });
-* ```
-*/
-function createResourceHandler(config) {
-	const { resource, displayName = resource, actions, formatter, hints, defaultInclude, supportsResolve, listFilterFromArgs, resolveArgsFromArgs, customActions, create: createConfig, update: updateConfig, executors } = config;
-	return async (action, args, ctx) => {
-		const { formatOptions, filter, page, perPage, include: userInclude } = ctx;
-		const { id, query, type } = args;
-		const execCtx = ctx.executor();
-		if (customActions?.[action]) return customActions[action](args, ctx, execCtx);
-		if (action === "resolve") {
-			if (!supportsResolve) return inputErrorResult(ErrorMessages.invalidAction(action, resource, actions));
-			return handleResolve({
-				query,
-				type,
-				...resolveArgsFromArgs?.(args)
-			}, ctx);
-		}
-		if (action === "get") {
-			if (!executors.get) return inputErrorResult(ErrorMessages.invalidAction(action, resource, actions));
-			if (!id) return inputErrorResult(ErrorMessages.missingId("get"));
-			const include = mergeIncludes(userInclude, defaultInclude?.get);
-			const result = await executors.get({
-				id,
-				include
-			}, execCtx);
-			const formatted = formatter(result.data, {
-				...formatOptions,
-				included: result.included
-			});
-			if (ctx.includeHints !== false && hints) return jsonResult({
-				...formatted,
-				_hints: hints(result.data, id)
-			});
-			return jsonResult(formatted);
-		}
-		if (action === "create") {
-			if (!executors.create || !createConfig) return inputErrorResult(ErrorMessages.invalidAction(action, resource, actions));
-			const missingFields = createConfig.required.filter((field) => !args[field]);
-			if (missingFields.length > 0) return inputErrorResult(ErrorMessages.missingRequiredFields(displayName, missingFields));
-			if (createConfig.validateArgs) {
-				const errorResult = createConfig.validateArgs(args);
-				if (errorResult) return errorResult;
-			}
-			const options = createConfig.mapOptions(args);
-			return jsonResult({
-				success: true,
-				...formatter((await executors.create(options, execCtx)).data, formatOptions)
-			});
+			id: pageId
 		}
-		if (action === "update") {
-			if (!executors.update || !updateConfig) return inputErrorResult(ErrorMessages.invalidAction(action, resource, actions));
-			if (!id) return inputErrorResult(ErrorMessages.missingId("update"));
-			if (updateConfig.allowedFields && updateConfig.allowedFields.length > 0) {
-				if (!updateConfig.allowedFields.some((field) => args[field] !== void 0)) return inputErrorResult(ErrorMessages.noUpdateFieldsSpecified(updateConfig.allowedFields));
+	});
+	return hints;
+}
+/**
+* Generate hints for a timer
+*/
+function getTimerHints(timerId, serviceId) {
+	const hints = {
+		common_actions: [{
+			action: "Stop this timer",
+			example: {
+				resource: "timers",
+				action: "stop",
+				id: timerId
 			}
-			const options = {
-				id,
-				...updateConfig.mapOptions(args)
-			};
-			return jsonResult({
-				success: true,
-				...formatter((await executors.update(options, execCtx)).data, formatOptions)
-			});
-		}
-		if (action === "delete") {
-			if (!executors.delete) return inputErrorResult(ErrorMessages.invalidAction(action, resource, actions));
-			if (!id) return inputErrorResult(ErrorMessages.missingId("delete"));
-			await executors.delete({ id }, execCtx);
-			return jsonResult({
-				success: true,
-				deleted: id
-			});
-		}
-		if (action === "list") {
-			const include = mergeIncludes(userInclude, defaultInclude?.list);
-			const additionalFilters = {
-				...filter,
-				...listFilterFromArgs?.(args)
-			};
-			const result = await executors.list({
-				page,
-				perPage,
-				additionalFilters,
-				include
-			}, execCtx);
-			const response = formatListResponse$1(result.data, formatter, result.meta, {
-				...formatOptions,
-				included: result.included
-			});
-			if (result.resolved && Object.keys(result.resolved).length > 0) return jsonResult({
-				...response,
-				_resolved: result.resolved
-			});
-			return jsonResult(response);
-		}
-		return inputErrorResult(ErrorMessages.invalidAction(action, resource, actions));
+		}],
+		related_resources: []
 	};
+	if (serviceId) hints.related_resources.push({
+		resource: "services",
+		description: "Get the service this timer is running on",
+		example: {
+			resource: "services",
+			action: "get",
+			id: serviceId
+		}
+	});
+	return hints;
 }
 /**
 * Attachments MCP handler.
@@ -1238,7 +1390,8 @@ const handleDeals = createResourceHandler({
 		"get",
 		"create",
 		"update",
-		"resolve"
+		"resolve",
+		"context"
 	],
 	formatter: formatDeal$1,
 	hints: (_data, id) => getDealHints(id),
@@ -1259,6 +1412,20 @@ const handleDeals = createResourceHandler({
 		})
 	},
 	update: { mapOptions: (args) => ({ name: args.name }) },
+	customActions: { context: async (args, ctx, execCtx) => {
+		if (!args.id) return inputErrorResult(ErrorMessages.missingId("context"));
+		const result = await getDealContext({ id: args.id }, execCtx);
+		const formatOptions = {
+			...ctx.formatOptions,
+			included: result.included
+		};
+		return jsonResult({
+			...formatDeal$1(result.data.deal, formatOptions),
+			services: result.data.services.map((s) => formatService$1(s, { compact: true })),
+			comments: result.data.comments.map((c) => formatComment$1(c, { compact: true })),
+			time_entries: result.data.time_entries.map((t) => formatTimeEntry$1(t, { compact: true }))
+		});
+	} },
 	executors: {
 		list: listDeals,
 		get: getDeal,
@@ -1389,7 +1556,8 @@ var RESOURCE_HELP = {
 		actions: {
 			list: "List all projects with optional filters",
 			get: "Get a single project by ID (supports PRJ-123, P-123 format)",
-			resolve: "Resolve by project number (PRJ-123, P-123)"
+			resolve: "Resolve by project number (PRJ-123, P-123)",
+			context: "Get full project context in one call: project details + open tasks + services + recent time entries"
 		},
 		filters: {
 			query: "Text search on project name",
@@ -1430,6 +1598,14 @@ var RESOURCE_HELP = {
 					action: "get",
 					id: "12345"
 				}
+			},
+			{
+				description: "Get full project context",
+				params: {
+					resource: "projects",
+					action: "context",
+					id: "12345"
+				}
 			}
 		]
 	},
@@ -1440,7 +1616,8 @@ var RESOURCE_HELP = {
 			get: "Get a single task by ID with full details (description, comments, etc.)",
 			create: "Create a new task (requires title, project_id, task_list_id)",
 			update: "Update an existing task",
-			resolve: "Resolve by text search"
+			resolve: "Resolve by text search",
+			context: "Get full task context in one call: task details + comments + time entries + subtasks"
 		},
 		filters: {
 			query: "Text search on task title",
@@ -1516,6 +1693,14 @@ var RESOURCE_HELP = {
 					project_id: "12345",
 					task_list_id: "111"
 				}
+			},
+			{
+				description: "Get full task context",
+				params: {
+					resource: "tasks",
+					action: "context",
+					id: "67890"
+				}
 			}
 		]
 	},
@@ -1596,6 +1781,13 @@ var RESOURCE_HELP = {
 			worked_time: "Logged time in minutes"
 		},
 		examples: [{
+			description: "List services for a deal (budget line items)",
+			params: {
+				resource: "services",
+				action: "list",
+				filter: { deal_id: "12345" }
+			}
+		}, {
 			description: "List services for a project",
 			params: {
 				resource: "services",
@@ -1833,7 +2025,8 @@ var RESOURCE_HELP = {
 			get: "Get a single deal by ID (supports D-123, DEAL-123 format)",
 			create: "Create a new deal (requires name, company_id)",
 			update: "Update an existing deal",
-			resolve: "Resolve by deal number (D-123, DEAL-123)"
+			resolve: "Resolve by deal number (D-123, DEAL-123)",
+			context: "Get full deal context in one call: deal details + services + comments + time entries"
 		},
 		filters: {
 			query: "Text search on deal name",
@@ -1883,6 +2076,14 @@ var RESOURCE_HELP = {
 					action: "list",
 					filter: { type: "2" }
 				}
+			},
+			{
+				description: "Get full deal context",
+				params: {
+					resource: "deals",
+					action: "context",
+					id: "12345"
+				}
 			}
 		]
 	},
@@ -2061,6 +2262,137 @@ var RESOURCE_HELP = {
 			}
 		]
 	},
+	workflows: {
+		description: "Compound workflows that chain multiple resource operations into a single tool call. Use these for common multi-step patterns.",
+		actions: {
+			complete_task: "Mark a task closed, optionally post a comment, and stop running timers",
+			log_day: "Create multiple time entries in parallel from a structured list",
+			weekly_standup: "Aggregate completed tasks, time logged, and upcoming deadlines for a week"
+		},
+		fields: {
+			task_id: "(complete_task) Required. Task ID to mark as complete",
+			comment: "(complete_task) Optional. Completion comment text to post",
+			stop_timer: "(complete_task) Optional. Whether to stop running timers (default: true)",
+			entries: "(log_day) Required. Array of { project_id, service_id, duration_minutes, note?, date? }",
+			date: "(log_day) Optional. Default date for all entries (YYYY-MM-DD, defaults to today)",
+			person_id: "(log_day / weekly_standup) Optional. Person to act on (defaults to current user)",
+			week_start: "(weekly_standup) Optional. Monday date of the target week (defaults to this Monday)"
+		},
+		examples: [
+			{
+				description: "Complete a task with a comment",
+				params: {
+					resource: "workflows",
+					action: "complete_task",
+					task_id: "12345",
+					comment: "Done! All tests passing."
+				}
+			},
+			{
+				description: "Complete a task without stopping timers",
+				params: {
+					resource: "workflows",
+					action: "complete_task",
+					task_id: "12345",
+					stop_timer: false
+				}
+			},
+			{
+				description: "Log a full day across multiple projects",
+				params: {
+					resource: "workflows",
+					action: "log_day",
+					date: "2024-01-16",
+					entries: [
+						{
+							project_id: "100",
+							service_id: "111",
+							duration_minutes: 240,
+							note: "Frontend dev"
+						},
+						{
+							project_id: "200",
+							service_id: "222",
+							duration_minutes: 120,
+							note: "Code review"
+						},
+						{
+							project_id: "100",
+							service_id: "333",
+							duration_minutes: 60,
+							note: "Meetings"
+						}
+					]
+				}
+			},
+			{
+				description: "Get this week standup",
+				params: {
+					resource: "workflows",
+					action: "weekly_standup"
+				}
+			},
+			{
+				description: "Get standup for a specific past week",
+				params: {
+					resource: "workflows",
+					action: "weekly_standup",
+					week_start: "2024-01-15"
+				}
+			}
+		]
+	},
+	activities: {
+		description: "Read-only activity feed — audit log of create/update/delete events across the organization",
+		actions: { list: "List recent activities with optional filters" },
+		filters: {
+			event: "Filter by event type: create, update, delete",
+			after: "Filter to activities after this ISO 8601 timestamp (e.g. 2026-01-01T00:00:00Z)",
+			person_id: "Filter by creator person ID",
+			project_id: "Filter by project ID"
+		},
+		includes: ["creator"],
+		fields: {
+			id: "Unique activity identifier",
+			event: "Event type: create, update, or delete",
+			changeset: "Human-readable summary of field changes (e.g. \"name: null → My Project\")",
+			created_at: "When the activity occurred (ISO 8601)",
+			creator_name: "Full name of the person who triggered the activity (when creator included)"
+		},
+		examples: [
+			{
+				description: "List recent activities",
+				params: {
+					resource: "activities",
+					action: "list"
+				}
+			},
+			{
+				description: "List only create events",
+				params: {
+					resource: "activities",
+					action: "list",
+					filter: { event: "create" }
+				}
+			},
+			{
+				description: "List activities after a date",
+				params: {
+					resource: "activities",
+					action: "list",
+					filter: { after: "2026-02-01T00:00:00Z" }
+				}
+			},
+			{
+				description: "List activities by a specific person",
+				params: {
+					resource: "activities",
+					action: "list",
+					filter: { person_id: "12345" }
+				}
+			}
+		]
+	},
 	reports: {
 		description: "Generate various reports (time, budget, project, etc.)",
 		actions: { get: "Generate a report (requires report_type)" },
@@ -2173,7 +2505,7 @@ const handlePages = createResourceHandler({
 /**
 * People MCP handler.
 */
-var VALID_ACTIONS$1 = [
+var VALID_ACTIONS$3 = [
 	"list",
 	"get",
 	"me",
@@ -2224,7 +2556,7 @@ async function handlePeople(action, args, ctx, credentials) {
 		});
 		return jsonResult(response);
 	}
-	return inputErrorResult(ErrorMessages.invalidAction(action, "people", VALID_ACTIONS$1));
+	return inputErrorResult(ErrorMessages.invalidAction(action, "people", VALID_ACTIONS$3));
 }
 /**
 * Projects MCP handler.
@@ -2234,18 +2566,36 @@ async function handlePeople(action, args, ctx, credentials) {
 /**
 * Handle projects resource.
 *
-* Supports: list, get, resolve
+* Supports: list, get, resolve, context
 */
 const handleProjects = createResourceHandler({
 	resource: "projects",
 	actions: [
 		"list",
 		"get",
-		"resolve"
+		"resolve",
+		"context"
 	],
 	formatter: formatProject$1,
 	hints: (_data, id) => getProjectHints(id),
 	supportsResolve: true,
+	customActions: { context: async (args, ctx, execCtx) => {
+		if (!args.id) return inputErrorResult(ErrorMessages.missingId("context"));
+		const result = await getProjectContext({ id: args.id }, execCtx);
+		const formatOptions = {
+			...ctx.formatOptions,
+			included: result.included
+		};
+		return jsonResult({
+			...formatProject$1(result.data.project, ctx.formatOptions),
+			tasks: result.data.tasks.map((t) => formatTask$1(t, {
+				...formatOptions,
+				compact: true
+			})),
+			services: result.data.services.map((s) => formatService$1(s, { compact: true })),
+			time_entries: result.data.time_entries.map((t) => formatTimeEntry$1(t, { compact: true }))
+		});
+	} },
 	executors: {
 		list: listProjects,
 		get: getProject
@@ -2264,11 +2614,11 @@ function formatReportData(data) {
 		};
 	});
 }
-var VALID_ACTIONS = ["get"];
+var VALID_ACTIONS$2 = ["get"];
 async function handleReports(action, args, ctx) {
 	const { filter, page, perPage } = ctx;
 	const { report_type, group, from, to, person_id, project_id, company_id, deal_id, status } = args;
-	if (action !== "get") return inputErrorResult(ErrorMessages.invalidAction(action, "reports", VALID_ACTIONS));
+	if (action !== "get") return inputErrorResult(ErrorMessages.invalidAction(action, "reports", VALID_ACTIONS$2));
 	if (!report_type) return inputErrorResult(ErrorMessages.missingReportType());
 	if (!VALID_REPORT_TYPES.includes(report_type)) return inputErrorResult(ErrorMessages.invalidReportType(report_type, [...VALID_REPORT_TYPES]));
 	const execCtx = ctx.executor();
@@ -2753,9 +3103,104 @@ const handleServices = createResourceHandler({
 	resource: "services",
 	actions: ["list"],
 	formatter: formatService$1,
-	executors: { list: listServices }
+	executors: { list: listServices },
+	customActions: { list: async (args, ctx, execCtx) => {
+		const { formatOptions, filter, page, perPage } = ctx;
+		const additionalFilters = { ...filter };
+		const result = await listServices({
+			page,
+			perPage,
+			additionalFilters
+		}, execCtx);
+		const response = formatListResponse$1(result.data, formatService$1, result.meta, {
+			...formatOptions,
+			included: result.included
+		});
+		const hints = getServiceListHints(additionalFilters);
+		if (hints) return jsonResult({
+			...response,
+			_hints: hints
+		});
+		return jsonResult(response);
+	} }
 });
 /**
+* Summaries MCP handler.
+*
+* Custom handler for dashboard-style summaries (not using createResourceHandler).
+* Routes actions to the appropriate summary executor.
+*/
+var VALID_ACTIONS$1 = [
+	"my_day",
+	"project_health",
+	"team_pulse",
+	"help"
+];
+/**
+* Handle summaries resource.
+*
+* Supports: my_day, project_health, team_pulse
+*/
+async function handleSummaries(action, args, ctx) {
+	if (!VALID_ACTIONS$1.includes(action)) return inputErrorResult(ErrorMessages.invalidAction(action, "summaries", VALID_ACTIONS$1));
+	const execCtx = ctx.executor();
+	switch (action) {
+		case "my_day": {
+			const result = await getMyDaySummary({}, execCtx);
+			if (ctx.includeSuggestions !== false) {
+				const suggestions = getMyDaySuggestions(result.data);
+				if (suggestions.length > 0) return jsonResult({
+					...result.data,
+					_suggestions: suggestions
+				});
+			}
+			return jsonResult(result.data);
+		}
+		case "project_health":
+			if (!args.project_id) return inputErrorResult(new UserInputError("project_id is required for project_health summary", [
+				"Provide the project_id parameter",
+				"You can find project IDs using resource=\"projects\" action=\"list\"",
+				"Or use a project number like \"PRJ-123\""
+			]));
+			return jsonResult((await getProjectHealthSummary({ projectId: args.project_id }, execCtx)).data);
+		case "team_pulse": return jsonResult((await getTeamPulseSummary({}, execCtx)).data);
+		case "help": return jsonResult({
+			resource: "summaries",
+			description: "Dashboard-style summaries that aggregate data from multiple resources",
+			actions: {
+				my_day: {
+					description: "Personal dashboard for the current user",
+					parameters: {},
+					returns: {
+						tasks: "Open and overdue tasks assigned to you",
+						time: "Time entries logged today",
+						timers: "Currently running timers"
+					}
+				},
+				project_health: {
+					description: "Project status with budget burn and task stats",
+					parameters: { project_id: "Required. Project ID or project number (e.g., PRJ-123)" },
+					returns: {
+						project: "Project details",
+						tasks: "Open and overdue task counts",
+						budget: "Budget burn rate by service",
+						recent_activity: "Time tracking activity in last 7 days"
+					}
+				},
+				team_pulse: {
+					description: "Team-wide time tracking activity for today",
+					parameters: {},
+					returns: {
+						team: "Counts of active users, those tracking time, and with timers",
+						people: "Per-person breakdown of time logged and active timers"
+					}
+				}
+			}
+		});
+		default: return inputErrorResult(ErrorMessages.invalidAction(action, "summaries", VALID_ACTIONS$1));
+	}
+}
+/**
 * Tasks MCP handler.
 */
 const handleTasks = createResourceHandler({
@@ -2766,7 +3211,8 @@ const handleTasks = createResourceHandler({
 		"get",
 		"create",
 		"update",
-		"resolve"
+		"resolve",
+		"context"
 	],
 	formatter: formatTask$1,
 	hints: (data, id) => {
@@ -2798,6 +3244,23 @@ const handleTasks = createResourceHandler({
 		description: args.description,
 		assigneeId: args.assignee_id
 	}) },
+	customActions: { context: async (args, ctx, execCtx) => {
+		if (!args.id) return inputErrorResult(ErrorMessages.missingId("context"));
+		const result = await getTaskContext({ id: args.id }, execCtx);
+		const formatOptions = {
+			...ctx.formatOptions,
+			included: result.included
+		};
+		return jsonResult({
+			...formatTask$1(result.data.task, formatOptions),
+			comments: result.data.comments.map((c) => formatComment$1(c, { compact: true })),
+			time_entries: result.data.time_entries.map((t) => formatTimeEntry$1(t, { compact: true })),
+			subtasks: result.data.subtasks.map((s) => formatTask$1(s, {
+				...formatOptions,
+				compact: true
+			}))
+		});
+	} },
 	executors: {
 		list: listTasks,
 		get: getTask,
@@ -2829,23 +3292,28 @@ const handleTime = createResourceHandler({
 	},
 	supportsResolve: true,
 	resolveArgsFromArgs: (args) => ({ project_id: args.project_id }),
-	create: {
-		required: [
-			"person_id",
+	customActions: { create: async (args, ctx, execCtx) => {
+		const missingFields = [
 			"service_id",
 			"time",
 			"date"
-		],
-		mapOptions: (args) => ({
-			personId: args.person_id,
-			serviceId: args.service_id,
-			time: args.time,
-			date: args.date,
-			note: args.note ?? void 0,
-			taskId: args.task_id,
-			projectId: args.project_id
-		})
-	},
+		].filter((field) => !args[field]);
+		if (missingFields.length > 0) return inputErrorResult(ErrorMessages.missingRequiredFields("time entry", missingFields));
+		const personId = args.person_id ?? execCtx.config.userId;
+		if (!personId) return inputErrorResult(new UserInputError("person_id is required (could not auto-resolve: userId not configured)", ["Provide person_id explicitly", "Or configure userId in your credentials"]));
+		return jsonResult({
+			success: true,
+			...formatTimeEntry$1((await createTimeEntry({
+				personId,
+				serviceId: args.service_id,
+				time: args.time,
+				date: args.date,
+				note: args.note ?? void 0,
+				taskId: args.task_id,
+				projectId: args.project_id
+			}, execCtx)).data, ctx.formatOptions)
+		});
+	} },
 	update: { mapOptions: (args) => ({
 		time: args.time ?? void 0,
 		date: args.date ?? void 0,
@@ -2907,6 +3375,191 @@ const handleTimers = createResourceHandler({
 	}
 });
 /**
+* Valid include values per resource.
+*
+* Sourced from help.ts and schema.ts include lists.
+* Resources not listed here have no include validation (pass-through).
+*/
+const VALID_INCLUDES = {
+	activities: ["creator"],
+	tasks: [
+		"project",
+		"project.company",
+		"assignee",
+		"workflow_status",
+		"comments",
+		"attachments",
+		"subtasks"
+	],
+	comments: [
+		"creator",
+		"task",
+		"deal"
+	],
+	deals: [
+		"company",
+		"deal_status",
+		"responsible",
+		"project"
+	],
+	bookings: [
+		"person",
+		"service",
+		"event"
+	],
+	time: [
+		"person",
+		"service",
+		"task"
+	]
+};
+/**
+* Known misleading include values and their suggestions.
+* These are values that agents commonly try that don't exist.
+*/
+var KNOWN_SUGGESTIONS = {
+	notes: "Use resource=comments to fetch comments on a resource",
+	services: "Use resource=services with filter.deal_id or filter.project_id to list services",
+	time_entries: "Use resource=time with a filter (e.g. filter.task_id, filter.project_id) to list time entries",
+	time: "Use resource=time with a filter (e.g. filter.task_id) to list time entries",
+	user: "Use \"assignee\" or \"person\" instead",
+	author: "Use \"creator\" instead",
+	owner: "Use \"responsible\" or \"assignee\" instead",
+	company: "Use \"project.company\" to include the project's company on tasks",
+	status: "Use \"workflow_status\" to include the workflow/kanban status on tasks"
+};
+/**
+* Validate include values for a given resource.
+*
+* Returns the valid and invalid values, plus suggestions for invalid values.
+* If the resource is not in VALID_INCLUDES, skips validation (returns all as valid).
+*/
+function validateIncludes(resource, includes) {
+	const validSet = VALID_INCLUDES[resource];
+	if (!validSet) return null;
+	const valid = [];
+	const invalid = [];
+	const suggestions = {};
+	for (const inc of includes) if (validSet.includes(inc)) valid.push(inc);
+	else {
+		invalid.push(inc);
+		if (KNOWN_SUGGESTIONS[inc]) suggestions[inc] = KNOWN_SUGGESTIONS[inc];
+		else suggestions[inc] = `Valid includes for ${resource}: ${validSet.join(", ")}`;
+	}
+	return {
+		valid,
+		invalid,
+		suggestions
+	};
+}
+/**
+* Workflows MCP handler.
+*
+* Custom handler for compound workflows that chain multiple executors.
+* NOT using createResourceHandler — standalone routing like summaries.ts.
+*
+* Supported actions:
+* - complete_task: Mark task closed, optionally comment and stop timers
+* - log_day: Create multiple time entries in parallel from a structured list
+* - weekly_standup: Aggregate completed tasks, time logged, and upcoming deadlines
+*/
+var VALID_ACTIONS = [
+	"complete_task",
+	"log_day",
+	"weekly_standup",
+	"help"
+];
+/**
+* Handle workflows resource.
+*
+* Supports: complete_task, log_day, weekly_standup
+*/
+async function handleWorkflows(action, args, ctx) {
+	if (!VALID_ACTIONS.includes(action)) return inputErrorResult(ErrorMessages.invalidAction(action, "workflows", VALID_ACTIONS));
+	const execCtx = ctx.executor();
+	switch (action) {
+		case "complete_task":
+			if (!args.task_id) return inputErrorResult(new UserInputError("task_id is required for complete_task workflow", ["Provide the task_id parameter (numeric task ID)", "You can find task IDs using resource=\"tasks\" action=\"list\""]));
+			return jsonResult((await completeTask({
+				taskId: args.task_id,
+				comment: args.comment,
+				stopTimer: args.stop_timer
+			}, execCtx)).data);
+		case "log_day":
+			if (!args.entries || !Array.isArray(args.entries) || args.entries.length === 0) return inputErrorResult(new UserInputError("entries is required and must be a non-empty array for log_day workflow", [
+				"Provide entries as an array of { project_id, service_id, duration_minutes, note?, date? }",
+				"Example: { \"entries\": [{ \"project_id\": \"123\", \"service_id\": \"456\", \"duration_minutes\": 120, \"note\": \"Development\" }] }",
+				"You can find service IDs using resource=\"services\" action=\"list\" with filter.project_id"
+			]));
+			return jsonResult((await logDay({
+				entries: args.entries.map((e) => {
+					const entry = e;
+					return {
+						project_id: String(entry.project_id),
+						service_id: String(entry.service_id),
+						duration_minutes: Number(entry.duration_minutes),
+						note: entry.note != null ? String(entry.note) : void 0,
+						date: entry.date != null ? String(entry.date) : void 0
+					};
+				}),
+				date: args.date,
+				personId: args.person_id
+			}, execCtx)).data);
+		case "weekly_standup": return jsonResult((await weeklyStandup({
+			personId: args.person_id,
+			weekStart: args.week_start
+		}, execCtx)).data);
+		case "help": return jsonResult({
+			resource: "workflows",
+			description: "Compound workflows that chain multiple resource operations into a single tool call",
+			actions: {
+				complete_task: {
+					description: "Mark a task as complete, optionally post a comment and stop running timers",
+					parameters: {
+						task_id: "Required. The task ID to complete",
+						comment: "Optional. A completion comment to post on the task",
+						stop_timer: "Optional. Whether to stop running timers (default: true)"
+					},
+					returns: {
+						task: "Updated task info (id, title, closed status)",
+						comment_posted: "Whether the comment was posted",
+						comment_id: "ID of the created comment (if posted)",
+						timers_stopped: "Number of timers stopped",
+						errors: "Any sub-step errors (partial results are still returned)"
+					}
+				},
+				log_day: {
+					description: "Create multiple time entries in parallel from a structured list",
+					parameters: {
+						entries: "Required. Array of { project_id, service_id, duration_minutes, note?, date? }",
+						date: "Optional. Default date for all entries (YYYY-MM-DD, defaults to today)",
+						person_id: "Optional. Person to log for (defaults to current user)"
+					},
+					returns: {
+						entries: "Per-entry results with success/failure status",
+						succeeded: "Number of entries successfully created",
+						failed: "Number of entries that failed",
+						total_minutes_logged: "Sum of minutes for successful entries"
+					}
+				},
+				weekly_standup: {
+					description: "Aggregate a weekly standup: completed tasks, time logged, and upcoming deadlines",
+					parameters: {
+						person_id: "Optional. Person to generate standup for (defaults to current user)",
+						week_start: "Optional. ISO date for Monday of the week (defaults to this Monday)"
+					},
+					returns: {
+						completed_tasks: "Tasks closed this week (count + list)",
+						time_logged: "Total minutes and breakdown by project",
+						upcoming_deadlines: "Open tasks due in the next 7 days"
+					}
+				}
+			}
+		});
+		default: return inputErrorResult(ErrorMessages.invalidAction(action, "workflows", VALID_ACTIONS));
+	}
+}
+/**
 * Tool execution handlers for Productive MCP server
 * These are shared between stdio and HTTP transports
 *
@@ -2918,12 +3571,67 @@ var VALID_RESOURCES = [...RESOURCES];
 /** Default page size for MCP (smaller than CLI to reduce token usage) */
 var DEFAULT_PER_PAGE = 20;
 /**
+* Route to the appropriate resource handler.
+* Extracted from executeToolWithCredentials to keep cyclomatic complexity manageable.
+*/
+async function routeToHandler(resource, action, restArgs, resolveArgs, ctx, credentials) {
+	switch (resource) {
+		case "projects": return await handleProjects(action, {
+			...restArgs,
+			...resolveArgs
+		}, ctx);
+		case "time": return await handleTime(action, {
+			...restArgs,
+			...resolveArgs
+		}, ctx);
+		case "tasks": return await handleTasks(action, {
+			...restArgs,
+			...resolveArgs
+		}, ctx);
+		case "services": return await handleServices(action, restArgs, ctx);
+		case "people": return await handlePeople(action, {
+			...restArgs,
+			...resolveArgs
+		}, ctx, credentials);
+		case "companies": return await handleCompanies(action, {
+			...restArgs,
+			...resolveArgs
+		}, ctx);
+		case "comments": return await handleComments(action, restArgs, ctx);
+		case "attachments": return await handleAttachments(action, restArgs, ctx);
+		case "timers": return await handleTimers(action, restArgs, ctx);
+		case "deals": return await handleDeals(action, {
+			...restArgs,
+			...resolveArgs
+		}, ctx);
+		case "bookings": return await handleBookings(action, restArgs, ctx);
+		case "pages": return await handlePages(action, restArgs, ctx);
+		case "discussions": return await handleDiscussions(action, restArgs, ctx);
+		case "activities": return await handleActivities(action, restArgs, ctx);
+		case "reports": return await handleReports(action, restArgs, ctx);
+		case "summaries": return await handleSummaries(action, restArgs, ctx);
+		case "workflows": return await handleWorkflows(action, restArgs, ctx);
+		case "budgets": return inputErrorResult(new UserInputError("The \"budgets\" resource has been removed. Budgets are deals with type=2.", [
+			"Use resource=\"deals\" with filter[type]=\"2\" to list only budgets",
+			"To create a budget: resource=\"deals\" action=\"create\" with budget=true",
+			"Use action=\"help\" resource=\"deals\" for full documentation"
+		]));
+		case "docs": return inputErrorResult(new UserInputError("Unknown resource \"docs\". Did you mean \"pages\"?", [
+			"Use resource=\"pages\" to access Productive pages/documents",
+			"Use action=\"list\" to list all pages",
+			"Use action=\"help\" resource=\"pages\" for full documentation"
+		]));
+		default: return inputErrorResult(ErrorMessages.unknownResource(resource, VALID_RESOURCES));
+	}
+}
+/**
 * Execute a tool with the given credentials and arguments
 */
 async function executeToolWithCredentials(name, args, credentials) {
 	if (name !== "productive") return errorResult(`Unknown tool: ${name}`);
 	const typedArgs = args;
 	if (typedArgs.resource === "batch") return handleBatch(typedArgs.operations, credentials, executeToolWithCredentials);
+	if (args.params !== void 0) return inputErrorResult(new UserInputError("Unknown field \"params\". Use \"filter\" instead.", ["Example: { \"filter\": { \"assignee_id\": \"me\" } }", "The MCP tool uses \"filter\" for query parameters, not \"params\""]));
 	const { resource, action, filter, page, per_page, compact, include, query, resources, no_hints, type, ...restArgs } = typedArgs;
 	if (resource === "search") return await handleSearch(query, resources, credentials, executeToolWithCredentials);
 	const api = new ProductiveApi({ config: {
@@ -2941,7 +3649,18 @@ async function executeToolWithCredentials(name, args, credentials) {
 		query
 	};
 	const includeHints = no_hints !== true && action === "get" && !isCompact;
-	const execCtx = fromHandlerContext({ api });
+	const includeSuggestions = no_hints !== true;
+	if (include && include.length > 0) {
+		const includeValidation = validateIncludes(resource, include);
+		if (includeValidation && includeValidation.invalid.length > 0) {
+			const { invalid, valid, suggestions } = includeValidation;
+			const hintLines = [`Invalid include value${invalid.length > 1 ? "s" : ""}: ${invalid.join(", ")}`, `Valid includes for ${resource}: ${(VALID_INCLUDES[resource] ?? []).join(", ")}`];
+			for (const [value, suggestion] of Object.entries(suggestions)) hintLines.push(`"${value}": ${suggestion}`);
+			if (valid.length > 0) hintLines.push(`The following includes are valid and will be used if you remove the invalid ones: ${valid.join(", ")}`);
+			return inputErrorResult(new UserInputError(`Invalid include value${invalid.length > 1 ? "s" : ""} for resource "${resource}": ${invalid.join(", ")}`, hintLines));
+		}
+	}
+	const execCtx = fromHandlerContext({ api }, { userId: credentials.userId });
 	const ctx = {
 		formatOptions,
 		filter: stringFilter,
@@ -2949,55 +3668,29 @@ async function executeToolWithCredentials(name, args, credentials) {
 		perPage,
 		include,
 		includeHints,
+		includeSuggestions,
 		executor: () => execCtx
 	};
 	try {
-		if (action === "help") return resource ? handleHelp(resource) : handleHelpOverview();
+		if (action === "search" && resource !== "search") return inputErrorResult(new UserInputError(`action="search" is not supported on resource="${resource}". Use action="list" with a query parameter for text filtering, or use resource="search" for cross-resource search.`, [
+			`Use resource="${resource}" action="list" with query="<your search terms>" to filter ${resource}`,
+			"Use resource=\"search\" action=\"run\" with query=\"<your search terms>\" to search across all resources",
+			`Use action="help" resource="${resource}" to see all supported actions and filters`
+		]));
+		if (action.startsWith("get_")) {
+			const suggestedResource = action.replace(/^get_/, "").replace(/_/g, " ");
+			return inputErrorResult(new UserInputError(`action="${action}" is not valid. Actions use simple verbs like "list", "get", "create", not function-style names.`, [
+				`To retrieve a single item, use action="get" with an id parameter`,
+				`To retrieve multiple items, use action="list" (e.g. resource="${resource || suggestedResource}" action="list")`,
+				`Use action="help" resource="${resource || "tasks"}" to see all supported actions for a resource`
+			]));
+		}
+		if (action === "help" && resource !== "summaries") return resource ? handleHelp(resource) : handleHelpOverview();
 		if (action === "schema") return resource ? handleSchema(resource) : handleSchemaOverview();
-		const resolveArgs = {
+		return await routeToHandler(resource, action, restArgs, {
 			query,
 			type
-		};
-		switch (resource) {
-			case "projects": return await handleProjects(action, {
-				...restArgs,
-				...resolveArgs
-			}, ctx);
-			case "time": return await handleTime(action, {
-				...restArgs,
-				...resolveArgs
-			}, ctx);
-			case "tasks": return await handleTasks(action, {
-				...restArgs,
-				...resolveArgs
-			}, ctx);
-			case "services": return await handleServices(action, restArgs, ctx);
-			case "people": return await handlePeople(action, {
-				...restArgs,
-				...resolveArgs
-			}, ctx, credentials);
-			case "companies": return await handleCompanies(action, {
-				...restArgs,
-				...resolveArgs
-			}, ctx);
-			case "comments": return await handleComments(action, restArgs, ctx);
-			case "attachments": return await handleAttachments(action, restArgs, ctx);
-			case "timers": return await handleTimers(action, restArgs, ctx);
-			case "deals": return await handleDeals(action, {
-				...restArgs,
-				...resolveArgs
-			}, ctx);
-			case "bookings": return await handleBookings(action, restArgs, ctx);
-			case "pages": return await handlePages(action, restArgs, ctx);
-			case "discussions": return await handleDiscussions(action, restArgs, ctx);
-			case "reports": return await handleReports(action, restArgs, ctx);
-			case "budgets": return inputErrorResult(new UserInputError("The \"budgets\" resource has been removed. Budgets are deals with type=2.", [
-				"Use resource=\"deals\" with filter[type]=\"2\" to list only budgets",
-				"To create a budget: resource=\"deals\" action=\"create\" with budget=true",
-				"Use action=\"help\" resource=\"deals\" for full documentation"
-			]));
-			default: return inputErrorResult(ErrorMessages.unknownResource(resource, VALID_RESOURCES));
-		}
+		}, ctx, credentials);
 	} catch (error) {
 		if (isUserInputError(error)) return formatError(error);
 		const message = error instanceof Error ? error.message : String(error);
@@ -3011,4 +3704,4 @@ async function executeToolWithCredentials(name, args, credentials) {
 }
 export { executeToolWithCredentials as t };
 
-//# sourceMappingURL=handlers-DWowqxFA.js.map
+//# sourceMappingURL=handlers-CaOBYauF.js.map