@studiometa/productive-mcp 0.10.1 → 0.10.2

package/dist/handlers/deals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deals.d.ts","sourceRoot":"","sources":["../../src/handlers/deals.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAM3C,eAAO,MAAM,WAAW;;;wFAwBtB,CAAC"}
+{"version":3,"file":"deals.d.ts","sourceRoot":"","sources":["../../src/handlers/deals.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAQ3C,eAAO,MAAM,WAAW;;;wFAsCtB,CAAC"}

package/dist/handlers/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/handlers/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA8pB7C;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAevD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,UAAU,CAY/C"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/handlers/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAgrB7C;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAevD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,UAAU,CAY/C"}

package/dist/handlers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,YAAY,CAAC;AA0B7D,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA8D7C;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,qBAAqB,GACjC,OAAO,CAAC,UAAU,CAAC,CAgKrB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,YAAY,CAAC;AA2B7D,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA8D7C;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,qBAAqB,GACjC,OAAO,CAAC,UAAU,CAAC,CAoKrB"}

package/dist/handlers/projects.d.ts

@@ -7,7 +7,7 @@ import type { CommonArgs } from './types.js';
 /**
  * Handle projects resource.
  *
- * Supports: list, get, resolve
+ * Supports: list, get, resolve, context
  */
 export declare const handleProjects: (action: string, args: CommonArgs & {
     query?: string;

package/dist/handlers/projects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/handlers/projects.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;wFAUzB,CAAC"}
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/handlers/projects.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAQ7C;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;wFAwBzB,CAAC"}

package/dist/handlers/summaries.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Summaries MCP handler.
+ *
+ * Custom handler for dashboard-style summaries (not using createResourceHandler).
+ * Routes actions to the appropriate summary executor.
+ */
+import type { HandlerContext, ToolResult } from './types.js';
+interface SummaryArgs {
+    project_id?: string;
+}
+/**
+ * Handle summaries resource.
+ *
+ * Supports: my_day, project_health, team_pulse
+ */
+export declare function handleSummaries(action: string, args: SummaryArgs, ctx: HandlerContext): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=summaries.d.ts.map

package/dist/handlers/summaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summaries.d.ts","sourceRoot":"","sources":["../../src/handlers/summaries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAO7D,UAAU,WAAW;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,UAAU,CAAC,CA2ErB"}

package/dist/handlers/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/handlers/tasks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAM3C,eAAO,MAAM,WAAW;;;wFAsCtB,CAAC"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/handlers/tasks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAQ3C,eAAO,MAAM,WAAW;;;wFAsDtB,CAAC"}

package/dist/{handlers-DWowqxFA.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
 *
@@ -1238,7 +1238,8 @@ const handleDeals = createResourceHandler({
 		"get",
 		"create",
 		"update",
-		"resolve"
+		"resolve",
+		"context"
 	],
 	formatter: formatDeal$1,
 	hints: (_data, id) => getDealHints(id),
@@ -1259,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,
@@ -1389,7 +1404,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 +1446,14 @@ var RESOURCE_HELP = {
 					action: "get",
 					id: "12345"
 				}
+			},
+			{
+				description: "Get full project context",
+				params: {
+					resource: "projects",
+					action: "context",
+					id: "12345"
+				}
 			}
 		]
 	},
@@ -1440,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",
@@ -1516,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"
+				}
 			}
 		]
 	},
@@ -1833,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",
@@ -1883,6 +1917,14 @@ var RESOURCE_HELP = {
 					action: "list",
 					filter: { type: "2" }
 				}
+			},
+			{
+				description: "Get full deal context",
+				params: {
+					resource: "deals",
+					action: "context",
+					id: "12345"
+				}
 			}
 		]
 	},
@@ -2173,7 +2215,7 @@ const handlePages = createResourceHandler({
 /**
 * People MCP handler.
 */
-var VALID_ACTIONS$1 = [
+var VALID_ACTIONS$2 = [
 	"list",
 	"get",
 	"me",
@@ -2224,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.
@@ -2234,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
@@ -2264,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();
@@ -2756,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({
@@ -2766,7 +2892,8 @@ const handleTasks = createResourceHandler({
 		"get",
 		"create",
 		"update",
-		"resolve"
+		"resolve",
+		"context"
 	],
 	formatter: formatTask$1,
 	hints: (data, id) => {
@@ -2798,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,
@@ -2941,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,
@@ -2952,7 +3096,7 @@ 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,
@@ -2991,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",
@@ -3011,4 +3156,4 @@ async function executeToolWithCredentials(name, args, credentials) {
 }
 export { executeToolWithCredentials as t };
 
-//# sourceMappingURL=handlers-DWowqxFA.js.map
+//# sourceMappingURL=handlers-B8GRTaDu.js.map