@studiometa/productive-mcp 0.10.7 → 0.10.8

package/dist/formatters.d.ts

@@ -70,6 +70,10 @@ export declare function formatPage(page: JsonApiResource, options?: McpFormatOpt
  */
 export declare function formatDiscussion(discussion: JsonApiResource, options?: McpFormatOptions): Record<string, unknown>;
 export declare function formatActivity(activity: JsonApiResource, options?: McpFormatOptions): Record<string, unknown>;
+/**
+ * Format custom field for agent consumption
+ */
+export declare function formatCustomField(field: JsonApiResource, options?: McpFormatOptions): Record<string, unknown>;
 /**
  * Format list response with pagination
  *

package/dist/formatters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"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"}

package/dist/handlers/custom-fields.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Custom Fields MCP handler.
+ *
+ * Uses the createResourceHandler factory for list/get.
+ * Custom fields are read-only — only `list` and `get` are supported.
+ */
+import type { CommonArgs } from './types.js';
+/**
+ * Args for custom field requests.
+ */
+export interface CustomFieldArgs extends CommonArgs {
+    /** Filter by customizable type (e.g. 'Task', 'Deal', 'Company') */
+    customizable_type?: string;
+    /** Filter by archived status */
+    archived?: string;
+}
+/**
+ * Handle custom_fields resource.
+ *
+ * Supports: list, get
+ */
+export declare const handleCustomFields: (action: string, args: CustomFieldArgs & {
+    query?: string;
+    type?: import("@studiometa/productive-core").ResolvableResourceType;
+}, ctx: import("./types.js").HandlerContext) => Promise<import("./types.js").ToolResult>;
+//# sourceMappingURL=custom-fields.d.ts.map

package/dist/handlers/custom-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-fields.d.ts","sourceRoot":"","sources":["../../src/handlers/custom-fields.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;wFAiB7B,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;AAs7B7C;;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;AAi/B7C;;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;AA+B7D,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAwI7C;;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,CA0IrB"}
+{"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;AAgC7D,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA2I7C;;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,CA0IrB"}

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/handlers/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAiUD;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAazD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,CAUjD"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/handlers/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AA6UD;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAazD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,CAUjD"}

package/dist/handlers/valid-includes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"valid-includes.d.ts","sourceRoot":"","sources":["../../src/handlers/valid-includes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAenD,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAmBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,GACjB,sBAAsB,GAAG,IAAI,CA0B/B"}
+{"version":3,"file":"valid-includes.d.ts","sourceRoot":"","sources":["../../src/handlers/valid-includes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAgBnD,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAmBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,GACjB,sBAAsB,GAAG,IAAI,CA0B/B"}

package/dist/{handlers-CzOijI7B.js → handlers-t95fhdps.js}

@@ -1,5 +1,5 @@
-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";
+import { ProductiveApi, formatActivity, formatAttachment, formatBooking, formatComment, formatCompany, formatCustomField, 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, getCustomField, getDeal, getDealContext, getDiscussion, getMyDaySummary, getPage, getPerson, getProject, getProjectContext, getProjectHealthSummary, getReport, getTask, getTaskContext, getTeamPulseSummary, getTimeEntry, getTimer, listActivities, listAttachments, listBookings, listComments, listCompanies, listCustomFields, 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
 *
@@ -240,6 +240,15 @@ function formatActivity$1(activity, options) {
 	});
 }
 /**
+* Format custom field for agent consumption
+*/
+function formatCustomField$1(field, options) {
+	return formatCustomField(field, {
+		...MCP_FORMAT_OPTIONS,
+		included: options?.included
+	});
+}
+/**
 * Format list response with pagination
 *
 * @param data - Array of JSON:API resources
@@ -288,6 +297,15 @@ function getTaskHints(taskId, serviceId) {
 					action: "list",
 					filter: { parent_task_id: taskId }
 				}
+			},
+			{
+				resource: "custom_fields",
+				description: "List custom field definitions for tasks (to resolve custom_fields values)",
+				example: {
+					resource: "custom_fields",
+					action: "list",
+					filter: { customizable_type: "Task" }
+				}
 			}
 		],
 		common_actions: [{
@@ -419,6 +437,15 @@ function getDealHints(dealId) {
 					action: "list",
 					filter: { deal_id: dealId }
 				}
+			},
+			{
+				resource: "custom_fields",
+				description: "List custom field definitions for deals (to resolve custom_fields values)",
+				example: {
+					resource: "custom_fields",
+					action: "list",
+					filter: { customizable_type: "Deal" }
+				}
 			}
 		],
 		common_actions: [{
@@ -534,6 +561,15 @@ function getCompanyHints(companyId) {
 				action: "list",
 				filter: { company_id: companyId }
 			}
+		},
+		{
+			resource: "custom_fields",
+			description: "List custom field definitions for companies (to resolve custom_fields values)",
+			example: {
+				resource: "custom_fields",
+				action: "list",
+				filter: { customizable_type: "Company" }
+			}
 		}
 	] };
 }
@@ -755,6 +791,31 @@ function getDiscussionHints(discussionId, pageId) {
 	return hints;
 }
 /**
+* Generate hints for a custom field definition
+*/
+function getCustomFieldHints(fieldId) {
+	return {
+		related_resources: [{
+			resource: "custom_fields",
+			description: "List all custom field definitions for a resource type",
+			example: {
+				resource: "custom_fields",
+				action: "list",
+				filter: { customizable_type: "Task" }
+			}
+		}],
+		common_actions: [{
+			action: "Get this custom field with its options",
+			example: {
+				resource: "custom_fields",
+				action: "get",
+				id: fieldId,
+				include: ["options"]
+			}
+		}]
+	};
+}
+/**
 * Generate hints for a timer
 */
 function getTimerHints(timerId, serviceId) {
@@ -1664,6 +1725,17 @@ var RESOURCE_SCHEMAS = {
 			}
 		}
 	},
+	custom_fields: {
+		actions: ["list", "get"],
+		filters: {
+			customizable_type: "string — Task, Deal, Company, Project, Booking, Service, etc.",
+			archived: "boolean",
+			name: "string",
+			project_id: "string",
+			global: "boolean"
+		},
+		includes: ["options"]
+	},
 	activities: {
 		actions: ["list"],
 		filters: {
@@ -2216,6 +2288,35 @@ const handleCompanies = createResourceHandler({
 	}
 });
 /**
+* Custom Fields MCP handler.
+*
+* Uses the createResourceHandler factory for list/get.
+* Custom fields are read-only — only `list` and `get` are supported.
+*/
+/**
+* Handle custom_fields resource.
+*
+* Supports: list, get
+*/
+const handleCustomFields = createResourceHandler({
+	resource: "custom_fields",
+	displayName: "custom field",
+	actions: ["list", "get"],
+	formatter: formatCustomField$1,
+	hints: (_data, id) => getCustomFieldHints(id),
+	executors: {
+		list: listCustomFields,
+		get: getCustomField
+	},
+	defaultInclude: { get: ["options"] },
+	listFilterFromArgs: (args) => {
+		const filter = {};
+		if (args.customizable_type) filter.customizable_type = args.customizable_type;
+		if (args.archived) filter.archived = args.archived;
+		return filter;
+	}
+});
+/**
 * Discussions MCP handler.
 */
 var STATUS_MAP = {
@@ -3258,6 +3359,59 @@ var RESOURCE_HELP = {
 			}
 		]
 	},
+	custom_fields: {
+		description: "Custom field definitions — list and inspect custom fields configured in your organization. Custom fields appear as raw ID hashes on tasks, deals, companies, etc. Use this resource to discover field names, data types, and option values for resolution.",
+		actions: {
+			list: "List custom field definitions (filter by customizable_type to scope to a resource)",
+			get: "Get a single custom field definition with its options (include: options)"
+		},
+		filters: {
+			customizable_type: "Filter by resource type: Task, Deal, Company, Project, Booking, Service, etc.",
+			archived: "Filter by archived status (boolean)",
+			name: "Filter by field name",
+			project_id: "Filter by project ID",
+			global: "Filter global custom fields (boolean)"
+		},
+		includes: ["options"],
+		fields: {
+			id: "Unique custom field identifier (used as key in custom_fields hash)",
+			name: "Human-readable field name",
+			data_type: "Field type: text, number, select, date, multi-select, person, attachment",
+			data_type_id: "Numeric type: 1=Text, 2=Number, 3=Select, 4=Date, 5=Multi-select, 6=Person, 7=Attachment",
+			customizable_type: "Resource type this field applies to (e.g. Task, Deal)",
+			archived: "Whether the field is archived",
+			required: "Whether the field is required",
+			description: "Optional description of the field",
+			options: "For select/multi-select: array of {id, value, archived} (when include=options)"
+		},
+		examples: [
+			{
+				description: "List custom fields for tasks",
+				params: {
+					resource: "custom_fields",
+					action: "list",
+					filter: { customizable_type: "Task" }
+				}
+			},
+			{
+				description: "Get a custom field with its options",
+				params: {
+					resource: "custom_fields",
+					action: "get",
+					id: "42236",
+					include: ["options"]
+				}
+			},
+			{
+				description: "List all non-archived custom fields",
+				params: {
+					resource: "custom_fields",
+					action: "list",
+					filter: { archived: "false" }
+				}
+			}
+		]
+	},
 	activities: {
 		description: "Read-only activity feed — audit log of create/update/delete events across the organization",
 		actions: { list: "List recent activities with optional filters" },
@@ -3766,6 +3920,7 @@ const handleTimers = createResourceHandler({
 */
 const VALID_INCLUDES = {
 	activities: ["creator"],
+	custom_fields: ["options"],
 	tasks: [
 		"project",
 		"project.company",
@@ -3992,6 +4147,7 @@ async function routeToHandler(resource, action, restArgs, resolveArgs, ctx, cred
 		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 "custom_fields": return await handleCustomFields(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);
@@ -4066,4 +4222,4 @@ async function executeToolWithCredentials(name, args, credentials) {
 }
 export { handleSchemaOverview as a, handleDeals as c, handleServices as i, handleTasks as n, handleProjects as o, handleSummaries as r, handlePeople as s, executeToolWithCredentials as t };
 
-//# sourceMappingURL=handlers-CzOijI7B.js.map
+//# sourceMappingURL=handlers-t95fhdps.js.map