@studiometa/productive-mcp 0.10.10 → 0.10.12

package/dist/tools.js

@@ -34,129 +34,203 @@ function generateDescription() {
 * - idempotentHint: false - Create actions are not idempotent
 * - openWorldHint: true - Tool interacts with external Productive.io API
 */
-var TOOLS = [{
-	name: "productive",
-	description: generateDescription(),
-	annotations: {
-		title: "Productive.io",
-		readOnlyHint: false,
-		destructiveHint: false,
-		idempotentHint: false,
-		openWorldHint: true
-	},
-	inputSchema: {
-		type: "object",
-		properties: {
-			resource: {
-				type: "string",
-				enum: [...RESOURCES]
-			},
-			action: {
-				type: "string",
-				enum: [...ACTIONS],
-				description: "Use \"help\" for resource documentation"
-			},
-			id: { type: "string" },
-			filter: { type: "object" },
-			page: { type: "number" },
-			per_page: { type: "number" },
-			compact: {
-				type: "boolean",
-				description: "Compact output (default: true for list, false for get)"
-			},
-			include: {
-				type: "array",
-				items: { type: "string" },
-				description: "Related data to include (e.g. [\"project\",\"assignee\"])"
-			},
-			query: {
-				type: "string",
-				description: "Text search for list actions"
-			},
-			resources: {
-				type: "array",
-				items: { type: "string" },
-				description: "Resource types to search (for resource=search). Defaults to [projects, companies, people, tasks]. Valid values: projects, companies, people, tasks, deals."
-			},
-			person_id: { type: "string" },
-			service_id: { type: "string" },
-			task_id: { type: "string" },
-			company_id: { type: "string" },
-			time: { type: "number" },
-			date: { type: "string" },
-			note: { type: "string" },
-			title: { type: "string" },
-			project_id: { type: "string" },
-			task_list_id: { type: "string" },
-			description: { type: "string" },
-			assignee_id: { type: "string" },
-			name: { type: "string" },
-			page_id: {
-				type: "string",
-				description: "Page ID (list pages to find)"
-			},
-			parent_page_id: {
-				type: "string",
-				description: "Parent page ID for sub-pages"
-			},
-			body: {
-				type: "string",
-				description: "Comment/page body content"
-			},
-			hidden: {
-				type: "boolean",
-				description: "Set to true to hide comment from client (comments only)"
-			},
-			deal_id: { type: "string" },
-			comment_id: {
-				type: "string",
-				description: "Comment ID (for attachments)"
-			},
-			time_entry_id: { type: "string" },
-			started_on: {
-				type: "string",
-				description: "Booking date (YYYY-MM-DD)"
-			},
-			ended_on: {
-				type: "string",
-				description: "Booking end date (YYYY-MM-DD)"
-			},
-			event_id: { type: "string" },
-			report_type: {
-				type: "string",
-				enum: [...REPORT_TYPES],
-				description: "Required for resource=reports action=get"
-			},
-			group: {
-				type: "string",
-				description: "Report grouping: person, project, service"
-			},
-			from: {
-				type: "string",
-				description: "Report start (YYYY-MM-DD); filter.after for time"
-			},
-			to: {
-				type: "string",
-				description: "Report end (YYYY-MM-DD); filter.before for time"
-			},
-			status: { type: "string" },
-			operations: {
-				type: "array",
-				items: {
-					type: "object",
-					properties: {
-						resource: { type: "string" },
-						action: { type: "string" }
+var TOOLS = [
+	{
+		name: "productive",
+		description: generateDescription(),
+		annotations: {
+			title: "Productive.io",
+			readOnlyHint: false,
+			destructiveHint: false,
+			idempotentHint: false,
+			openWorldHint: true
+		},
+		inputSchema: {
+			type: "object",
+			properties: {
+				resource: {
+					type: "string",
+					enum: [...RESOURCES]
+				},
+				action: {
+					type: "string",
+					enum: [...ACTIONS],
+					description: "Use \"help\" for resource documentation"
+				},
+				id: { type: "string" },
+				filter: { type: "object" },
+				page: { type: "number" },
+				per_page: { type: "number" },
+				compact: {
+					type: "boolean",
+					description: "Compact output (default: true for list, false for get)"
+				},
+				include: {
+					type: "array",
+					items: { type: "string" },
+					description: "Related data to include (e.g. [\"project\",\"assignee\"])"
+				},
+				query: {
+					type: "string",
+					description: "Text search for list actions"
+				},
+				resources: {
+					type: "array",
+					items: { type: "string" },
+					description: "Resource types to search (for resource=search). Defaults to [projects, companies, people, tasks]. Valid values: projects, companies, people, tasks, deals."
+				},
+				person_id: { type: "string" },
+				service_id: { type: "string" },
+				task_id: { type: "string" },
+				company_id: { type: "string" },
+				time: { type: "number" },
+				date: { type: "string" },
+				note: { type: "string" },
+				title: { type: "string" },
+				project_id: { type: "string" },
+				task_list_id: { type: "string" },
+				description: { type: "string" },
+				assignee_id: { type: "string" },
+				name: { type: "string" },
+				page_id: {
+					type: "string",
+					description: "Page ID (list pages to find)"
+				},
+				parent_page_id: {
+					type: "string",
+					description: "Parent page ID for sub-pages"
+				},
+				body: {
+					type: "string",
+					description: "Comment/page body content"
+				},
+				hidden: {
+					type: "boolean",
+					description: "Set to true to hide comment from client (comments only)"
+				},
+				deal_id: { type: "string" },
+				comment_id: {
+					type: "string",
+					description: "Comment ID (for attachments)"
+				},
+				time_entry_id: { type: "string" },
+				started_on: {
+					type: "string",
+					description: "Booking date (YYYY-MM-DD)"
+				},
+				ended_on: {
+					type: "string",
+					description: "Booking end date (YYYY-MM-DD)"
+				},
+				event_id: { type: "string" },
+				report_type: {
+					type: "string",
+					enum: [...REPORT_TYPES],
+					description: "Required for resource=reports action=get"
+				},
+				group: {
+					type: "string",
+					description: "Report grouping: person, project, service"
+				},
+				from: {
+					type: "string",
+					description: "Report start (YYYY-MM-DD); filter.after for time"
+				},
+				to: {
+					type: "string",
+					description: "Report end (YYYY-MM-DD); filter.before for time"
+				},
+				status: { type: "string" },
+				operations: {
+					type: "array",
+					items: {
+						type: "object",
+						properties: {
+							resource: { type: "string" },
+							action: { type: "string" }
+						},
+						required: ["resource", "action"]
 					},
-					required: ["resource", "action"]
+					maxItems: 10,
+					description: "Array of operations for batch execution (max 10). Each operation needs resource, action, and any additional params."
+				}
+			},
+			required: ["resource", "action"]
+		}
+	},
+	{
+		name: "api_read",
+		description: "Read-only raw Productive API access for documented GET endpoints. Supports describe=true for endpoint docs, filter/include/sort, and optional safe pagination.",
+		annotations: {
+			title: "Productive API Read",
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true,
+			openWorldHint: true
+		},
+		inputSchema: {
+			type: "object",
+			properties: {
+				path: {
+					type: "string",
+					description: "Relative Productive API path, e.g. /invoices"
+				},
+				describe: {
+					type: "boolean",
+					description: "Return endpoint documentation instead of calling the API"
+				},
+				filter: { type: "object" },
+				include: {
+					type: "array",
+					items: { type: "string" }
 				},
-				maxItems: 10,
-				description: "Array of operations for batch execution (max 10). Each operation needs resource, action, and any additional params."
-			}
+				sort: {
+					type: "array",
+					items: { type: "string" }
+				},
+				page: { type: "number" },
+				per_page: { type: "number" },
+				paginate: { type: "boolean" },
+				max_pages: { type: "number" }
+			},
+			required: ["path"]
+		}
+	},
+	{
+		name: "api_write",
+		description: "Gated raw Productive API write access for documented endpoints. Disabled by default, requires PRODUCTIVE_MCP_ENABLE_API_WRITE=true and confirm=true. Supports dry_run=true.",
+		annotations: {
+			title: "Productive API Write",
+			readOnlyHint: false,
+			destructiveHint: true,
+			idempotentHint: false,
+			openWorldHint: true
 		},
-		required: ["resource", "action"]
+		inputSchema: {
+			type: "object",
+			properties: {
+				method: {
+					type: "string",
+					enum: [
+						"POST",
+						"PATCH",
+						"PUT",
+						"DELETE"
+					]
+				},
+				path: { type: "string" },
+				body: { type: "object" },
+				confirm: { type: "boolean" },
+				dry_run: { type: "boolean" }
+			},
+			required: [
+				"method",
+				"path",
+				"confirm"
+			]
+		}
 	}
-}];
+];
 /**
 * Additional tools only available in stdio mode (local execution)
 * These tools manage persistent configuration

package/dist/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","names":[],"sources":["../src/tools.ts"],"sourcesContent":["import type { Tool } from '@modelcontextprotocol/sdk/types.js';\n\nimport { RESOURCES, ACTIONS, REPORT_TYPES } from '@studiometa/productive-core';\n\n/**\n * Generate the tool description dynamically from the constants.\n * Adding a resource or action to constants.ts automatically updates this description.\n */\nfunction generateDescription(): string {\n  return [\n    'Productive.io API.',\n    `Resources: ${RESOURCES.join(', ')}.`,\n    `Actions: ${ACTIONS.join(', ')} (varies by resource).`,\n    'Discovery: action=help with any resource for filters, fields, examples. action=schema for compact machine-readable spec.',\n    'Filters: filter:{key:value}. Common: project_id, person_id, after/before (YYYY-MM-DD).',\n    'Includes: include:[...] for related data (e.g. [\"project\",\"assignee\"]).',\n    'Output: compact=false for full detail (default for get; list defaults true).',\n    'Search: query for text search on list actions. Cross-resource: resource=search action=run with query searches projects, companies, people, tasks simultaneously.',\n    'Reports: resource=reports action=get with report_type, from, to.',\n    'Batch: resource=batch action=run with operations=[{resource,action,...}] executes up to 10 ops in parallel.',\n    'Rich context: action=context on tasks/projects/deals for full context in one call.',\n  ].join('\\n');\n}\n\n/**\n * Single consolidated tool for Productive.io MCP server\n *\n * The resource/action/report_type enums and description are derived from\n * the shared constants in constants.ts — the single source of truth for both\n * the MCP tool definition and the Zod validation schemas.\n * Adding a new resource, action, or report type there automatically updates\n * both the tool exposed to clients and the validation layer.\n *\n * MCP Annotations (for MCP directory compliance):\n * - readOnlyHint: false - Tool can create/update data\n * - destructiveHint: false - Tool does not permanently delete data\n * - idempotentHint: false - Create actions are not idempotent\n * - openWorldHint: true - Tool interacts with external Productive.io API\n */\nexport const TOOLS: Tool[] = [\n  {\n    name: 'productive',\n    description: generateDescription(),\n    annotations: {\n      title: 'Productive.io',\n      readOnlyHint: false,\n      destructiveHint: false,\n      idempotentHint: false,\n      openWorldHint: true,\n    },\n    inputSchema: {\n      type: 'object',\n      properties: {\n        resource: {\n          type: 'string',\n          enum: [...RESOURCES],\n        },\n        action: {\n          type: 'string',\n          enum: [...ACTIONS],\n          description: 'Use \"help\" for resource documentation',\n        },\n        id: { type: 'string' },\n        filter: { type: 'object' },\n        page: { type: 'number' },\n        per_page: { type: 'number' },\n        compact: {\n          type: 'boolean',\n          description: 'Compact output (default: true for list, false for get)',\n        },\n        include: {\n          type: 'array',\n          items: { type: 'string' },\n          description: 'Related data to include (e.g. [\"project\",\"assignee\"])',\n        },\n        query: { type: 'string', description: 'Text search for list actions' },\n        resources: {\n          type: 'array',\n          items: { type: 'string' },\n          description:\n            'Resource types to search (for resource=search). Defaults to [projects, companies, people, tasks]. Valid values: projects, companies, people, tasks, deals.',\n        },\n        // Common fields\n        person_id: { type: 'string' },\n        service_id: { type: 'string' },\n        task_id: { type: 'string' },\n        company_id: { type: 'string' },\n        time: { type: 'number' },\n        date: { type: 'string' },\n        note: { type: 'string' },\n        // Task fields\n        title: { type: 'string' },\n        project_id: { type: 'string' },\n        task_list_id: { type: 'string' },\n        description: { type: 'string' },\n        assignee_id: { type: 'string' },\n        // Company fields\n        name: { type: 'string' },\n        // Page fields\n        page_id: { type: 'string', description: 'Page ID (list pages to find)' },\n        parent_page_id: { type: 'string', description: 'Parent page ID for sub-pages' },\n        // Comment fields\n        body: { type: 'string', description: 'Comment/page body content' },\n        hidden: {\n          type: 'boolean',\n          description: 'Set to true to hide comment from client (comments only)',\n        },\n        deal_id: { type: 'string' },\n        // Attachment fields\n        comment_id: { type: 'string', description: 'Comment ID (for attachments)' },\n        // Timer fields\n        time_entry_id: { type: 'string' },\n        // Booking fields\n        started_on: { type: 'string', description: 'Booking date (YYYY-MM-DD)' },\n        ended_on: { type: 'string', description: 'Booking end date (YYYY-MM-DD)' },\n        event_id: { type: 'string' },\n        // Report fields\n        report_type: {\n          type: 'string',\n          enum: [...REPORT_TYPES],\n          description: 'Required for resource=reports action=get',\n        },\n        group: { type: 'string', description: 'Report grouping: person, project, service' },\n        from: { type: 'string', description: 'Report start (YYYY-MM-DD); filter.after for time' },\n        to: { type: 'string', description: 'Report end (YYYY-MM-DD); filter.before for time' },\n        status: { type: 'string' },\n        // Batch fields\n        operations: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              resource: { type: 'string' },\n              action: { type: 'string' },\n            },\n            required: ['resource', 'action'],\n          },\n          maxItems: 10,\n          description:\n            'Array of operations for batch execution (max 10). Each operation needs resource, action, and any additional params.',\n        },\n      },\n      required: ['resource', 'action'],\n    },\n  },\n];\n\n/**\n * Additional tools only available in stdio mode (local execution)\n * These tools manage persistent configuration\n */\nexport const STDIO_ONLY_TOOLS: Tool[] = [\n  {\n    name: 'productive_configure',\n    description: 'Configure Productive.io credentials',\n    annotations: {\n      title: 'Configure Productive',\n      readOnlyHint: false,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    inputSchema: {\n      type: 'object',\n      properties: {\n        organizationId: { type: 'string' },\n        apiToken: { type: 'string' },\n        userId: { type: 'string' },\n      },\n      required: ['organizationId', 'apiToken'],\n    },\n  },\n  {\n    name: 'productive_get_config',\n    description: 'Get current configuration',\n    annotations: {\n      title: 'Get Productive Config',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    inputSchema: {\n      type: 'object',\n      properties: {},\n    },\n  },\n];\n"],"mappings":"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"}
+{"version":3,"file":"tools.js","names":[],"sources":["../src/tools.ts"],"sourcesContent":["import type { Tool } from '@modelcontextprotocol/sdk/types.js';\n\nimport { RESOURCES, ACTIONS, REPORT_TYPES } from '@studiometa/productive-core';\n\n/**\n * Generate the tool description dynamically from the constants.\n * Adding a resource or action to constants.ts automatically updates this description.\n */\nfunction generateDescription(): string {\n  return [\n    'Productive.io API.',\n    `Resources: ${RESOURCES.join(', ')}.`,\n    `Actions: ${ACTIONS.join(', ')} (varies by resource).`,\n    'Discovery: action=help with any resource for filters, fields, examples. action=schema for compact machine-readable spec.',\n    'Filters: filter:{key:value}. Common: project_id, person_id, after/before (YYYY-MM-DD).',\n    'Includes: include:[...] for related data (e.g. [\"project\",\"assignee\"]).',\n    'Output: compact=false for full detail (default for get; list defaults true).',\n    'Search: query for text search on list actions. Cross-resource: resource=search action=run with query searches projects, companies, people, tasks simultaneously.',\n    'Reports: resource=reports action=get with report_type, from, to.',\n    'Batch: resource=batch action=run with operations=[{resource,action,...}] executes up to 10 ops in parallel.',\n    'Rich context: action=context on tasks/projects/deals for full context in one call.',\n  ].join('\\n');\n}\n\n/**\n * Single consolidated tool for Productive.io MCP server\n *\n * The resource/action/report_type enums and description are derived from\n * the shared constants in constants.ts — the single source of truth for both\n * the MCP tool definition and the Zod validation schemas.\n * Adding a new resource, action, or report type there automatically updates\n * both the tool exposed to clients and the validation layer.\n *\n * MCP Annotations (for MCP directory compliance):\n * - readOnlyHint: false - Tool can create/update data\n * - destructiveHint: false - Tool does not permanently delete data\n * - idempotentHint: false - Create actions are not idempotent\n * - openWorldHint: true - Tool interacts with external Productive.io API\n */\nexport const TOOLS: Tool[] = [\n  {\n    name: 'productive',\n    description: generateDescription(),\n    annotations: {\n      title: 'Productive.io',\n      readOnlyHint: false,\n      destructiveHint: false,\n      idempotentHint: false,\n      openWorldHint: true,\n    },\n    inputSchema: {\n      type: 'object',\n      properties: {\n        resource: {\n          type: 'string',\n          enum: [...RESOURCES],\n        },\n        action: {\n          type: 'string',\n          enum: [...ACTIONS],\n          description: 'Use \"help\" for resource documentation',\n        },\n        id: { type: 'string' },\n        filter: { type: 'object' },\n        page: { type: 'number' },\n        per_page: { type: 'number' },\n        compact: {\n          type: 'boolean',\n          description: 'Compact output (default: true for list, false for get)',\n        },\n        include: {\n          type: 'array',\n          items: { type: 'string' },\n          description: 'Related data to include (e.g. [\"project\",\"assignee\"])',\n        },\n        query: { type: 'string', description: 'Text search for list actions' },\n        resources: {\n          type: 'array',\n          items: { type: 'string' },\n          description:\n            'Resource types to search (for resource=search). Defaults to [projects, companies, people, tasks]. Valid values: projects, companies, people, tasks, deals.',\n        },\n        // Common fields\n        person_id: { type: 'string' },\n        service_id: { type: 'string' },\n        task_id: { type: 'string' },\n        company_id: { type: 'string' },\n        time: { type: 'number' },\n        date: { type: 'string' },\n        note: { type: 'string' },\n        // Task fields\n        title: { type: 'string' },\n        project_id: { type: 'string' },\n        task_list_id: { type: 'string' },\n        description: { type: 'string' },\n        assignee_id: { type: 'string' },\n        // Company fields\n        name: { type: 'string' },\n        // Page fields\n        page_id: { type: 'string', description: 'Page ID (list pages to find)' },\n        parent_page_id: { type: 'string', description: 'Parent page ID for sub-pages' },\n        // Comment fields\n        body: { type: 'string', description: 'Comment/page body content' },\n        hidden: {\n          type: 'boolean',\n          description: 'Set to true to hide comment from client (comments only)',\n        },\n        deal_id: { type: 'string' },\n        // Attachment fields\n        comment_id: { type: 'string', description: 'Comment ID (for attachments)' },\n        // Timer fields\n        time_entry_id: { type: 'string' },\n        // Booking fields\n        started_on: { type: 'string', description: 'Booking date (YYYY-MM-DD)' },\n        ended_on: { type: 'string', description: 'Booking end date (YYYY-MM-DD)' },\n        event_id: { type: 'string' },\n        // Report fields\n        report_type: {\n          type: 'string',\n          enum: [...REPORT_TYPES],\n          description: 'Required for resource=reports action=get',\n        },\n        group: { type: 'string', description: 'Report grouping: person, project, service' },\n        from: { type: 'string', description: 'Report start (YYYY-MM-DD); filter.after for time' },\n        to: { type: 'string', description: 'Report end (YYYY-MM-DD); filter.before for time' },\n        status: { type: 'string' },\n        // Batch fields\n        operations: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              resource: { type: 'string' },\n              action: { type: 'string' },\n            },\n            required: ['resource', 'action'],\n          },\n          maxItems: 10,\n          description:\n            'Array of operations for batch execution (max 10). Each operation needs resource, action, and any additional params.',\n        },\n      },\n      required: ['resource', 'action'],\n    },\n  },\n  {\n    name: 'api_read',\n    description:\n      'Read-only raw Productive API access for documented GET endpoints. Supports describe=true for endpoint docs, filter/include/sort, and optional safe pagination.',\n    annotations: {\n      title: 'Productive API Read',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: true,\n    },\n    inputSchema: {\n      type: 'object',\n      properties: {\n        path: { type: 'string', description: 'Relative Productive API path, e.g. /invoices' },\n        describe: {\n          type: 'boolean',\n          description: 'Return endpoint documentation instead of calling the API',\n        },\n        filter: { type: 'object' },\n        include: { type: 'array', items: { type: 'string' } },\n        sort: { type: 'array', items: { type: 'string' } },\n        page: { type: 'number' },\n        per_page: { type: 'number' },\n        paginate: { type: 'boolean' },\n        max_pages: { type: 'number' },\n      },\n      required: ['path'],\n    },\n  },\n  {\n    name: 'api_write',\n    description:\n      'Gated raw Productive API write access for documented endpoints. Disabled by default, requires PRODUCTIVE_MCP_ENABLE_API_WRITE=true and confirm=true. Supports dry_run=true.',\n    annotations: {\n      title: 'Productive API Write',\n      readOnlyHint: false,\n      destructiveHint: true,\n      idempotentHint: false,\n      openWorldHint: true,\n    },\n    inputSchema: {\n      type: 'object',\n      properties: {\n        method: { type: 'string', enum: ['POST', 'PATCH', 'PUT', 'DELETE'] },\n        path: { type: 'string' },\n        body: { type: 'object' },\n        confirm: { type: 'boolean' },\n        dry_run: { type: 'boolean' },\n      },\n      required: ['method', 'path', 'confirm'],\n    },\n  },\n];\n\n/**\n * Additional tools only available in stdio mode (local execution)\n * These tools manage persistent configuration\n */\nexport const STDIO_ONLY_TOOLS: Tool[] = [\n  {\n    name: 'productive_configure',\n    description: 'Configure Productive.io credentials',\n    annotations: {\n      title: 'Configure Productive',\n      readOnlyHint: false,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    inputSchema: {\n      type: 'object',\n      properties: {\n        organizationId: { type: 'string' },\n        apiToken: { type: 'string' },\n        userId: { type: 'string' },\n      },\n      required: ['organizationId', 'apiToken'],\n    },\n  },\n  {\n    name: 'productive_get_config',\n    description: 'Get current configuration',\n    annotations: {\n      title: 'Get Productive Config',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    inputSchema: {\n      type: 'object',\n      properties: {},\n    },\n  },\n];\n"],"mappings":"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"}

package/dist/{version-Cy8UEAT1.js → version-DMEaGciu.js}

@@ -1,4 +1,4 @@
-import { a as handleSchemaOverview, c as handleDeals, i as handleServices, n as handleTasks, o as handleProjects, r as handleSummaries, s as handlePeople } from "./handlers-vtRpc-Lx.js";
+import { C as handleSchemaOverview, E as handleDeals, S as handleServices, T as handlePeople, b as handleTasks, w as handleProjects, x as handleSummaries } from "./handlers-DonE83xo.js";
 import { ProductiveApi } from "@studiometa/productive-api";
 import { readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
@@ -235,8 +235,8 @@ async function readResource(uri, credentials) {
 }
 //#endregion
 //#region src/version.ts
-var VERSION = "0.10.10";
+var VERSION = "0.10.12";
 //#endregion
 export { INSTRUCTIONS as a, readResource as i, listResourceTemplates as n, listResources as r, VERSION as t };
 
-//# sourceMappingURL=version-Cy8UEAT1.js.map
+//# sourceMappingURL=version-DMEaGciu.js.map

package/dist/{version-Cy8UEAT1.js.map → version-DMEaGciu.js.map}

@@ -1 +1 @@
-{"version":3,"file":"version-Cy8UEAT1.js","names":[],"sources":["../src/instructions.ts","../src/resources.ts","../src/version.ts"],"sourcesContent":["/**\n * MCP Server Instructions\n *\n * These instructions are sent to Claude Desktop during initialization\n * and used as context/hints for the LLM. This ensures the AI agent\n * knows how to properly use the Productive.io MCP server.\n *\n * The content is derived from skills/SKILL.md (without YAML frontmatter).\n */\n\nimport { readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\n/**\n * Load instructions from SKILL.md file\n * Removes YAML frontmatter (content between --- markers)\n */\nfunction loadInstructions(): string {\n  try {\n    // In dist/, go up to package root, then to skills/\n    const skillPath = join(__dirname, '..', 'skills', 'SKILL.md');\n    const content = readFileSync(skillPath, 'utf-8');\n\n    // Remove YAML frontmatter (between --- markers at start of file)\n    const withoutFrontmatter = content.replace(/^---\\n[\\s\\S]*?\\n---\\n+/, '');\n\n    return withoutFrontmatter.trim();\n  } catch {\n    // Fallback if file not found (shouldn't happen in production)\n    return 'Productive.io MCP Server - Use the productive tool with resource and action parameters.';\n  }\n}\n\nexport const INSTRUCTIONS = loadInstructions();\n","/**\n * MCP Resources handlers for Productive MCP Server\n *\n * Exposes Productive data via MCP resources/ capability so clients can browse\n * and read data without tool calls.\n *\n * Static resources (always available):\n *   productive://schema          — full resource schema overview\n *   productive://instructions    — server instructions / SKILL.md content\n *\n * Resource templates (parameterized, require API calls):\n *   productive://projects/{id}            — project details\n *   productive://tasks/{id}               — task details\n *   productive://people/{id}              — person details\n *   productive://deals/{id}               — deal details\n *   productive://projects/{id}/tasks      — tasks for a project\n *   productive://projects/{id}/services   — services for a project\n *\n * Dynamic resources (computed):\n *   productive://summaries/my_day         — personal dashboard\n *   productive://summaries/team_pulse     — team activity\n */\n\nimport type { ReadResourceResult as McpReadResourceResult } from '@modelcontextprotocol/sdk/types.js';\n\nimport { ProductiveApi } from '@studiometa/productive-api';\nimport { fromHandlerContext } from '@studiometa/productive-core';\n\nimport type { ProductiveCredentials } from './auth.js';\nimport type { HandlerContext } from './handlers/types.js';\n\nimport { handleDeals } from './handlers/deals.js';\nimport { handlePeople } from './handlers/people.js';\nimport { handleProjects } from './handlers/projects.js';\nimport { handleSchemaOverview } from './handlers/schema.js';\nimport { handleServices } from './handlers/services.js';\nimport { handleSummaries } from './handlers/summaries.js';\nimport { handleTasks } from './handlers/tasks.js';\nimport { INSTRUCTIONS } from './instructions.js';\n\n/** MIME type used for all resource content */\nconst MIME_TYPE = 'application/json';\n\n/**\n * A single resource content item returned in resources/read responses\n */\nexport interface ResourceContent {\n  uri: string;\n  mimeType: string;\n  text: string;\n}\n\n/**\n * Shape of a resources/read response (re-export of SDK type for consumers)\n */\nexport type ReadResourceResult = McpReadResourceResult;\n\n/**\n * Shape of a static resource descriptor (resources/list)\n */\nexport interface StaticResource {\n  uri: string;\n  name: string;\n  description: string;\n  mimeType: string;\n}\n\n/**\n * Shape of a resource template descriptor (resources/templates/list)\n */\nexport interface ResourceTemplate {\n  uriTemplate: string;\n  name: string;\n  description: string;\n  mimeType: string;\n}\n\n// ---------------------------------------------------------------------------\n// Static resource definitions\n// ---------------------------------------------------------------------------\n\n/**\n * Static resources that are always available without API credentials\n */\nexport const STATIC_RESOURCES: StaticResource[] = [\n  {\n    uri: 'productive://schema',\n    name: 'Schema',\n    description: 'Overview of all Productive.io resources, their actions and filters',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uri: 'productive://instructions',\n    name: 'Instructions',\n    description: 'Server instructions and usage guide for the Productive.io MCP server',\n    mimeType: MIME_TYPE,\n  },\n];\n\n// ---------------------------------------------------------------------------\n// Dynamic resource definitions\n// ---------------------------------------------------------------------------\n\n/**\n * Dynamic resources that are computed at read time (require credentials)\n */\nexport const DYNAMIC_RESOURCES: StaticResource[] = [\n  {\n    uri: 'productive://summaries/my_day',\n    name: 'My Day',\n    description: \"Personal dashboard: open tasks, today's time entries, active timers\",\n    mimeType: MIME_TYPE,\n  },\n  {\n    uri: 'productive://summaries/team_pulse',\n    name: 'Team Pulse',\n    description: 'Team-wide time tracking activity for today',\n    mimeType: MIME_TYPE,\n  },\n];\n\n// ---------------------------------------------------------------------------\n// Resource template definitions\n// ---------------------------------------------------------------------------\n\n/**\n * Resource templates that accept URI parameters (require credentials)\n */\nexport const RESOURCE_TEMPLATES: ResourceTemplate[] = [\n  {\n    uriTemplate: 'productive://projects/{id}',\n    name: 'Project',\n    description: 'Details of a specific project by ID',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uriTemplate: 'productive://tasks/{id}',\n    name: 'Task',\n    description: 'Details of a specific task by ID',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uriTemplate: 'productive://people/{id}',\n    name: 'Person',\n    description: 'Details of a specific person by ID',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uriTemplate: 'productive://deals/{id}',\n    name: 'Deal',\n    description: 'Details of a specific deal or budget by ID',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uriTemplate: 'productive://projects/{id}/tasks',\n    name: 'Project Tasks',\n    description: 'All tasks belonging to a specific project',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uriTemplate: 'productive://projects/{id}/services',\n    name: 'Project Services',\n    description: 'All services belonging to a specific project',\n    mimeType: MIME_TYPE,\n  },\n];\n\n// ---------------------------------------------------------------------------\n// URI pattern matching\n// ---------------------------------------------------------------------------\n\n/** Route patterns and their handler factories */\nconst URI_PATTERNS: Array<{\n  pattern: RegExp;\n  handler: (match: RegExpMatchArray, credentials: ProductiveCredentials) => Promise<unknown>;\n}> = [\n  // Static resources (no credentials needed)\n  {\n    pattern: /^productive:\\/\\/schema$/,\n    handler: async () => {\n      const result = handleSchemaOverview();\n      const text = result.content[0] as { text: string };\n      return JSON.parse(text.text);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/instructions$/,\n    handler: async () => ({ instructions: INSTRUCTIONS }),\n  },\n\n  // Dynamic summaries\n  {\n    pattern: /^productive:\\/\\/summaries\\/my_day$/,\n    handler: async (_, credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handleSummaries('my_day', {}, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/summaries\\/team_pulse$/,\n    handler: async (_, credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handleSummaries('team_pulse', {}, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n\n  // Project nested resources (before single project to avoid conflict)\n  {\n    pattern: /^productive:\\/\\/projects\\/([^/]+)\\/tasks$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials, { filter: { project_id: id } });\n      const result = await handleTasks('list', { project_id: id }, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/projects\\/([^/]+)\\/services$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials, { filter: { project_id: id } });\n      // handleServices uses CommonArgs; project_id is passed via ctx.filter\n      const result = await handleServices('list', {}, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n\n  // Single entity resources\n  {\n    pattern: /^productive:\\/\\/projects\\/([^/]+)$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handleProjects('get', { id }, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/tasks\\/([^/]+)$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handleTasks('get', { id }, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/people\\/([^/]+)$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handlePeople('get', { id }, ctx, credentials);\n      return extractJsonFromResult(result);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/deals\\/([^/]+)$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handleDeals('get', { id }, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n];\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Build a HandlerContext from credentials, with optional filter overrides.\n */\nfunction buildHandlerContext(\n  credentials: ProductiveCredentials,\n  overrides: { filter?: Record<string, string> } = {},\n): HandlerContext {\n  const api = new ProductiveApi({\n    config: {\n      apiToken: credentials.apiToken,\n      organizationId: credentials.organizationId,\n      userId: credentials.userId,\n      baseUrl: process.env.PRODUCTIVE_BASE_URL,\n    },\n  });\n\n  const execCtx = fromHandlerContext({ api }, { userId: credentials.userId });\n\n  return {\n    formatOptions: { compact: false },\n    filter: overrides.filter,\n    perPage: 50,\n    includeHints: false,\n    includeSuggestions: false,\n    executor: () => execCtx,\n  };\n}\n\n/**\n * Extract the parsed JSON data from a ToolResult.\n * Throws if the result is an error or not parseable.\n */\nfunction extractJsonFromResult(result: { content: unknown[]; isError?: boolean }): unknown {\n  if (result.isError) {\n    const text = (result.content[0] as { text: string }).text;\n    throw new Error(text);\n  }\n  const text = (result.content[0] as { text: string }).text;\n  try {\n    return JSON.parse(text);\n  } catch {\n    return { text };\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * List all static and dynamic resources (no credentials needed for static).\n */\nexport function listResources(): StaticResource[] {\n  return [...STATIC_RESOURCES, ...DYNAMIC_RESOURCES];\n}\n\n/**\n * List all resource templates.\n */\nexport function listResourceTemplates(): ResourceTemplate[] {\n  return RESOURCE_TEMPLATES;\n}\n\n/**\n * Read a resource by URI.\n *\n * Routes the URI to the appropriate handler. Throws on unknown URI.\n */\nexport async function readResource(\n  uri: string,\n  credentials: ProductiveCredentials,\n): Promise<ReadResourceResult> {\n  for (const { pattern, handler } of URI_PATTERNS) {\n    const match = uri.match(pattern);\n    if (match) {\n      const data = await handler(match, credentials);\n      return {\n        contents: [\n          {\n            uri,\n            mimeType: MIME_TYPE,\n            text: JSON.stringify(data, null, 2),\n          },\n        ],\n      };\n    }\n  }\n\n  throw new Error(\n    `Unknown resource URI: ${uri}. ` +\n      `Available static resources: ${STATIC_RESOURCES.map((r) => r.uri).join(', ')}. ` +\n      `Available dynamic resources: ${DYNAMIC_RESOURCES.map((r) => r.uri).join(', ')}. ` +\n      `Resource templates: ${RESOURCE_TEMPLATES.map((t) => t.uriTemplate).join(', ')}.`,\n  );\n}\n","/**\n * Package version - injected from package.json at build time\n */\ndeclare const __VERSION__: string;\nexport const VERSION = __VERSION__;\n"],"mappings":"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"}
+{"version":3,"file":"version-DMEaGciu.js","names":[],"sources":["../src/instructions.ts","../src/resources.ts","../src/version.ts"],"sourcesContent":["/**\n * MCP Server Instructions\n *\n * These instructions are sent to Claude Desktop during initialization\n * and used as context/hints for the LLM. This ensures the AI agent\n * knows how to properly use the Productive.io MCP server.\n *\n * The content is derived from skills/SKILL.md (without YAML frontmatter).\n */\n\nimport { readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\n/**\n * Load instructions from SKILL.md file\n * Removes YAML frontmatter (content between --- markers)\n */\nfunction loadInstructions(): string {\n  try {\n    // In dist/, go up to package root, then to skills/\n    const skillPath = join(__dirname, '..', 'skills', 'SKILL.md');\n    const content = readFileSync(skillPath, 'utf-8');\n\n    // Remove YAML frontmatter (between --- markers at start of file)\n    const withoutFrontmatter = content.replace(/^---\\n[\\s\\S]*?\\n---\\n+/, '');\n\n    return withoutFrontmatter.trim();\n  } catch {\n    // Fallback if file not found (shouldn't happen in production)\n    return 'Productive.io MCP Server - Use the productive tool with resource and action parameters.';\n  }\n}\n\nexport const INSTRUCTIONS = loadInstructions();\n","/**\n * MCP Resources handlers for Productive MCP Server\n *\n * Exposes Productive data via MCP resources/ capability so clients can browse\n * and read data without tool calls.\n *\n * Static resources (always available):\n *   productive://schema          — full resource schema overview\n *   productive://instructions    — server instructions / SKILL.md content\n *\n * Resource templates (parameterized, require API calls):\n *   productive://projects/{id}            — project details\n *   productive://tasks/{id}               — task details\n *   productive://people/{id}              — person details\n *   productive://deals/{id}               — deal details\n *   productive://projects/{id}/tasks      — tasks for a project\n *   productive://projects/{id}/services   — services for a project\n *\n * Dynamic resources (computed):\n *   productive://summaries/my_day         — personal dashboard\n *   productive://summaries/team_pulse     — team activity\n */\n\nimport type { ReadResourceResult as McpReadResourceResult } from '@modelcontextprotocol/sdk/types.js';\n\nimport { ProductiveApi } from '@studiometa/productive-api';\nimport { fromHandlerContext } from '@studiometa/productive-core';\n\nimport type { ProductiveCredentials } from './auth.js';\nimport type { HandlerContext } from './handlers/types.js';\n\nimport { handleDeals } from './handlers/deals.js';\nimport { handlePeople } from './handlers/people.js';\nimport { handleProjects } from './handlers/projects.js';\nimport { handleSchemaOverview } from './handlers/schema.js';\nimport { handleServices } from './handlers/services.js';\nimport { handleSummaries } from './handlers/summaries.js';\nimport { handleTasks } from './handlers/tasks.js';\nimport { INSTRUCTIONS } from './instructions.js';\n\n/** MIME type used for all resource content */\nconst MIME_TYPE = 'application/json';\n\n/**\n * A single resource content item returned in resources/read responses\n */\nexport interface ResourceContent {\n  uri: string;\n  mimeType: string;\n  text: string;\n}\n\n/**\n * Shape of a resources/read response (re-export of SDK type for consumers)\n */\nexport type ReadResourceResult = McpReadResourceResult;\n\n/**\n * Shape of a static resource descriptor (resources/list)\n */\nexport interface StaticResource {\n  uri: string;\n  name: string;\n  description: string;\n  mimeType: string;\n}\n\n/**\n * Shape of a resource template descriptor (resources/templates/list)\n */\nexport interface ResourceTemplate {\n  uriTemplate: string;\n  name: string;\n  description: string;\n  mimeType: string;\n}\n\n// ---------------------------------------------------------------------------\n// Static resource definitions\n// ---------------------------------------------------------------------------\n\n/**\n * Static resources that are always available without API credentials\n */\nexport const STATIC_RESOURCES: StaticResource[] = [\n  {\n    uri: 'productive://schema',\n    name: 'Schema',\n    description: 'Overview of all Productive.io resources, their actions and filters',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uri: 'productive://instructions',\n    name: 'Instructions',\n    description: 'Server instructions and usage guide for the Productive.io MCP server',\n    mimeType: MIME_TYPE,\n  },\n];\n\n// ---------------------------------------------------------------------------\n// Dynamic resource definitions\n// ---------------------------------------------------------------------------\n\n/**\n * Dynamic resources that are computed at read time (require credentials)\n */\nexport const DYNAMIC_RESOURCES: StaticResource[] = [\n  {\n    uri: 'productive://summaries/my_day',\n    name: 'My Day',\n    description: \"Personal dashboard: open tasks, today's time entries, active timers\",\n    mimeType: MIME_TYPE,\n  },\n  {\n    uri: 'productive://summaries/team_pulse',\n    name: 'Team Pulse',\n    description: 'Team-wide time tracking activity for today',\n    mimeType: MIME_TYPE,\n  },\n];\n\n// ---------------------------------------------------------------------------\n// Resource template definitions\n// ---------------------------------------------------------------------------\n\n/**\n * Resource templates that accept URI parameters (require credentials)\n */\nexport const RESOURCE_TEMPLATES: ResourceTemplate[] = [\n  {\n    uriTemplate: 'productive://projects/{id}',\n    name: 'Project',\n    description: 'Details of a specific project by ID',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uriTemplate: 'productive://tasks/{id}',\n    name: 'Task',\n    description: 'Details of a specific task by ID',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uriTemplate: 'productive://people/{id}',\n    name: 'Person',\n    description: 'Details of a specific person by ID',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uriTemplate: 'productive://deals/{id}',\n    name: 'Deal',\n    description: 'Details of a specific deal or budget by ID',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uriTemplate: 'productive://projects/{id}/tasks',\n    name: 'Project Tasks',\n    description: 'All tasks belonging to a specific project',\n    mimeType: MIME_TYPE,\n  },\n  {\n    uriTemplate: 'productive://projects/{id}/services',\n    name: 'Project Services',\n    description: 'All services belonging to a specific project',\n    mimeType: MIME_TYPE,\n  },\n];\n\n// ---------------------------------------------------------------------------\n// URI pattern matching\n// ---------------------------------------------------------------------------\n\n/** Route patterns and their handler factories */\nconst URI_PATTERNS: Array<{\n  pattern: RegExp;\n  handler: (match: RegExpMatchArray, credentials: ProductiveCredentials) => Promise<unknown>;\n}> = [\n  // Static resources (no credentials needed)\n  {\n    pattern: /^productive:\\/\\/schema$/,\n    handler: async () => {\n      const result = handleSchemaOverview();\n      const text = result.content[0] as { text: string };\n      return JSON.parse(text.text);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/instructions$/,\n    handler: async () => ({ instructions: INSTRUCTIONS }),\n  },\n\n  // Dynamic summaries\n  {\n    pattern: /^productive:\\/\\/summaries\\/my_day$/,\n    handler: async (_, credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handleSummaries('my_day', {}, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/summaries\\/team_pulse$/,\n    handler: async (_, credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handleSummaries('team_pulse', {}, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n\n  // Project nested resources (before single project to avoid conflict)\n  {\n    pattern: /^productive:\\/\\/projects\\/([^/]+)\\/tasks$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials, { filter: { project_id: id } });\n      const result = await handleTasks('list', { project_id: id }, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/projects\\/([^/]+)\\/services$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials, { filter: { project_id: id } });\n      // handleServices uses CommonArgs; project_id is passed via ctx.filter\n      const result = await handleServices('list', {}, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n\n  // Single entity resources\n  {\n    pattern: /^productive:\\/\\/projects\\/([^/]+)$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handleProjects('get', { id }, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/tasks\\/([^/]+)$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handleTasks('get', { id }, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/people\\/([^/]+)$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handlePeople('get', { id }, ctx, credentials);\n      return extractJsonFromResult(result);\n    },\n  },\n  {\n    pattern: /^productive:\\/\\/deals\\/([^/]+)$/,\n    handler: async ([, id], credentials) => {\n      const ctx = buildHandlerContext(credentials);\n      const result = await handleDeals('get', { id }, ctx);\n      return extractJsonFromResult(result);\n    },\n  },\n];\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Build a HandlerContext from credentials, with optional filter overrides.\n */\nfunction buildHandlerContext(\n  credentials: ProductiveCredentials,\n  overrides: { filter?: Record<string, string> } = {},\n): HandlerContext {\n  const api = new ProductiveApi({\n    config: {\n      apiToken: credentials.apiToken,\n      organizationId: credentials.organizationId,\n      userId: credentials.userId,\n      baseUrl: process.env.PRODUCTIVE_BASE_URL,\n    },\n  });\n\n  const execCtx = fromHandlerContext({ api }, { userId: credentials.userId });\n\n  return {\n    formatOptions: { compact: false },\n    filter: overrides.filter,\n    perPage: 50,\n    includeHints: false,\n    includeSuggestions: false,\n    executor: () => execCtx,\n  };\n}\n\n/**\n * Extract the parsed JSON data from a ToolResult.\n * Throws if the result is an error or not parseable.\n */\nfunction extractJsonFromResult(result: { content: unknown[]; isError?: boolean }): unknown {\n  if (result.isError) {\n    const text = (result.content[0] as { text: string }).text;\n    throw new Error(text);\n  }\n  const text = (result.content[0] as { text: string }).text;\n  try {\n    return JSON.parse(text);\n  } catch {\n    return { text };\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * List all static and dynamic resources (no credentials needed for static).\n */\nexport function listResources(): StaticResource[] {\n  return [...STATIC_RESOURCES, ...DYNAMIC_RESOURCES];\n}\n\n/**\n * List all resource templates.\n */\nexport function listResourceTemplates(): ResourceTemplate[] {\n  return RESOURCE_TEMPLATES;\n}\n\n/**\n * Read a resource by URI.\n *\n * Routes the URI to the appropriate handler. Throws on unknown URI.\n */\nexport async function readResource(\n  uri: string,\n  credentials: ProductiveCredentials,\n): Promise<ReadResourceResult> {\n  for (const { pattern, handler } of URI_PATTERNS) {\n    const match = uri.match(pattern);\n    if (match) {\n      const data = await handler(match, credentials);\n      return {\n        contents: [\n          {\n            uri,\n            mimeType: MIME_TYPE,\n            text: JSON.stringify(data, null, 2),\n          },\n        ],\n      };\n    }\n  }\n\n  throw new Error(\n    `Unknown resource URI: ${uri}. ` +\n      `Available static resources: ${STATIC_RESOURCES.map((r) => r.uri).join(', ')}. ` +\n      `Available dynamic resources: ${DYNAMIC_RESOURCES.map((r) => r.uri).join(', ')}. ` +\n      `Resource templates: ${RESOURCE_TEMPLATES.map((t) => t.uriTemplate).join(', ')}.`,\n  );\n}\n","/**\n * Package version - injected from package.json at build time\n */\ndeclare const __VERSION__: string;\nexport const VERSION = __VERSION__;\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studiometa/productive-mcp",
-  "version": "0.10.10",
+  "version": "0.10.12",
   "description": "MCP server for Productive.io API - Model Context Protocol integration for Claude Desktop",
   "keywords": [
     "ai",
@@ -82,15 +82,15 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "@studiometa/productive-api": "0.10.10",
-    "@studiometa/productive-core": "0.10.10",
+    "@studiometa/productive-api": "0.10.12",
+    "@studiometa/productive-core": "0.10.12",
     "h3": "^2.0.1-rc.14",
     "zod": "4.3.6"
   },
   "devDependencies": {
-    "@vitest/coverage-v8": "^4.1.0-beta.5",
-    "vite": "^8.0.0-beta.16",
-    "vitest": "^4.1.0-beta.5"
+    "@vitest/coverage-v8": "^4.1.7",
+    "vite": "^8.0.14",
+    "vitest": "^4.1.7"
   },
   "engines": {
     "node": ">=24.0.0"

package/skills/SKILL.md

@@ -11,7 +11,11 @@ MCP (Model Context Protocol) server for Productive.io. Provides a single unified
 
 Before your first interaction with any resource, call `action=help` with that resource to discover valid filters, required fields, includes, and examples.
 
-## The `productive` Tool
+## MCP Tools
+
+This server exposes one high-level tool and two low-level raw API tools.
+
+### `productive`
 
 Single unified tool with this signature:
 
@@ -878,6 +882,111 @@ Returns: deal details + services + comments + time entries
 - 480 = 8 hours (full day)
 - 240 = 4 hours (half day)
 
+## Raw API Tools
+
+Use raw API tools only as escape hatches when the unified `productive` tool does not support the documented endpoint you need.
+
+### `api_read`
+
+Read-only access to documented Productive `GET` endpoints.
+
+**Use it for:** unsupported read endpoints, inspecting endpoint capabilities, or fetching raw shapes.
+
+**Parameters**
+
+- `path` — required relative API path starting with `/`
+- `describe` — return endpoint documentation instead of executing
+- `filter` — validated against the endpoint spec
+- `include` — related resources to include
+- `sort` — validated sort values
+- `page`, `per_page` — page number and size (`per_page` max `200`)
+- `paginate`, `max_pages` — safe auto-pagination (`max_pages` default `20`, max `50`)
+
+**Safety model**
+
+- `GET` only
+- relative paths only; absolute URLs are rejected
+- path traversal is rejected
+- only documented Productive endpoints are allowed
+- filter fields, operators, and sort values are validated
+
+**Recommended workflow**
+
+1. Call `api_read` with `describe=true`
+2. Review allowed methods, filters, and sort values
+3. Make the real read call with the validated path and params
+
+**Examples**
+
+```json
+{ "path": "/invoices", "describe": true }
+```
+
+```json
+{
+  "path": "/projects/123/tasks",
+  "filter": { "status": "open" },
+  "sort": ["due_date"],
+  "per_page": 50
+}
+```
+
+### `api_write`
+
+Raw write access to documented Productive endpoints.
+
+**Use it only when:** the user explicitly wants a mutation and the higher-level `productive` tool cannot perform it.
+
+**Parameters**
+
+- `method` — required, one of `POST`, `PATCH`, `PUT`, `DELETE`
+- `path` — required relative API path
+- `body` — request payload
+- `confirm` — required, must be `true`
+- `dry_run` — preview the normalized request without executing it
+
+**Safety model**
+
+- disabled by default
+- requires server env `PRODUCTIVE_MCP_ENABLE_API_WRITE=true`
+- requires `confirm=true` on every call
+- only documented Productive endpoints are allowed
+- relative paths only; absolute URLs and traversal are rejected
+- prefer `dry_run=true` before the real write
+
+**Agent rules**
+
+1. Do not use `api_write` for routine mutations already covered by `productive`
+2. Always confirm intent with the user before using `api_write`
+3. Prefer `dry_run=true` first, then execute only after approval
+4. Preserve Productive payloads exactly; do not invent fields or IDs
+
+**Examples**
+
+```json
+{
+  "method": "PATCH",
+  "path": "/tasks/123",
+  "body": {
+    "data": {
+      "type": "tasks",
+      "id": "123",
+      "attributes": { "name": "Updated title" }
+    }
+  },
+  "confirm": true,
+  "dry_run": true
+}
+```
+
+```json
+{
+  "method": "DELETE",
+  "path": "/attachments/456",
+  "confirm": true
+}
+```
+
 ## Configuration Tools (stdio mode only)
 
 In local/stdio mode, additional configuration tools are available:
@@ -918,6 +1027,9 @@ Key points:
 5. **Check `people.me`** first to get the current user's ID for filters
 6. **Follow `_hints`** - When getting a resource, check the `_hints` field for suggestions on fetching related context
 7. **Act on `_suggestions`** - When present, `_suggestions` highlight data issues (overdue tasks, no time logged, etc.) that may need attention or should be surfaced to the user
+8. **Prefer `api_read` over `api_write`** when a raw endpoint is needed
+9. **Use `api_read.describe=true` first** before making raw API calls
+10. **Treat `api_write` as break-glass access** - confirm, dry-run, then execute
 
 ## Prompt Templates