@studiometa/productive-mcp 0.10.0 → 0.10.2

package/dist/{handlers-BE3CYyVX.js → handlers-B8GRTaDu.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 { RESOURCES, ResolveError, VALID_REPORT_TYPES, 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, 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";
 /**
 * Custom error classes for MCP server
 *
@@ -988,6 +988,112 @@ const handleAttachments = createResourceHandler({
 	}
 });
 /**
+* Validate batch operations array
+*/
+function validateOperations(operations) {
+	if (!Array.isArray(operations)) throw new UserInputError("operations must be an array", ["Provide an array of operation objects", "Each operation needs: { resource: \"...\", action: \"...\", ...params }"]);
+	if (operations.length === 0) throw new UserInputError("operations array cannot be empty", ["Provide at least one operation", "Example: operations: [{ resource: \"projects\", action: \"list\" }]"]);
+	if (operations.length > 10) throw new UserInputError(`operations array exceeds maximum size of 10`, [`Split your batch into chunks of 10 or fewer operations`, `You provided ${operations.length} operations`]);
+	const validatedOps = [];
+	const errors = [];
+	for (let i = 0; i < operations.length; i++) {
+		const op = operations[i];
+		if (typeof op !== "object" || op === null) {
+			errors.push(`Operation at index ${i}: must be an object`);
+			continue;
+		}
+		const { resource, action } = op;
+		if (typeof resource !== "string" || resource.trim() === "") errors.push(`Operation at index ${i}: missing or invalid "resource" field`);
+		if (typeof action !== "string" || action.trim() === "") errors.push(`Operation at index ${i}: missing or invalid "action" field`);
+		if (errors.length === 0) validatedOps.push(op);
+	}
+	if (errors.length > 0) throw new UserInputError("Invalid operations in batch", errors);
+	return validatedOps;
+}
+/**
+* Execute a single operation and capture result
+*/
+async function executeOperation(operation, index, credentials, execute) {
+	const { resource, action, ...params } = operation;
+	try {
+		const result = await execute("productive", {
+			resource,
+			action,
+			...params
+		}, credentials);
+		const content = result.content[0];
+		if (content?.type === "text") try {
+			const data = JSON.parse(content.text);
+			if (result.isError) return {
+				resource,
+				action,
+				index,
+				error: content.text
+			};
+			return {
+				resource,
+				action,
+				index,
+				data
+			};
+		} catch {
+			if (result.isError) return {
+				resource,
+				action,
+				index,
+				error: content.text
+			};
+			return {
+				resource,
+				action,
+				index,
+				data: content.text
+			};
+		}
+		return {
+			resource,
+			action,
+			index,
+			data: null
+		};
+	} catch (err) {
+		return {
+			resource,
+			action,
+			index,
+			error: err instanceof Error ? err.message : String(err)
+		};
+	}
+}
+/**
+* Handle batch operation - execute multiple operations in parallel
+*
+* @param operations - Array of operations to execute
+* @param credentials - API credentials
+* @param execute - Function to execute individual operations (injected for testability)
+* @returns Batch response with summary and individual results
+*/
+async function handleBatch(operations, credentials, execute) {
+	let validatedOps;
+	try {
+		validatedOps = validateOperations(operations);
+	} catch (err) {
+		if (err instanceof UserInputError) return inputErrorResult(err);
+		throw err;
+	}
+	const results = await Promise.all(validatedOps.map((op, index) => executeOperation(op, index, credentials, execute)));
+	const succeeded = results.filter((r) => r.data !== void 0 && r.error === void 0).length;
+	const failed = results.filter((r) => r.error !== void 0).length;
+	return jsonResult({
+		_batch: {
+			total: results.length,
+			succeeded,
+			failed
+		},
+		results
+	});
+}
+/**
 * Bookings MCP handler.
 */
 const handleBookings = createResourceHandler({
@@ -1132,7 +1238,8 @@ const handleDeals = createResourceHandler({
 		"get",
 		"create",
 		"update",
-		"resolve"
+		"resolve",
+		"context"
 	],
 	formatter: formatDeal$1,
 	hints: (_data, id) => getDealHints(id),
@@ -1153,6 +1260,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,
@@ -1228,12 +1349,63 @@ const handleDiscussions = createResourceHandler({
 	}
 });
 var RESOURCE_HELP = {
+	batch: {
+		description: "Execute multiple operations in a single call. Operations run in parallel via Promise.all, reducing round-trips for AI agents.",
+		actions: { run: "Execute a batch of operations (max 10)" },
+		fields: { operations: "Array of operation objects. Each must have \"resource\" and \"action\", plus any additional params for that resource." },
+		examples: [{
+			description: "Batch multiple queries",
+			params: {
+				resource: "batch",
+				action: "run",
+				operations: [
+					{
+						resource: "projects",
+						action: "get",
+						id: "123"
+					},
+					{
+						resource: "time",
+						action: "list",
+						filter: { project_id: "123" }
+					},
+					{
+						resource: "services",
+						action: "list",
+						filter: { project_id: "123" }
+					}
+				]
+			}
+		}, {
+			description: "Batch create time entries",
+			params: {
+				resource: "batch",
+				action: "run",
+				operations: [{
+					resource: "time",
+					action: "create",
+					service_id: "111",
+					date: "2024-01-15",
+					time: 60,
+					note: "Morning work"
+				}, {
+					resource: "time",
+					action: "create",
+					service_id: "111",
+					date: "2024-01-15",
+					time: 120,
+					note: "Afternoon work"
+				}]
+			}
+		}]
+	},
 	projects: {
 		description: "Manage projects in Productive.io",
 		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",
@@ -1274,6 +1446,14 @@ var RESOURCE_HELP = {
 					action: "get",
 					id: "12345"
 				}
+			},
+			{
+				description: "Get full project context",
+				params: {
+					resource: "projects",
+					action: "context",
+					id: "12345"
+				}
 			}
 		]
 	},
@@ -1284,7 +1464,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",
@@ -1360,6 +1541,14 @@ var RESOURCE_HELP = {
 					project_id: "12345",
 					task_list_id: "111"
 				}
+			},
+			{
+				description: "Get full task context",
+				params: {
+					resource: "tasks",
+					action: "context",
+					id: "67890"
+				}
 			}
 		]
 	},
@@ -1677,7 +1866,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",
@@ -1727,6 +1917,14 @@ var RESOURCE_HELP = {
 					action: "list",
 					filter: { type: "2" }
 				}
+			},
+			{
+				description: "Get full deal context",
+				params: {
+					resource: "deals",
+					action: "context",
+					id: "12345"
+				}
 			}
 		]
 	},
@@ -1949,7 +2147,8 @@ function handleHelp(resource) {
 	const help = RESOURCE_HELP[resource];
 	if (!help) return jsonResult({
 		error: `Unknown resource: ${resource}`,
-		available_resources: Object.keys(RESOURCE_HELP)
+		available_resources: Object.keys(RESOURCE_HELP),
+		_tip: "Call { action: 'help' } without a resource to see all available resources."
 	});
 	return jsonResult({
 		resource,
@@ -1966,7 +2165,8 @@ function handleHelpOverview() {
 			resource,
 			description: help.description,
 			actions: Object.keys(help.actions)
-		}))
+		})),
+		_tip: "Always call { action: 'help', resource: '<name>' } before your first interaction with any resource to learn valid filters, required fields, and examples."
 	});
 }
 /**
@@ -2015,7 +2215,7 @@ const handlePages = createResourceHandler({
 /**
 * People MCP handler.
 */
-var VALID_ACTIONS$1 = [
+var VALID_ACTIONS$2 = [
 	"list",
 	"get",
 	"me",
@@ -2066,7 +2266,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$2));
 }
 /**
 * Projects MCP handler.
@@ -2076,18 +2276,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
@@ -2106,11 +2324,11 @@ function formatReportData(data) {
 		};
 	});
 }
-var VALID_ACTIONS = ["get"];
+var VALID_ACTIONS$1 = ["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$1));
 	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();
@@ -2134,6 +2352,454 @@ async function handleReports(action, args, ctx) {
 	});
 }
 /**
+* Schema definitions for all resources.
+*
+* This provides a compact, machine-readable specification of each resource's
+* capabilities. For detailed documentation with examples, use action=help.
+*/
+var RESOURCE_SCHEMAS = {
+	projects: {
+		actions: [
+			"list",
+			"get",
+			"resolve"
+		],
+		filters: {
+			query: "string — text search on project name",
+			project_type: "1=internal|2=client",
+			company_id: "string",
+			responsible_id: "string",
+			person_id: "string",
+			status: "1=active|2=archived"
+		}
+	},
+	time: {
+		actions: [
+			"list",
+			"get",
+			"create",
+			"update",
+			"delete"
+		],
+		filters: {
+			person_id: "string — use 'me' for current user",
+			after: "date YYYY-MM-DD",
+			before: "date YYYY-MM-DD",
+			project_id: "string",
+			service_id: "string",
+			task_id: "string",
+			status: "1=approved|2=unapproved|3=rejected"
+		},
+		create: {
+			person_id: {
+				required: true,
+				type: "string"
+			},
+			service_id: {
+				required: true,
+				type: "string"
+			},
+			date: {
+				required: true,
+				type: "date YYYY-MM-DD"
+			},
+			time: {
+				required: true,
+				type: "minutes integer"
+			},
+			note: {
+				required: false,
+				type: "string"
+			},
+			task_id: {
+				required: false,
+				type: "string"
+			}
+		},
+		includes: [
+			"person",
+			"service",
+			"task"
+		]
+	},
+	tasks: {
+		actions: [
+			"list",
+			"get",
+			"create",
+			"update",
+			"resolve"
+		],
+		filters: {
+			query: "string — text search on task title",
+			project_id: "string",
+			assignee_id: "string",
+			status: "1=open|2=closed (or \"open\", \"closed\", \"all\")",
+			task_list_id: "string",
+			workflow_status_id: "string — kanban column"
+		},
+		create: {
+			title: {
+				required: true,
+				type: "string"
+			},
+			project_id: {
+				required: true,
+				type: "string"
+			},
+			task_list_id: {
+				required: true,
+				type: "string"
+			},
+			description: {
+				required: false,
+				type: "string"
+			},
+			assignee_id: {
+				required: false,
+				type: "string"
+			}
+		},
+		includes: [
+			"project",
+			"assignee",
+			"comments",
+			"subtasks",
+			"workflow_status"
+		]
+	},
+	services: {
+		actions: ["list", "get"],
+		filters: {
+			project_id: "string",
+			deal_id: "string",
+			task_id: "string",
+			budget_status: "1=open|2=delivered"
+		}
+	},
+	people: {
+		actions: [
+			"list",
+			"get",
+			"me",
+			"resolve"
+		],
+		filters: {
+			query: "string — text search on name or email",
+			status: "1=active|2=deactivated",
+			company_id: "string"
+		}
+	},
+	companies: {
+		actions: [
+			"list",
+			"get",
+			"create",
+			"update",
+			"resolve"
+		],
+		filters: {
+			query: "string — text search on company name",
+			archived: "boolean"
+		},
+		create: { name: {
+			required: true,
+			type: "string"
+		} }
+	},
+	comments: {
+		actions: [
+			"list",
+			"get",
+			"create",
+			"update"
+		],
+		filters: {
+			task_id: "string",
+			deal_id: "string",
+			page_id: "string",
+			discussion_id: "string"
+		},
+		create: {
+			body: {
+				required: true,
+				type: "string"
+			},
+			task_id: {
+				required: false,
+				type: "string — one of task_id, deal_id required"
+			},
+			deal_id: {
+				required: false,
+				type: "string — one of task_id, deal_id required"
+			}
+		},
+		includes: ["creator"]
+	},
+	attachments: {
+		actions: [
+			"list",
+			"get",
+			"delete"
+		],
+		filters: {
+			task_id: "string",
+			comment_id: "string",
+			deal_id: "string",
+			page_id: "string"
+		}
+	},
+	timers: {
+		actions: [
+			"list",
+			"get",
+			"start",
+			"stop"
+		],
+		filters: {
+			person_id: "string",
+			time_entry_id: "string"
+		}
+	},
+	deals: {
+		actions: [
+			"list",
+			"get",
+			"create",
+			"update",
+			"resolve"
+		],
+		filters: {
+			query: "string — text search on deal name",
+			company_id: "string",
+			type: "1=deal|2=budget",
+			stage_status_id: "1=open|2=won|3=lost"
+		},
+		create: {
+			name: {
+				required: true,
+				type: "string"
+			},
+			company_id: {
+				required: true,
+				type: "string"
+			}
+		},
+		includes: ["company", "deal_status"]
+	},
+	bookings: {
+		actions: [
+			"list",
+			"get",
+			"create",
+			"update"
+		],
+		filters: {
+			person_id: "string",
+			after: "date YYYY-MM-DD",
+			before: "date YYYY-MM-DD",
+			service_id: "string"
+		},
+		create: {
+			person_id: {
+				required: true,
+				type: "string"
+			},
+			started_on: {
+				required: true,
+				type: "date YYYY-MM-DD"
+			},
+			ended_on: {
+				required: true,
+				type: "date YYYY-MM-DD"
+			},
+			service_id: {
+				required: false,
+				type: "string — one of service_id, event_id required"
+			},
+			event_id: {
+				required: false,
+				type: "string — one of service_id, event_id required"
+			}
+		}
+	},
+	pages: {
+		actions: [
+			"list",
+			"get",
+			"create",
+			"update",
+			"delete"
+		],
+		filters: { project_id: "string" },
+		create: {
+			title: {
+				required: true,
+				type: "string"
+			},
+			project_id: {
+				required: true,
+				type: "string"
+			},
+			body: {
+				required: false,
+				type: "string"
+			},
+			parent_page_id: {
+				required: false,
+				type: "string"
+			}
+		}
+	},
+	discussions: {
+		actions: [
+			"list",
+			"get",
+			"create",
+			"update",
+			"delete",
+			"resolve",
+			"reopen"
+		],
+		filters: {
+			page_id: "string",
+			status: "1=active|2=resolved"
+		},
+		create: {
+			body: {
+				required: true,
+				type: "string"
+			},
+			page_id: {
+				required: true,
+				type: "string"
+			}
+		}
+	},
+	reports: {
+		actions: ["get"],
+		filters: {
+			person_id: "string",
+			project_id: "string",
+			company_id: "string",
+			after: "date YYYY-MM-DD",
+			before: "date YYYY-MM-DD"
+		},
+		create: {
+			report_type: {
+				required: true,
+				type: "time_reports|project_reports|budget_reports|..."
+			},
+			from: {
+				required: false,
+				type: "date YYYY-MM-DD"
+			},
+			to: {
+				required: false,
+				type: "date YYYY-MM-DD"
+			},
+			group: {
+				required: false,
+				type: "string — grouping dimension"
+			}
+		}
+	}
+};
+/**
+* Handle schema action - returns compact specification for a specific resource
+*/
+function handleSchema(resource) {
+	const schema = RESOURCE_SCHEMAS[resource];
+	if (!schema) return errorResult(`Unknown resource: ${resource}. Valid resources: ${Object.keys(RESOURCE_SCHEMAS).join(", ")}`);
+	return jsonResult({
+		resource,
+		...schema
+	});
+}
+/**
+* Get schema overview for all resources
+*/
+function handleSchemaOverview() {
+	return jsonResult({
+		_tip: "Use action=\"schema\" with a specific resource for full filter/create/includes spec",
+		resources: Object.entries(RESOURCE_SCHEMAS).map(([resource, schema]) => ({
+			resource,
+			actions: schema.actions
+		}))
+	});
+}
+/**
+* Resources that support the query filter for text search
+*/
+const SEARCHABLE_RESOURCES = [
+	"projects",
+	"companies",
+	"people",
+	"tasks",
+	"deals"
+];
+/**
+* Default resources to search when not specified
+*/
+var DEFAULT_SEARCH_RESOURCES = [
+	"projects",
+	"companies",
+	"people",
+	"tasks"
+];
+/**
+* Handle cross-resource search.
+*
+* @param query - Search query text (required)
+* @param resources - Resource types to search (optional, defaults to DEFAULT_SEARCH_RESOURCES)
+* @param credentials - Productive API credentials
+* @param execute - Function to execute tool calls (injected for delegation and testing)
+* @returns Grouped search results across all requested resources
+*/
+async function handleSearch(query, resources, credentials, execute) {
+	if (!query || query.trim() === "") return errorResult("Missing required parameter: query. Provide a non-empty search string.");
+	const trimmedQuery = query.trim();
+	const resourcesToSearch = resources && resources.length > 0 ? resources : DEFAULT_SEARCH_RESOURCES;
+	const invalidResources = resourcesToSearch.filter((r) => !SEARCHABLE_RESOURCES.includes(r));
+	if (invalidResources.length > 0) return errorResult(`Invalid searchable resources: ${invalidResources.join(", ")}. Valid searchable resources: ${SEARCHABLE_RESOURCES.join(", ")}.`);
+	const searchPromises = resourcesToSearch.map(async (resource) => {
+		try {
+			const textContent = (await execute("productive", {
+				resource,
+				action: "list",
+				query: trimmedQuery,
+				compact: true,
+				per_page: 10
+			}, credentials)).content.find((c) => c.type === "text");
+			if (!textContent || textContent.type !== "text") return [resource, { error: "No content in response" }];
+			try {
+				const parsed = JSON.parse(textContent.text);
+				const items = parsed.items ?? parsed.data ?? [];
+				return [resource, { items: Array.isArray(items) ? items : [] }];
+			} catch {
+				return [resource, { error: "Failed to parse response JSON" }];
+			}
+		} catch (err) {
+			return [resource, { error: err instanceof Error ? err.message : String(err) }];
+		}
+	});
+	const searchResults = await Promise.all(searchPromises);
+	const results = {};
+	let totalResults = 0;
+	for (const [resource, result] of searchResults) if (result.error) results[resource] = { error: result.error };
+	else {
+		const items = result.items ?? [];
+		results[resource] = items;
+		totalResults += items.length;
+	}
+	return jsonResult({
+		query: trimmedQuery,
+		resources_searched: resourcesToSearch,
+		results,
+		total_results: totalResults
+	});
+}
+/**
 * Services MCP handler.
 *
 * Uses the createResourceHandler factory for the common list pattern.
@@ -2150,6 +2816,72 @@ const handleServices = createResourceHandler({
 	executors: { list: listServices }
 });
 /**
+* Summaries MCP handler.
+*
+* Custom handler for dashboard-style summaries (not using createResourceHandler).
+* Routes actions to the appropriate summary executor.
+*/
+var VALID_ACTIONS = [
+	"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.includes(action)) return inputErrorResult(ErrorMessages.invalidAction(action, "summaries", VALID_ACTIONS));
+	const execCtx = ctx.executor();
+	switch (action) {
+		case "my_day": return jsonResult((await getMyDaySummary({}, execCtx)).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));
+	}
+}
+/**
 * Tasks MCP handler.
 */
 const handleTasks = createResourceHandler({
@@ -2160,7 +2892,8 @@ const handleTasks = createResourceHandler({
 		"get",
 		"create",
 		"update",
-		"resolve"
+		"resolve",
+		"context"
 	],
 	formatter: formatTask$1,
 	hints: (data, id) => {
@@ -2192,6 +2925,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,
@@ -2315,14 +3065,17 @@ var DEFAULT_PER_PAGE = 20;
 * 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);
+	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: {
 		apiToken: credentials.apiToken,
 		organizationId: credentials.organizationId,
 		userId: credentials.userId,
 		baseUrl: process.env.PRODUCTIVE_BASE_URL
 	} });
-	if (name !== "productive") return errorResult(`Unknown tool: ${name}`);
-	const { resource, action, filter, page, per_page, compact, include, query, no_hints, type, ...restArgs } = args;
 	const isCompact = compact ?? action !== "get";
 	const formatOptions = { compact: isCompact };
 	let stringFilter = toStringFilter(filter);
@@ -2332,7 +3085,7 @@ async function executeToolWithCredentials(name, args, credentials) {
 		query
 	};
 	const includeHints = no_hints !== true && action === "get" && !isCompact;
-	const execCtx = fromHandlerContext({ api });
+	const execCtx = fromHandlerContext({ api }, { userId: credentials.userId });
 	const ctx = {
 		formatOptions,
 		filter: stringFilter,
@@ -2343,7 +3096,8 @@ async function executeToolWithCredentials(name, args, credentials) {
 		executor: () => execCtx
 	};
 	try {
-		if (action === "help") return resource ? handleHelp(resource) : handleHelpOverview();
+		if (action === "help" && resource !== "summaries") return resource ? handleHelp(resource) : handleHelpOverview();
+		if (action === "schema") return resource ? handleSchema(resource) : handleSchemaOverview();
 		const resolveArgs = {
 			query,
 			type
@@ -2381,6 +3135,7 @@ async function executeToolWithCredentials(name, args, credentials) {
 			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 "summaries": return await handleSummaries(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",
@@ -2401,4 +3156,4 @@ async function executeToolWithCredentials(name, args, credentials) {
 }
 export { executeToolWithCredentials as t };
 
-//# sourceMappingURL=handlers-BE3CYyVX.js.map
+//# sourceMappingURL=handlers-B8GRTaDu.js.map