@togglhq/cli 1.5.28 → 1.5.29

package/README.md

@@ -78,7 +78,7 @@ toggl [global flags] <group> … <subcommand> [flags]
 
 Many endpoints use two segments (`toggl tasks list`). Some use nested groups, including:
 
-- **`toggl organization …`** — organization APIs (not `toggl org …`; there is no `org` top-level command). Examples: `toggl organization invitations list`, `toggl organization members get`, `toggl organization workspaces list`.
+- **`toggl organization …`** — organization APIs (not `toggl org …`; there is no `org` top-level command). Examples: `toggl organization invitations list`, `toggl organization members get`, `toggl organization workspaces list`, `toggl organization workspaces get-timezone`, `toggl organization workspaces update-timezone`.
 - **`toggl shared …`** — shared workspace/org data routed through `@toggl/queries` helpers (status, holidays, working hours, time off). Example: `toggl shared status get`.
 
 Core resource groups still include `tasks`, `projects`, `time-blocks`, `time-entries`, `statuses`, `users`, `tags`, `clients`, and others surfaced by the public command catalog. Some low-level endpoints are omitted from the CLI and MCP. Existing public command paths and operation IDs stay stable; use `toggl --help` and `toggl <group> --help` to explore what shipped.

package/build/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as CommanderError, t as createProgram } from "./program-CwW_34U6.js";
+import { n as CommanderError, t as createProgram } from "./program-0krLPqUR.js";
 //#region src/cli.ts
 try {
 	await createProgram({ enableUpdateNotification: true }).parseAsync(process.argv);

package/build/index.js

@@ -1,2 +1,2 @@
-import { t as createProgram } from "./program-CwW_34U6.js";
+import { t as createProgram } from "./program-0krLPqUR.js";
 export { createProgram };

package/build/{program-CwW_34U6.js → program-0krLPqUR.js}

@@ -7670,6 +7670,31 @@ function looseObject(entries$1, message$1) {
 	};
 }
 /* @__NO_SIDE_EFFECTS__ */
+function nullable$1(wrapped, default_) {
+	return {
+		kind: "schema",
+		type: "nullable",
+		reference: nullable$1,
+		expects: `(${wrapped.expects} | null)`,
+		async: false,
+		wrapped,
+		default: default_,
+		get "~standard"() {
+			return /* @__PURE__ */ _getStandardProps$1(this);
+		},
+		"~run"(dataset, config$1) {
+			if (dataset.value === null) {
+				if (this.default !== void 0) dataset.value = /* @__PURE__ */ getDefault$1(this, dataset, config$1);
+				if (dataset.value === null) {
+					dataset.typed = true;
+					return dataset;
+				}
+			}
+			return this.wrapped["~run"](dataset, config$1);
+		}
+	};
+}
+/* @__NO_SIDE_EFFECTS__ */
 function number$2(message$1) {
 	return {
 		kind: "schema",
@@ -10592,6 +10617,15 @@ async function patchOrganizationUserActive(httpClient, organization_id, organiza
 async function getWorkspaces(httpClient, organization_id, signal) {
 	return (await httpClient.get(`organizations/${organization_id}/workspaces`, { signal })).json();
 }
+async function getWorkspaceTimezone(httpClient, organization_id, workspace_id, signal) {
+	return (await httpClient.get(`organizations/${organization_id}/workspaces/${workspace_id}/settings/timezone`, { signal })).json();
+}
+async function putWorkspaceTimezone(httpClient, organization_id, workspace_id, data, signal) {
+	return (await httpClient.put(`organizations/${organization_id}/workspaces/${workspace_id}/settings/timezone`, {
+		signal,
+		json: data
+	})).json();
+}
 async function getWorkspaceUserMeRoles(httpClient, organization_id, workspace_id, signal) {
 	return (await httpClient.get(`organizations/${organization_id}/workspaces/${workspace_id}/users/me/roles`, { signal })).json();
 }
@@ -10702,7 +10736,7 @@ async function deleteMyWorkingHours(httpClient, organization_id, data, signal) {
 	return response.json();
 }
 //#endregion
-//#region ../cli-core/build/focus-client-7dpDsjfZ.js
+//#region ../cli-core/build/focus-client-BTk5v8IS.js
 const DATE_ONLY_RE = /^\d{4}-\d{2}-\d{2}$/;
 function normalizeDateFrom(value) {
 	return DATE_ONLY_RE.test(value) ? `${value}T00:00:00Z` : value;
@@ -11500,6 +11534,20 @@ var FocusClient = class {
 			data: response.data
 		} : response;
 	}
+	async getOrgWorkspaceTimezone(workspaceId) {
+		const response = await this.run("getOrgWorkspaceTimezone", () => getWorkspaceTimezone(this.orgHttp, this.organizationIdNum, workspaceId));
+		return response.ok ? {
+			ok: true,
+			data: response.data
+		} : response;
+	}
+	async updateOrgWorkspaceTimezone(workspaceId, payload) {
+		const response = await this.run("updateOrgWorkspaceTimezone", () => putWorkspaceTimezone(this.orgHttp, this.organizationIdNum, workspaceId, payload));
+		return response.ok ? {
+			ok: true,
+			data: response.data
+		} : response;
+	}
 	async getSharedDataStatus() {
 		const response = await this.run("getSharedDataStatus", () => getStatus(this.sharedDataHttp));
 		return this.softValidateResponse("getSharedDataStatus", StatusOKSchema, response);
@@ -12390,7 +12438,7 @@ async function runSkillSetup(options) {
 	});
 }
 //#endregion
-//#region ../operations/build/safety-BSD7hS5Z.js
+//#region ../operations/build/safety-B7a8yXtb.js
 const optionalNumber = /* @__PURE__ */ optional$1(/* @__PURE__ */ number$2());
 const DATE_FIELD_RE = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2}))?$/;
 const dateField = (description) => /* @__PURE__ */ pipe$2(/* @__PURE__ */ string$1(), /* @__PURE__ */ regex(DATE_FIELD_RE, "must be YYYY-MM-DD or RFC3339 datetime (e.g. '2025-01-01' or '2025-01-01T00:00:00Z')"), /* @__PURE__ */ description$1(description));
@@ -13538,6 +13586,71 @@ const orgSharedOperations = [
 			return client.getMyWorkspaceRoles(body.workspace_id ?? Number.parseInt(client.workspaceId, 10));
 		}
 	},
+	{
+		id: "org.workspaces.get-timezone",
+		family: "org",
+		resource: "workspaces",
+		action: "get-timezone",
+		title: "Get workspace timezone",
+		description: "Get the workspace-level default timezone (null when unset). Requires organization admin.",
+		agentGuidance: "Use when you need the org-wide default timezone for a workspace. When timezone is null, members use their personal timezones.",
+		safety: "read",
+		destructive: false,
+		cli: {
+			group: ["organization", "workspaces"],
+			command: "get-timezone",
+			examples: [{
+				description: "Get timezone for the active workspace",
+				data: {}
+			}, {
+				description: "Get timezone for a specific workspace",
+				data: { workspace_id: 40770900 }
+			}]
+		},
+		mcp: { entityTool: "org-workspaces" },
+		inputSchema: /* @__PURE__ */ object$2({ workspace_id: /* @__PURE__ */ optional$1(/* @__PURE__ */ pipe$2(/* @__PURE__ */ number$2(), /* @__PURE__ */ description$1("Workspace ID (defaults to profile)"))) }),
+		execute: (input, { client }) => {
+			const body = input;
+			return client.getOrgWorkspaceTimezone(body.workspace_id ?? client.workspaceIdNumber);
+		}
+	},
+	{
+		id: "org.workspaces.update-timezone",
+		family: "org",
+		resource: "workspaces",
+		action: "update-timezone",
+		title: "Update workspace timezone",
+		description: "Set or clear the workspace-level default timezone. Requires organization admin.",
+		agentGuidance: "Set timezone to an IANA name (e.g. Europe/London) or clear with clear: true / timezone: null so members fall back to personal timezones.",
+		safety: "update",
+		destructive: false,
+		cli: {
+			group: ["organization", "workspaces"],
+			command: "update-timezone",
+			examples: [{
+				description: "Set default timezone for the active workspace",
+				data: { timezone: "Europe/London" }
+			}, {
+				description: "Clear workspace default timezone",
+				data: { clear: true }
+			}]
+		},
+		mcp: { entityTool: "org-workspaces" },
+		inputSchema: /* @__PURE__ */ object$2({
+			workspace_id: /* @__PURE__ */ optional$1(/* @__PURE__ */ pipe$2(/* @__PURE__ */ number$2(), /* @__PURE__ */ description$1("Workspace ID (defaults to profile)"))),
+			timezone: /* @__PURE__ */ optional$1(/* @__PURE__ */ nullable$1(/* @__PURE__ */ pipe$2(/* @__PURE__ */ string$1(), /* @__PURE__ */ description$1("IANA timezone (e.g. \"Europe/London\"), or null to clear")))),
+			clear: /* @__PURE__ */ optional$1(/* @__PURE__ */ pipe$2(/* @__PURE__ */ boolean$1(), /* @__PURE__ */ description$1("Clear workspace default timezone")))
+		}),
+		execute: (input, { client }) => {
+			const body = input;
+			const workspaceId = body.workspace_id ?? client.workspaceIdNumber;
+			const clearsTimezone = body.clear === true || body.timezone === null;
+			if (clearsTimezone && typeof body.timezone === "string") throw new Error("Pass either a timezone string or clear/null, not both");
+			if (clearsTimezone) return client.updateOrgWorkspaceTimezone(workspaceId, { timezone: null });
+			if (body.timezone === void 0) throw new Error("Pass --timezone <IANA>, --clear true, or timezone: null to remove the default");
+			return client.updateOrgWorkspaceTimezone(workspaceId, { timezone: body.timezone });
+		}
+	},
 	{
 		id: "shared.status.get",
 		family: "shared",
@@ -25339,4 +25452,4 @@ Common commands:
 //#endregion
 export { CommanderError as n, createProgram as t };
 
-//# sourceMappingURL=program-CwW_34U6.js.map
+//# sourceMappingURL=program-0krLPqUR.js.map

package/build/program.js

@@ -1,2 +1,2 @@
-import { t as createProgram } from "./program-CwW_34U6.js";
+import { t as createProgram } from "./program-0krLPqUR.js";
 export { createProgram };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@togglhq/cli",
-  "version": "1.5.28",
+  "version": "1.5.29",
   "description": "Toggl CLI for Toggl 2.0 API operations.",
   "license": "UNLICENSED",
   "type": "module",

package/skills/toggl-cli/reference/command-contract.md

@@ -21,6 +21,9 @@ toggl --workspace-id 789012 tasks list --project-id 123456
 ```bash
 toggl organization invitations list
 toggl organization workspaces list
+toggl organization workspaces get-timezone
+toggl organization workspaces update-timezone --timezone Europe/London
+toggl organization workspaces update-timezone --clear true
 toggl shared status get
 toggl shared holidays list
 ```