@trainheroic-unofficial/athlete-mcp 3.1.0 → 3.2.0

package/dist/server.mjs

@@ -287,6 +287,23 @@ const programWorkoutResponseSchema = z.looseObject({
 	sets: z.record(z.string(), z.unknown()).optional()
 });
 z.looseObject({ programWorkouts: z.array(programWorkoutResponseSchema).optional() });
+z.looseObject({
+	id: intLike,
+	title: z.string(),
+	programId: intLike,
+	group_program: intLike,
+	type: intLike,
+	program: z.looseObject({
+		id: intLike,
+		program_type: intLike
+	}).optional()
+});
+z.object({
+	pub_enabled: z.union([z.number(), z.boolean()]).optional(),
+	pub_days: z.unknown().optional(),
+	pub_time: z.unknown().optional(),
+	pub_timezone: z.string().optional()
+}).refine((v) => v.pub_enabled !== void 0 || v.pub_days !== void 0 || v.pub_time !== void 0 || v.pub_timezone !== void 0, { message: "Provide at least one pub_* field" });
 //#endregion
 //#region ../dto/src/workout.ts
 /** A single exercise prescription inside a block. */
@@ -339,6 +356,10 @@ z.object({
 	blocks: z.array(blockSpecSchema),
 	instruction: z.string().optional()
 });
+z.object({
+	title: z.string().min(1),
+	instruction: z.string().optional()
+});
 //#endregion
 //#region ../core/src/context.ts
 /** A tool argument that accepts a numeric id as a number or a string of digits. */
@@ -699,7 +720,7 @@ var TrainHeroicClient = class {
 			session = await this.#ensureSession();
 			res = await this.#send(method, url, session, options.body);
 		}
-		if (!res.ok) notifyHttpError(this.#onHttpError, method, url, res.status);
+		if (!res.ok && !options.expectedStatuses?.includes(res.status)) notifyHttpError(this.#onHttpError, method, url, res.status);
 		const text = await res.text();
 		let data = text;
 		if (text.length > 0) try {
@@ -849,6 +870,15 @@ function fetchWorkingMaxes(client) {
 function fetchExerciseHistoryList(client) {
 	return getArray(client, "/v5/users/exercises/history", "athlete exercise history list");
 }
+function fetchRecentExercises(client) {
+	return getArray(client, "/v5/users/exercises/recent", "athlete recent exercises");
+}
+function fetchAthleteCircuits(client, kind = "recent") {
+	return getArray(client, `/v5/users/circuits/${kind}`, `athlete ${kind} circuits`);
+}
+function fetchAthleteProgrammingPrograms(client) {
+	return getArray(client, "/1.0/athlete/programming/programs", "athlete programming programs");
+}
 /** Free-text search over the athlete's logged exercises (FTS replacement via rankSearch). */
 async function searchExerciseHistory(client, query, limit = 20) {
 	return rankSearch(await fetchExerciseHistoryList(client), query, limit);
@@ -2114,6 +2144,26 @@ function registerSwapTool(server, ctx) {
 		}));
 	}));
 }
+function registerCatalogReads(server, ctx) {
+	server.registerTool("athlete_circuits", {
+		title: "Circuit history",
+		description: "Named circuit history for the logged-in athlete (GET /v5/users/circuits/{recent|history}). kind defaults to recent. Empty when the athlete has no saved circuits. Distinct from circuit *blocks* in workout_build (type 1).",
+		inputSchema: { kind: z.enum(["recent", "history"]).optional() },
+		annotations: READ
+	}, ({ kind }) => attempt(async () => jsonResult(await fetchAthleteCircuits(ctx.client, kind ?? "recent"))));
+	server.registerTool("athlete_programming_programs", {
+		title: "Subscribed programs",
+		description: "Programs the athlete is subscribed to (GET /1.0/athlete/programming/programs). Not the coach list_programs surface. Empty when the athlete has no subscriptions.",
+		inputSchema: {},
+		annotations: READ
+	}, () => attempt(async () => jsonResult(await fetchAthleteProgrammingPrograms(ctx.client))));
+	server.registerTool("athlete_recent_exercises", {
+		title: "Recent exercises",
+		description: "Recently used exercises (GET /v5/users/exercises/recent). Distinct from athlete_exercises (full logged catalog) and athlete_exercise_history (one lift).",
+		inputSchema: {},
+		annotations: READ
+	}, () => attempt(async () => jsonResult(await fetchRecentExercises(ctx.client))));
+}
 /**
 * Live tools over the logged-in user's own training (history, scheduled/completed workouts,
 * PRs, working maxes), plus a gated set-logging write. The athlete user id is
@@ -2136,6 +2186,7 @@ function registerAthleteTrainingTools(server, ctx) {
 	};
 	registerProfileTools(server, ctx, whoami, userId);
 	registerExerciseTools(server, ctx, userId);
+	registerCatalogReads(server, ctx);
 	registerLogTargetsTool(server, ctx);
 	registerSessionTools(server, ctx);
 	registerLogTool(server, ctx);
@@ -2143,7 +2194,7 @@ function registerAthleteTrainingTools(server, ctx) {
 }
 //#endregion
 //#region package.json
-var version = "3.1.0";
+var version = "3.2.0";
 //#endregion
 //#region src/server.ts
 function main() {

package/package.json

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