@trainheroic-unofficial/athlete-mcp 3.0.0 → 3.1.0

package/README.md

@@ -4,7 +4,7 @@ Local single-user [MCP](https://modelcontextprotocol.io) server for a TrainHeroi
 
 It reads two required environment variables, `TRAINHEROIC_EMAIL` and `TRAINHEROIC_PASSWORD` (your existing TrainHeroic login). These are real credentials in plaintext; the config below puts them in a file or shell history, so treat them as secrets.
 
-It exposes the logged-in athlete's own training: scheduled and completed workouts, per-exercise history, PRs (personal records), working maxes, and lifetime totals, plus one confirmation-gated write that logs a completed set. Coaching capabilities (rosters, teams, programs, messaging) are available through [`@trainheroic-unofficial/coach-mcp`](../coach-mcp). A hosted version that holds credentials server-side behind OAuth and gives a coach login both the athlete and coaching tools is described in the [root README](../../README.md).
+It exposes the logged-in athlete's own training: scheduled and completed workouts, per-exercise history, PRs (personal records), working maxes, lifetime totals, and confirmation-gated training writes. Coaching capabilities (rosters, teams, programs, messaging) are available through [`@trainheroic-unofficial/coach-mcp`](../coach-mcp). A hosted version that holds credentials server-side behind OAuth and gives a coach login both the athlete and coaching tools is described in the [root README](../../README.md).
 
 ---
 
@@ -48,8 +48,8 @@ A coach account works here too: a TrainHeroic coach account also has its own ath
 
 ## Tools
 
-All read-only except `athlete_log_set`. The assistant fills in each tool's parameters (dates
-are `YYYY-MM-DD`); your MCP client shows the full schema for each.
+The assistant fills in each tool's parameters (dates are `YYYY-MM-DD`); your MCP client shows the
+full schema for each. Writes are confirmation-gated.
 
 - `athlete_whoami`: identity (id, name, roles)
 - `athlete_profile`: lifetime totals + profile
@@ -67,6 +67,9 @@ are `YYYY-MM-DD`); your MCP client shows the full schema for each.
 - `athlete_log_set`: logs completed set results to your training log. This is a real write
   that your coach can see. It confirms before running: the server asks the client to confirm,
   falling back to an explicit `confirm: true` argument when the client can't prompt.
+- `athlete_prescribe_set`: sets your planned reps and/or weight without recording the set as
+  completed. It replaces the selected exercise's whole prescription, so every planned set and
+  value to keep must be included.
 
 ---
 

package/dist/server.mjs

@@ -203,12 +203,18 @@ const logSetArgsSchema = z.object({
 	results: loggedExerciseResultsSchema
 });
 logSetArgsSchema.extend({ athleteId: idArgSchema });
-z.object({
+/**
+* Args for changing the logged-in athlete's prescribed targets without marking the set performed.
+* The write replaces the exercise's whole prescription, so its sets are positional and sequential
+* by definition: it deliberately omits the log path's `slot` field because a sparse prescription
+* has no meaning here.
+*/
+const athletePrescribeSetArgsSchema = z.object({
 	date: dateString,
 	savedWorkoutSetId: idArgSchema,
-	athleteId: idArgSchema,
 	results: prescribedExerciseResultsSchema
 });
+athletePrescribeSetArgsSchema.extend({ athleteId: idArgSchema });
 /**
 * Args for the coach per-athlete exercise swap: replace the exercise prescribed in one of a
 * roster athlete's saved-workout slots with a different exercise, the API equivalent of the
@@ -822,7 +828,7 @@ async function getJson(client, path, label) {
 	if (!res.ok) throw new Error(`${label} failed (HTTP ${res.status}).`);
 	return res.data;
 }
-async function getArray$1(client, path, label) {
+async function getArray(client, path, label) {
 	const res = await client.request("GET", path);
 	if (!res.ok || !Array.isArray(res.data)) throw new Error(`${label} failed (HTTP ${res.status}).`);
 	return res.data;
@@ -838,10 +844,10 @@ function fetchAthletePrefs(client) {
 	return getJson(client, "/1.0/athlete/prefs", "athlete prefs");
 }
 function fetchWorkingMaxes(client) {
-	return getArray$1(client, "/2.0/athlete/workingMax", "athlete working maxes");
+	return getArray(client, "/2.0/athlete/workingMax", "athlete working maxes");
 }
 function fetchExerciseHistoryList(client) {
-	return getArray$1(client, "/v5/users/exercises/history", "athlete exercise history list");
+	return getArray(client, "/v5/users/exercises/history", "athlete exercise history list");
 }
 /** Free-text search over the athlete's logged exercises (FTS replacement via rankSearch). */
 async function searchExerciseHistory(client, query, limit = 20) {
@@ -851,7 +857,7 @@ function fetchExerciseHistoryDetail(client, exerciseId, userId) {
 	return getJson(client, `/v5/exercises/${exerciseId}/history?userId=${userId}`, "athlete exercise history");
 }
 function fetchPersonalRecords(client, exerciseId) {
-	return getArray$1(client, `/v5/exercises/${exerciseId}/personalRecords`, "athlete personal records");
+	return getArray(client, `/v5/exercises/${exerciseId}/personalRecords`, "athlete personal records");
 }
 /** Last performance + PR for an exercise. `date` (YYYY-MM-DD) is required by the API. */
 function fetchExerciseStats(client, exerciseId, userId, date) {
@@ -859,7 +865,7 @@ function fetchExerciseStats(client, exerciseId, userId, date) {
 }
 /** Scheduled + completed workouts in an inclusive YYYY-MM-DD window. */
 function fetchAthleteWorkouts(client, startDate, endDate) {
-	return getArray$1(client, `/3.0/athlete/programworkout/range?startDate=${startDate}&endDate=${endDate}`, "athlete workouts");
+	return getArray(client, `/3.0/athlete/programworkout/range?startDate=${startDate}&endDate=${endDate}`, "athlete workouts");
 }
 function fetchLeaderboard(client, workoutId, opts = {}) {
 	const qs = new URLSearchParams();
@@ -1212,22 +1218,6 @@ function presentExerciseHistory(detail) {
 	};
 }
 //#endregion
-//#region ../js/src/coach-athlete-calendar.ts
-async function getArray(client, path, label) {
-	const res = await client.request("GET", path);
-	if (!res.ok || !Array.isArray(res.data)) throw new Error(`${label} failed (HTTP ${res.status}).`);
-	return res.data;
-}
-/**
-* A coach's view of a roster athlete's scheduled + completed workouts in an inclusive
-* YYYY-MM-DD window (`/3.0/coach/athlete/programworkout/range/{athleteId}`). Returns the same
-* `ProgramWorkout[]` shape as `fetchAthleteWorkouts`, so the same presenters and
-* `findSavedWorkoutSet` apply — it just reads another athlete's data through the coach surface.
-*/
-function fetchCoachAthleteWorkouts(client, athleteId, startDate, endDate) {
-	return getArray(client, `/3.0/coach/athlete/programworkout/range/${athleteId}?startDate=${startDate}&endDate=${endDate}`, "coach athlete workouts");
-}
-//#endregion
 //#region ../js/src/exercise-set-payload.ts
 function slotData(exercise, key) {
 	const value = exercise?.[key];
@@ -1443,25 +1433,18 @@ async function logAthleteSet(client, args) {
 	};
 }
 /**
-* Coach "Log for Athlete": record set results for a roster athlete on their behalf, via the
-* coach surface — `PUT /1.0/coach/savedworkoutsetexercise/{id}/{athleteId}` (the data write)
-* then `PUT /1.0/coach/savedworkoutset/{id}/{athleteId}` (mark complete). Same two-step
-* contract as {@link logAthleteSet}; the bodies are identical except each is stamped with
-* `athleteId`. The day is located through the coach range endpoint for that athlete.
+* Set the logged-in athlete's prescribed reps/weight for one saved workout set WITHOUT marking it
+* performed. This is the athlete-side equivalent of editing target values in the app: it writes
+* `param_N_data_M` with every made/completed flag cleared and skips the set-completion PUT.
 *
-* NOTE: TrainHeroic's seeded *demo* athletes are read-only for results and return 401 on the
-* data-write step; real (invited) athletes accept it.
+* The write replaces the selected exercise's whole prescription, so callers must pass every set
+* they want to keep. An omitted param is cleared rather than preserved.
 */
-async function logForAthlete(client, args) {
-	const workouts = await fetchCoachAthleteWorkouts(client, args.athleteId, args.date, args.date);
-	const r = await writeSetResults(client, {
-		role: "coach",
-		athleteId: args.athleteId
-	}, workouts, args.savedWorkoutSetId, args.results, "log");
+async function prescribeAthleteSet(client, args) {
+	const r = await writeSetResults(client, { role: "athlete" }, await fetchAthleteWorkouts(client, args.date, args.date), args.savedWorkoutSetId, args.results, "prescribe");
 	return {
 		savedWorkoutSetId: r.savedWorkoutSetId,
-		exercisesLogged: r.exercisesWritten,
-		setCompleted: r.setCompleted
+		exercisesPrescribed: r.exercisesWritten
 	};
 }
 /**
@@ -1500,9 +1483,10 @@ async function swapAthleteExercise(client, args) {
 	};
 }
 /**
-* Shared set-write behind {@link logAthleteSet}, {@link logForAthlete}, and
-* {@link prescribeForAthlete}. `target` selects the surface: `athlete` writes `/1.0/athlete/...`;
-* `coach` writes `/1.0/coach/...{athleteId}` and stamps `athleteId` into each body.
+* Shared set-write behind {@link logAthleteSet}, {@link prescribeAthleteSet},
+* {@link logForAthlete}, and {@link prescribeForAthlete}. `target` selects the surface: `athlete`
+* writes `/1.0/athlete/...`; `coach` writes `/1.0/coach/...{athleteId}` and stamps `athleteId` into
+* each body.
 *
 * Step 1 PUTs each exercise's per-set values to its own endpoint (the only path that actually
 * stores reps and weight). `mode` decides what those values mean: `"log"` records them as a
@@ -1707,7 +1691,7 @@ function findScheduledMatches(workouts, exerciseIds) {
 	return out;
 }
 /** Group resolved exercises by saved set and write each set via the given log target. */
-async function logResolvedExercises(client, target, date, resolved) {
+async function logResolvedExercises(client, target, workouts, resolved) {
 	const bySet = /* @__PURE__ */ new Map();
 	for (const r of resolved) {
 		const list = bySet.get(r.savedWorkoutSetId) ?? [];
@@ -1719,19 +1703,10 @@ async function logResolvedExercises(client, target, date, resolved) {
 	}
 	const out = [];
 	for (const [savedWorkoutSetId, results] of bySet) {
-		const written = target.role === "coach" ? await logForAthlete(client, {
-			athleteId: target.athleteId,
-			date,
-			savedWorkoutSetId,
-			results
-		}) : await logAthleteSet(client, {
-			date,
-			savedWorkoutSetId,
-			results
-		});
+		const written = await writeSetResults(client, target, workouts, savedWorkoutSetId, results, "log");
 		out.push({
 			savedWorkoutSetId: written.savedWorkoutSetId,
-			exercisesLogged: written.exercisesLogged
+			exercisesLogged: written.exercisesWritten
 		});
 	}
 	return out;
@@ -1769,7 +1744,7 @@ async function logAdHocSession(client, args) {
 			sets: e.sets
 		};
 	});
-	const sets = await logResolvedExercises(client, { role: "athlete" }, args.date, resolved);
+	const sets = await logResolvedExercises(client, { role: "athlete" }, await fetchAthleteWorkouts(client, args.date, args.date), resolved);
 	const result = {
 		date: args.date,
 		created,
@@ -2094,6 +2069,24 @@ function registerLogTool(server, ctx) {
 			results: toSetResults(results)
 		}));
 	}));
+	server.registerTool("athlete_prescribe_set", {
+		title: "Set your prescribed reps/weight without logging",
+		description: "Athlete-facing write: set the planned reps and/or weight for one of your scheduled workout sets WITHOUT recording it as performed. Use this when you know the target load before training but have not completed the set yet. The set stays open and nothing is added to exercise history. param1 is reps and param2 is weight; pass one sets[] entry per planned set. This write REPLACES the selected exercise's whole prescription, so include every planned set and every value you want to keep; an omitted param is cleared. Get savedWorkoutSetId + savedWorkoutSetExerciseId from athlete_log_targets. To record actual completed results, use athlete_log_set instead. Requires confirmation (elicitation or confirm:true).",
+		inputSchema: {
+			...athletePrescribeSetArgsSchema.shape,
+			confirm: z.boolean().optional()
+		},
+		annotations: DESTRUCTIVE
+	}, ({ date, savedWorkoutSetId, results, confirm }, extra) => attempt(async () => {
+		const id = toId(savedWorkoutSetId);
+		const blocked = confirmGate(extra, `Set prescribed values on your saved workout set ${id} on ${date}? This changes your planned reps/weight but does not log the set as completed.`, confirm);
+		if (blocked) return blocked;
+		return jsonResult(await prescribeAthleteSet(ctx.client, {
+			date,
+			savedWorkoutSetId: id,
+			results: toSetResults(results)
+		}));
+	}));
 }
 /**
 * The athlete's own per-exercise swap, in its own function so registerLogTool/registerSessionTools
@@ -2150,7 +2143,7 @@ function registerAthleteTrainingTools(server, ctx) {
 }
 //#endregion
 //#region package.json
-var version = "3.0.0";
+var version = "3.1.0";
 //#endregion
 //#region src/server.ts
 function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trainheroic-unofficial/athlete-mcp",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -21,8 +21,8 @@
   "dependencies": {
     "@modelcontextprotocol/server": "2.0.0",
     "zod": "^4.4.3",
-    "@trainheroic-unofficial/core": "3.0.0",
-    "@trainheroic-unofficial/js": "3.0.0"
+    "@trainheroic-unofficial/core": "3.1.0",
+    "@trainheroic-unofficial/js": "3.1.0"
   },
   "devDependencies": {
     "@types/node": "^26.2.0",