@togglhq/mcp 1.11.223 → 1.11.225

package/build/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as getProductAnalyticsDistinctId, c as resolvePublicSentryDsn, i as captureToolInvocation, l as shutdownProductAnalytics, n as runMcpCli, o as initProductAnalytics, r as PUBLIC_SENTRY_PRIVACY_OPTIONS, s as resolveProductAnalyticsDistinctId } from "./src-DldEugLk.js";
+import { a as getProductAnalyticsDistinctId, c as resolvePublicSentryDsn, i as captureToolInvocation, l as shutdownProductAnalytics, n as runMcpCli, o as initProductAnalytics, r as PUBLIC_SENTRY_PRIVACY_OPTIONS, s as resolveProductAnalyticsDistinctId } from "./src-H-pxotgE.js";
 import * as Sentry from "@sentry/node";
 //#region src/analytics-tool-metadata.ts
 /**
@@ -162,7 +162,7 @@ function wrapServerWithProductAnalytics(server) {
 }
 //#endregion
 //#region src/cli.ts
-const packageVersion = "1.11.223";
+const packageVersion = "1.11.225";
 let sentryEnabled = false;
 let productAnalyticsEnabled = false;
 runMcpCli({

package/build/index.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import { n as runMcpCli, t as bootstrapServer } from "./src-DldEugLk.js";
+import { n as runMcpCli, t as bootstrapServer } from "./src-H-pxotgE.js";
 export { bootstrapServer, runMcpCli };

package/build/{src-DldEugLk.js → src-H-pxotgE.js}

@@ -35325,7 +35325,7 @@ const TaskCreatePayloadSchema = /* @__PURE__ */ object({
 	color: /* @__PURE__ */ optional(/* @__PURE__ */ string()),
 	custom_fields: /* @__PURE__ */ optional(/* @__PURE__ */ record(/* @__PURE__ */ string(), /* @__PURE__ */ unknown())),
 	description: /* @__PURE__ */ optional(/* @__PURE__ */ string()),
-	end_date: /* @__PURE__ */ optional(/* @__PURE__ */ pipe(/* @__PURE__ */ string(), /* @__PURE__ */ isoDate())),
+	end_date: /* @__PURE__ */ optional(/* @__PURE__ */ pipe(/* @__PURE__ */ pipe(/* @__PURE__ */ string(), /* @__PURE__ */ isoDate()), /* @__PURE__ */ description("Send together with start_date; must be on or after start_date."))),
 	estimate_type: /* @__PURE__ */ optional(/* @__PURE__ */ picklist(["daily", "total"])),
 	estimated_mins: /* @__PURE__ */ optional(/* @__PURE__ */ pipe(/* @__PURE__ */ number(), /* @__PURE__ */ minValue(0))),
 	notes: /* @__PURE__ */ optional(/* @__PURE__ */ string()),
@@ -35343,7 +35343,7 @@ const TaskCreatePayloadSchema = /* @__PURE__ */ object({
 	project_id: /* @__PURE__ */ optional(/* @__PURE__ */ number()),
 	rollup_enabled: /* @__PURE__ */ optional(/* @__PURE__ */ boolean()),
 	rrule: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ string())),
-	start_date: /* @__PURE__ */ optional(/* @__PURE__ */ pipe(/* @__PURE__ */ string(), /* @__PURE__ */ isoDate())),
+	start_date: /* @__PURE__ */ optional(/* @__PURE__ */ pipe(/* @__PURE__ */ pipe(/* @__PURE__ */ string(), /* @__PURE__ */ isoDate()), /* @__PURE__ */ description("Send together with end_date; a date without the other is rejected."))),
 	status_id: /* @__PURE__ */ optional(/* @__PURE__ */ number()),
 	tag_ids: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ array(/* @__PURE__ */ number()))),
 	team_assignee_ids: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ array(/* @__PURE__ */ number())))
@@ -35365,7 +35365,7 @@ const TaskPartialUpdatePayloadSchema = /* @__PURE__ */ object({
 	color: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ string())),
 	custom_fields: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ object({}))),
 	description: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ string())),
-	end_date: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ pipe(/* @__PURE__ */ string(), /* @__PURE__ */ isoDate()))),
+	end_date: /* @__PURE__ */ optional(/* @__PURE__ */ pipe(/* @__PURE__ */ nullable(/* @__PURE__ */ pipe(/* @__PURE__ */ string(), /* @__PURE__ */ isoDate())), /* @__PURE__ */ description("Send together with start_date; must be on or after start_date."))),
 	estimate_type: /* @__PURE__ */ optional(/* @__PURE__ */ picklist(["daily", "total"])),
 	estimated_mins: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ pipe(/* @__PURE__ */ number(), /* @__PURE__ */ minValue(0)))),
 	name: /* @__PURE__ */ optional(/* @__PURE__ */ string()),
@@ -35388,7 +35388,7 @@ const TaskPartialUpdatePayloadSchema = /* @__PURE__ */ object({
 	repeat_planned_time_entry_id: /* @__PURE__ */ optional(/* @__PURE__ */ pipe(/* @__PURE__ */ nullable(/* @__PURE__ */ number()), /* @__PURE__ */ description("RepeatPlannedTimeEntryID is the declared initial-selection input that will start a series from an existing planned entry (PR 11). Any supplied value — an ID or JSON null — is rejected until then; the contract is declared in docs/recurring-pr2a-additive-schema.md. json.RawMessage keeps absent distinguishable from explicit null on decode and is omitted on marshal when never set."))),
 	rollup_enabled: /* @__PURE__ */ optional(/* @__PURE__ */ boolean()),
 	rrule: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ string())),
-	start_date: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ pipe(/* @__PURE__ */ string(), /* @__PURE__ */ isoDate()))),
+	start_date: /* @__PURE__ */ optional(/* @__PURE__ */ pipe(/* @__PURE__ */ nullable(/* @__PURE__ */ pipe(/* @__PURE__ */ string(), /* @__PURE__ */ isoDate())), /* @__PURE__ */ description("Send together with end_date; a date without the other is rejected."))),
 	status_id: /* @__PURE__ */ optional(/* @__PURE__ */ number()),
 	tag_ids: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ array(/* @__PURE__ */ number()))),
 	team_assignee_ids: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ array(/* @__PURE__ */ number())))
@@ -35403,7 +35403,7 @@ const TaskPartialUpdatePayloadWithIDSchema = /* @__PURE__ */ object({
 	color: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ string())),
 	custom_fields: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ object({}))),
 	description: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ string())),
-	end_date: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ pipe(/* @__PURE__ */ string(), /* @__PURE__ */ isoDate()))),
+	end_date: /* @__PURE__ */ optional(/* @__PURE__ */ pipe(/* @__PURE__ */ nullable(/* @__PURE__ */ pipe(/* @__PURE__ */ string(), /* @__PURE__ */ isoDate())), /* @__PURE__ */ description("Send together with start_date; must be on or after start_date."))),
 	estimate_type: /* @__PURE__ */ optional(/* @__PURE__ */ picklist(["daily", "total"])),
 	estimated_mins: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ pipe(/* @__PURE__ */ number(), /* @__PURE__ */ minValue(0)))),
 	name: /* @__PURE__ */ optional(/* @__PURE__ */ string()),
@@ -35425,7 +35425,7 @@ const TaskPartialUpdatePayloadWithIDSchema = /* @__PURE__ */ object({
 	repeat_planned_time_entry_id: /* @__PURE__ */ optional(/* @__PURE__ */ pipe(/* @__PURE__ */ nullable(/* @__PURE__ */ number()), /* @__PURE__ */ description("RepeatPlannedTimeEntryID is the declared initial-selection input that will start a series from an existing planned entry (PR 11). Any supplied value — an ID or JSON null — is rejected until then; the contract is declared in docs/recurring-pr2a-additive-schema.md. json.RawMessage keeps absent distinguishable from explicit null on decode and is omitted on marshal when never set."))),
 	rollup_enabled: /* @__PURE__ */ optional(/* @__PURE__ */ boolean()),
 	rrule: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ string())),
-	start_date: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ pipe(/* @__PURE__ */ string(), /* @__PURE__ */ isoDate()))),
+	start_date: /* @__PURE__ */ optional(/* @__PURE__ */ pipe(/* @__PURE__ */ nullable(/* @__PURE__ */ pipe(/* @__PURE__ */ string(), /* @__PURE__ */ isoDate())), /* @__PURE__ */ description("Send together with end_date; a date without the other is rejected."))),
 	status_id: /* @__PURE__ */ optional(/* @__PURE__ */ number()),
 	tag_ids: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ array(/* @__PURE__ */ number()))),
 	team_assignee_ids: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ array(/* @__PURE__ */ number())))
@@ -40592,7 +40592,7 @@ function createAuthenticatedClientProxy() {
 	} });
 }
 //#endregion
-//#region ../operations/build/validation-CLozpAO5.js
+//#region ../operations/build/validation-B7kaDM75.js
 const optionalNumber = /* @__PURE__ */ optional$1(/* @__PURE__ */ number$2());
 const perPageField = (max) => /* @__PURE__ */ optional$1(/* @__PURE__ */ pipe$2(/* @__PURE__ */ number$2(), /* @__PURE__ */ integer(), /* @__PURE__ */ minValue$1(1), /* @__PURE__ */ maxValue$1(max), /* @__PURE__ */ description$1(`Results per page (1-${max})`)));
 const perPageSchema = perPageField(100);
@@ -40874,6 +40874,107 @@ const rateOverrides = {
 	"focus.rates.labor-upsert-workspace-labor-cost-rate": { agentGuidance: RATE_SCHEDULE_GUIDANCE },
 	"focus.rates.labor-upsert-workspace-user-labor-cost-rate": { agentGuidance: RATE_SCHEDULE_GUIDANCE }
 };
+const TASK_DATES_RULE = "Send start_date and end_date together, with end_date on or after start_date";
+const TASK_DATES_CREATE_GUIDANCE = `${TASK_DATES_RULE}; for a single due date, send both as that day.`;
+const taskOverrides = {
+	"focus.tasks.list": {
+		aliases: ["ls"],
+		agentGuidance: "Filter by start_date/end_date (ISO 8601, e.g. '2025-04-27') for date ranges, project_id, status_id, or assignee_user_id. Returns paginated results — use page/per_page for more. Use parent_task_id to list subtasks. Priority values: none, low, medium, high.",
+		examples: [
+			{
+				description: "List tasks due today",
+				data: {
+					start_date: "2025-04-27",
+					end_date: "2025-04-27"
+				}
+			},
+			{
+				description: "List tasks for a project",
+				data: { project_id: 123456 }
+			},
+			{
+				description: "List high-priority open tasks",
+				data: { priority: "high" }
+			}
+		]
+	},
+	"focus.tasks.get": { agentGuidance: "Fetch a single task with full detail including subtasks and time estimates." },
+	"focus.tasks.create": {
+		agentGuidance: `Required: name. Strongly recommended: project_id, status_id, assignee_user_ids. Use start_date/end_date for scheduling as date-only YYYY-MM-DD values; never pass RFC 3339 datetimes. ${TASK_DATES_CREATE_GUIDANCE} Set estimated_mins for time estimates.`,
+		examples: [{
+			description: "Create a minimal task",
+			data: { name: "Dogfood the CLI" }
+		}, {
+			description: "Create a task with full metadata",
+			data: {
+				name: "Review PR",
+				project_id: 123456,
+				assignee_user_ids: [789],
+				estimated_mins: 30
+			}
+		}]
+	},
+	"focus.tasks.update": {
+		agentGuidance: `Partial update — only include fields to change in payload. Provide task_id at top level and the fields to update under payload. custom_fields writes values as a map keyed by custom field ID; reads return the same data as custom_field_values[], so the write shape is not the read shape. ${TASK_DATES_RULE}; to move one date, resend the task's current other date; if the task has none, or that breaks the order, send the new date as both.`,
+		examples: [
+			{
+				description: "Change task status",
+				data: {
+					task_id: 12345,
+					payload: { status_id: 456789 }
+				}
+			},
+			{
+				description: "Assign to a user and update estimate",
+				data: {
+					task_id: 12345,
+					payload: {
+						assignee_user_ids: [789],
+						estimated_mins: 60
+					}
+				}
+			},
+			{
+				description: "Set a select custom field value",
+				data: {
+					task_id: 12345,
+					payload: { custom_fields: { "406": [1639] } }
+				}
+			}
+		]
+	},
+	"focus.tasks.full-update": { agentGuidance: "Follow the update action's date guidance." },
+	"focus.tasks.delete": { agentGuidance: "Permanently deletes the task and all its subtasks. Cannot be undone." },
+	"focus.tasks.bulk-patch": {
+		agentGuidance: "Prefer over many single updates: pass a JSON array of { id: taskId, ...partial fields }. Same field names and date guidance as single task update.",
+		examples: [{
+			description: "Set status on two tasks",
+			data: [{
+				id: 111,
+				status_id: 456789
+			}, {
+				id: 222,
+				status_id: 456789
+			}]
+		}, {
+			description: "Set a select custom field value on two tasks",
+			data: [{
+				id: 111,
+				custom_fields: { "406": [1639] }
+			}, {
+				id: 222,
+				custom_fields: { "406": [1640] }
+			}]
+		}]
+	},
+	"focus.tasks.bulk-delete": {
+		agentGuidance: "Deletes all listed task IDs in one HTTP call. Requires confirm flow like single delete.",
+		examples: [{
+			description: "Delete two tasks",
+			data: { ids: [111, 222] }
+		}]
+	}
+};
 const compositeOverrides = {
 	"focus.composite.create-project": {
 		description: "Create a project with related data such as members, milestones, rates, and billable rates.",
@@ -40887,6 +40988,7 @@ const compositeOverrides = {
 	},
 	"focus.composite.create-task": {
 		description: "Create a task with related data such as subtasks and an initial time entry.",
+		agentGuidance: `For payload.task and each payload.subtasks[] item: ${TASK_DATES_CREATE_GUIDANCE}`,
 		cli: {
 			group: ["tasks"],
 			command: "create-with-children",
@@ -41377,104 +41479,6 @@ const tagOverrides = {
 		}]
 	}
 };
-const taskOverrides = {
-	"focus.tasks.list": {
-		aliases: ["ls"],
-		agentGuidance: "Filter by start_date/end_date (ISO 8601, e.g. '2025-04-27') for date ranges, project_id, status_id, or assignee_user_id. Returns paginated results — use page/per_page for more. Use parent_task_id to list subtasks. Priority values: none, low, medium, high.",
-		examples: [
-			{
-				description: "List tasks due today",
-				data: {
-					start_date: "2025-04-27",
-					end_date: "2025-04-27"
-				}
-			},
-			{
-				description: "List tasks for a project",
-				data: { project_id: 123456 }
-			},
-			{
-				description: "List high-priority open tasks",
-				data: { priority: "high" }
-			}
-		]
-	},
-	"focus.tasks.get": { agentGuidance: "Fetch a single task with full detail including subtasks and time estimates." },
-	"focus.tasks.create": {
-		agentGuidance: "Required: name. Strongly recommended: project_id, status_id, assignee_user_ids. Use start_date/end_date for scheduling as date-only YYYY-MM-DD values; never pass RFC 3339 datetimes. Set estimated_mins for time estimates.",
-		examples: [{
-			description: "Create a minimal task",
-			data: { name: "Dogfood the CLI" }
-		}, {
-			description: "Create a task with full metadata",
-			data: {
-				name: "Review PR",
-				project_id: 123456,
-				assignee_user_ids: [789],
-				estimated_mins: 30
-			}
-		}]
-	},
-	"focus.tasks.update": {
-		agentGuidance: "Partial update — only include fields to change in payload. Provide task_id at top level and the fields to update under payload. custom_fields writes values as a map keyed by custom field ID; reads return the same data as custom_field_values[], so the write shape is not the read shape.",
-		examples: [
-			{
-				description: "Change task status",
-				data: {
-					task_id: 12345,
-					payload: { status_id: 456789 }
-				}
-			},
-			{
-				description: "Assign to a user and update estimate",
-				data: {
-					task_id: 12345,
-					payload: {
-						assignee_user_ids: [789],
-						estimated_mins: 60
-					}
-				}
-			},
-			{
-				description: "Set a select custom field value",
-				data: {
-					task_id: 12345,
-					payload: { custom_fields: { "406": [1639] } }
-				}
-			}
-		]
-	},
-	"focus.tasks.delete": { agentGuidance: "Permanently deletes the task and all its subtasks. Cannot be undone." },
-	"focus.tasks.bulk-patch": {
-		agentGuidance: "Prefer over many single updates: pass a JSON array of { id: taskId, ...partial fields }. Same field names as single task update.",
-		examples: [{
-			description: "Set status on two tasks",
-			data: [{
-				id: 111,
-				status_id: 456789
-			}, {
-				id: 222,
-				status_id: 456789
-			}]
-		}, {
-			description: "Set a select custom field value on two tasks",
-			data: [{
-				id: 111,
-				custom_fields: { "406": [1639] }
-			}, {
-				id: 222,
-				custom_fields: { "406": [1640] }
-			}]
-		}]
-	},
-	"focus.tasks.bulk-delete": {
-		agentGuidance: "Deletes all listed task IDs in one HTTP call. Requires confirm flow like single delete.",
-		examples: [{
-			description: "Delete two tasks",
-			data: { ids: [111, 222] }
-		}]
-	}
-};
 const timeEntryOverrides = {
 	"focus.time-entries.list": {
 		agentGuidance: "Returns tracked time entries in a date range, including taskless entries (tracked on a project with no task). Requires date_from and date_to. Accepts date-only strings (YYYY-MM-DD) or RFC3339 datetimes — date-only is automatically expanded: date_from to T00:00:00Z, date_to to T23:59:59Z. Optional project_id keeps only entries on that project (sent to the API; client also scans up to 50 list pages of 100, then slices page/per_page; not a full workspace scan). If truncated is true, more unfiltered rows exist than were scanned — narrow date_from/date_to. Pass include_taskless:false to hide taskless rows. Includes task and project context.",
@@ -56221,7 +56225,7 @@ function registerWorkspaceTools(server) {
 //#region src/package-version.ts
 function mcpPackageVersion() {
 	try {
-		return "1.11.223";
+		return "1.11.225";
 	} catch {
 		return "unknown";
 	}
@@ -56396,7 +56400,7 @@ import_main.default.config({
 	quiet: true,
 	ignore: ["MISSING_ENV_FILE"]
 });
-const packageVersion = "1.11.223";
+const packageVersion = "1.11.225";
 function resolvePublicUrls() {
 	return {
 		focusApiUrl: process.env.TOGGL_FOCUS_API_URL ?? "https://focus.toggl.com",
@@ -56461,4 +56465,4 @@ function bootstrapServer(options = {}) {
 //#endregion
 export { getProductAnalyticsDistinctId as a, resolvePublicSentryDsn as c, captureToolInvocation as i, shutdownProductAnalytics as l, runMcpCli as n, initProductAnalytics as o, PUBLIC_SENTRY_PRIVACY_OPTIONS as r, resolveProductAnalyticsDistinctId as s, bootstrapServer as t };
 
-//# sourceMappingURL=src-DldEugLk.js.map
+//# sourceMappingURL=src-H-pxotgE.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@togglhq/mcp",
-  "version": "1.11.223",
+  "version": "1.11.225",
   "description": "Toggl 2.0 MCP server for Claude Code, Claude Desktop, and other MCP clients.",
   "license": "UNLICENSED",
   "type": "module",