@trainheroic-unofficial/athlete-mcp 0.4.0 → 0.4.1

package/dist/server.mjs

@@ -848,6 +848,45 @@ async function logAthleteSet(client, args) {
 		exercisesLogged
 	};
 }
+/**
+* POST /v5/programWorkouts/personal — create a personal workout session for a given date.
+* Returns the key ids: workoutId (needed for addExercisesToWorkout), programWorkoutId,
+* savedWorkoutId, and groupId.
+*/
+async function createPersonalWorkout(client, date) {
+	const res = await client.request("POST", "/v5/programWorkouts/personal", { body: { date } });
+	if (!res.ok) throw new Error(`Create personal workout failed (HTTP ${res.status}).`);
+	if (!isRecord(res.data)) throw new Error("Unexpected response from /v5/programWorkouts/personal.");
+	const pw = isRecord(res.data.programWorkout) ? res.data.programWorkout : null;
+	const sw = isRecord(res.data.savedWorkout) ? res.data.savedWorkout : null;
+	if (!pw || !sw) throw new Error("Missing programWorkout or savedWorkout in response.");
+	const programWorkoutId = coerceInt(pw.id);
+	const workoutId = coerceInt(pw.workoutId);
+	const savedWorkoutId = coerceInt(sw.id);
+	const groupId = coerceInt(sw.group_id);
+	if (!programWorkoutId || !workoutId || !savedWorkoutId || !groupId) throw new Error("Could not parse required ids from personal workout response.");
+	return {
+		programWorkoutId,
+		workoutId,
+		savedWorkoutId,
+		groupId,
+		date: typeof pw.date === "string" ? pw.date : date
+	};
+}
+/**
+* PUT /v5/personalCalendar/workouts/{workoutId}/addExercises — add exercises to a personal
+* workout. Returns saved workout set objects: each top-level `id` is a savedWorkoutSetId
+* and `savedWorkoutSetExercises[].id` is a savedWorkoutSetExerciseId, both needed by
+* logAthleteSet.
+*/
+async function addExercisesToWorkout(client, workoutId, exercises) {
+	const res = await client.request("PUT", `/v5/personalCalendar/workouts/${workoutId}/addExercises`, { body: {
+		exercises,
+		circuits: []
+	} });
+	if (!res.ok) throw new Error(`Add exercises to workout failed (HTTP ${res.status}).`);
+	return res.data;
+}
 /** Flatten `/v5/exercises/{id}/history` into PRs + a session time-series. */
 function presentExerciseHistory(detail) {
 	return {
@@ -980,6 +1019,41 @@ function registerExerciseTools(server, ctx, userId) {
 		annotations: READ
 	}, ({ exerciseId, date }) => attempt(async () => jsonResult(await fetchExerciseStats(ctx.client, toId(exerciseId), await userId(), date))));
 }
+/** Create a personal workout session and add exercises to it. */
+function registerSessionTools(server, ctx) {
+	server.registerTool("athlete_session_create", {
+		title: "Create personal workout session",
+		description: "Create a new personal workout session for a given YYYY-MM-DD date on the athlete's personal calendar. Returns programWorkoutId, workoutId (pass to athlete_session_add_exercises), savedWorkoutId, groupId, and date.",
+		inputSchema: { date: dateString },
+		annotations: {
+			readOnlyHint: false,
+			destructiveHint: false,
+			openWorldHint: true
+		}
+	}, ({ date }) => attempt(async () => jsonResult(await createPersonalWorkout(ctx.client, date))));
+	server.registerTool("athlete_session_add_exercises", {
+		title: "Add exercises to a personal workout session",
+		description: "Add one or more exercises to a personal workout session. Get workoutId from athlete_session_create. Each item needs an exerciseId (from athlete_exercises) and a 1-based order. Returns saved workout set objects: each top-level id is a savedWorkoutSetId and savedWorkoutSetExercises[].id is a savedWorkoutSetExerciseId — both needed for athlete_log_set.",
+		inputSchema: {
+			workoutId: idParam,
+			exercises: z.array(z.object({
+				exerciseId: idParam,
+				order: z.number().int().positive()
+			})).min(1)
+		},
+		annotations: {
+			readOnlyHint: false,
+			destructiveHint: false,
+			openWorldHint: true
+		}
+	}, ({ workoutId, exercises }) => attempt(async () => {
+		const mapped = exercises.map((e) => ({
+			exerciseId: toId(e.exerciseId),
+			order: e.order
+		}));
+		return jsonResult(await addExercisesToWorkout(ctx.client, toId(workoutId), mapped), { hint: "Each top-level id is a savedWorkoutSetId; savedWorkoutSetExercises[].id is the savedWorkoutSetExerciseId for athlete_log_set." });
+	}));
+}
 /** The gated set-logging write. */
 function registerLogTool(server, ctx) {
 	server.registerTool("athlete_log_set", {
@@ -1030,6 +1104,7 @@ function registerAthleteTrainingTools(server, ctx) {
 	};
 	registerProfileTools(server, ctx, whoami, userId);
 	registerExerciseTools(server, ctx, userId);
+	registerSessionTools(server, ctx);
 	registerLogTool(server, ctx);
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trainheroic-unofficial/athlete-mcp",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -21,8 +21,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.4.3",
-    "@trainheroic-unofficial/core": "0.4.0",
-    "@trainheroic-unofficial/js": "0.4.0"
+    "@trainheroic-unofficial/js": "0.4.1",
+    "@trainheroic-unofficial/core": "0.4.1"
   },
   "devDependencies": {
     "@types/node": "^26.0.0",