@trainheroic-unofficial/core 3.5.0 → 3.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/index.mjs +28 -40
  2. package/package.json +3 -3
package/dist/index.mjs CHANGED
@@ -1,7 +1,7 @@
1
1
  import { athleteExerciseCatalogOutputSchema, athleteExerciseNoteArgsSchema, athleteExerciseNoteOutputSchema, athleteInviteOutputSchema, athleteMainLiftPrsOutputSchema, athletePrefsSchema, athletePrescribeSetArgsSchema, athleteProfileOutputSchema, athleteSessionRemoveArgsSchema, athleteSessionRemovedOutputSchema, athleteWorkingMaxListSchema, athleteWorkoutNoteArgsSchema, athleteWorkoutNoteObject, athleteWorkoutNoteOutputSchema, athleteWorkoutsOutputSchema, blockSpecSchema, coachAthleteTrainingOutputSchema, coachLogSessionArgsSchema, coachLogSetArgsSchema, coachPrescribeSetArgsSchema, commentDraftSchema, dateString, exerciseCreateSchema, exerciseCreatedOutputSchema, exerciseDeletedOutputSchema, exerciseForgottenOutputSchema, exerciseGetOutputSchema, exerciseHistoryOutputSchema, exerciseResolveOutputSchema, exerciseStatsSchema, exerciseSwapOutputSchema, exerciseViewSchema, idArgSchema, logSessionArgsSchema, logSetArgsSchema, logTargetsOutputSchema, messageDeletedOutputSchema, messageDraftOutputSchema, messageSentOutputSchema, opaqueOutputSchema, parseWorkoutDate, personalRecordListSchema, personalWorkoutCreatedOutputSchema, programCreatedOutputSchema, programDeletedOutputSchema, removedSessionOutputSchema, rosterActivityOutputSchema, sessionLogOutputSchema, sessionTemplateCreateSchema, sessionTemplateCreatedOutputSchema, setLogOutputSchema, setPrescriptionOutputSchema, swapAthleteExerciseArgsSchema, teamPublishPatchObject, teamPublishPatchSchema, teamVolumeOutputSchema, toolOutputSchema, userSimpleSchema, workoutBuildOutputSchema, workoutPublishOutputSchema, workoutReadOutputSchema } from "@trainheroic-unofficial/dto";
2
2
  import { acceptedContent, inputRequired, inputResponse } from "@modelcontextprotocol/server";
3
3
  import { z } from "zod";
4
- import { ANALYTICS_METRIC_KEYS, PROGRAM_KINDS, SESSION_TEMPLATES_LIST_PATH, addExercisesToWorkout, buildCommentPayload, buildSession, coerceInt, collectAdvisories, copySession, createPersonalWorkout, createProgram, createSessionTemplate, definedProps, deleteComment, deleteProgram, exerciseUnits, fetchAthleteCircuits, fetchAthleteMainLiftPRs, fetchAthletePrefs, fetchAthleteProfileSummary, fetchAthleteProgrammingPrograms, fetchAthleteUser, fetchAthleteWorkouts, fetchCoachAthleteCalendarSummary, fetchCoachAthleteWorkouts, fetchExerciseHistoryDetail, fetchExerciseHistoryList, fetchExerciseStats, fetchLeaderboard, fetchPersonalRecords, fetchRecentExercises, fetchRosterActivity, fetchRosterMainLiftPRs, fetchStreams, fetchTeamAthleteIds, fetchWorkingMaxes, inviteAthletes, isRecord, logAdHocSession, logAthleteSet, logForAthlete, logSessionForAthlete, prescribeAthleteSet, prescribeForAthlete, presentAthleteWorkouts, presentCoachAthleteTraining, presentExerciseHistory, presentLogTargets, publishSession, queryAnalytics, readLive, readSession, removePersonalWorkout, removeSession, resolveBuildProgramId, searchExerciseHistory, selectWorkouts, selectWorkoutsByProgram, sendComment, setAthleteExerciseNote, setAthleteWorkoutNote, summarizeAthleteWorkouts, swapAthleteExercise, teamPublishTarget, teamVolume, toSetResults, updateTeam, updateTeamPublishSettings } from "@trainheroic-unofficial/js";
4
+ import { ANALYTICS_METRIC_KEYS, PROGRAM_KINDS, SESSION_TEMPLATES_LIST_PATH, addExercisesToWorkout, buildCommentPayload, buildSession, coerceInt, collectAdvisories, copySession, createPersonalWorkout, createProgram, createSessionTemplate, definedProps, deleteComment, deleteProgram, exerciseUnits, fetchAthleteCircuits, fetchAthleteMainLiftPRs, fetchAthletePrefs, fetchAthleteProfileSummary, fetchAthleteProgrammingPrograms, fetchAthleteUser, fetchAthleteWorkouts, fetchCoachAthleteCalendarSummary, fetchCoachAthleteWorkouts, fetchExerciseHistoryDetail, fetchExerciseHistoryList, fetchExerciseStats, fetchLeaderboard, fetchPersonalRecords, fetchRecentExercises, fetchRosterActivity, fetchRosterMainLiftPRs, fetchStreams, fetchTeamAthleteIds, fetchWorkingMaxes, historyInRange, inviteAthletes, isRecord, logAdHocSession, logAthleteSet, logForAthlete, logSessionForAthlete, prescribeAthleteSet, prescribeForAthlete, presentAthleteWorkouts, presentCoachAthleteTraining, presentExerciseHistory, presentLogTargets, publishSession, queryAnalytics, readLive, readSession, removePersonalWorkout, removeSession, resolveBuildProgramId, searchExerciseHistory, selectWorkouts, selectWorkoutsByProgram, sendComment, setAthleteExerciseNote, setAthleteWorkoutNote, setSplitSummary, summarizeAthleteWorkouts, swapAthleteExercise, teamPublishTarget, teamVolume, toSetResults, updateTeam, updateTeamPublishSettings } from "@trainheroic-unofficial/js";
5
5
  //#region src/context.ts
6
6
  /** A tool argument that accepts a numeric id as a number or a string of digits. */
7
7
  const idParam = idArgSchema;
@@ -77,12 +77,16 @@ function resultBudget() {
77
77
  function isPlainObject(value) {
78
78
  return typeof value === "object" && value !== null && !Array.isArray(value);
79
79
  }
80
- /** Largest count k such that the JSON of the first k pre-serialized pieces fits. O(n). */
81
- function largestPrefixCount(pieces, charBudget) {
80
+ /**
81
+ * Largest count k such that the JSON of the first k elements fits. Elements are serialized one
82
+ * at a time and the walk stops at the first overflow, so an oversized 10k-row result costs the
83
+ * serialization of the rows that fit, not of every row.
84
+ */
85
+ function largestPrefixCount(elements, charBudget) {
82
86
  let used = 2;
83
87
  let k = 0;
84
- for (const piece of pieces) {
85
- const add = piece.length + (k > 0 ? 1 : 0);
88
+ for (const element of elements) {
89
+ const add = (JSON.stringify(element) ?? "null").length + (k > 0 ? 1 : 0);
86
90
  if (used + add > charBudget) break;
87
91
  used += add;
88
92
  k += 1;
@@ -97,11 +101,12 @@ function hardCap(text, budget, hint) {
97
101
  return text.slice(0, keep) + note;
98
102
  }
99
103
  function largestArrayValuedKey(obj) {
104
+ const arrayKeys = Object.keys(obj).filter((key) => Array.isArray(obj[key]));
105
+ if (arrayKeys.length <= 1) return arrayKeys[0] ?? null;
100
106
  let best = null;
101
107
  let bestLen = -1;
102
- for (const [key, value] of Object.entries(obj)) {
103
- if (!Array.isArray(value)) continue;
104
- const len = (JSON.stringify(value) ?? "[]").length;
108
+ for (const key of arrayKeys) {
109
+ const len = (JSON.stringify(obj[key]) ?? "[]").length;
105
110
  if (len > bestLen) {
106
111
  best = key;
107
112
  bestLen = len;
@@ -109,9 +114,6 @@ function largestArrayValuedKey(obj) {
109
114
  }
110
115
  return best;
111
116
  }
112
- function jsonValue(data) {
113
- return JSON.parse(JSON.stringify(data) ?? "null");
114
- }
115
117
  function previewEnvelope(source, budget, hint) {
116
118
  const total = source.length;
117
119
  const makeValue = (preview, markerHint) => ({
@@ -138,8 +140,8 @@ function boundedResult(data, budget, hint) {
138
140
  text: data,
139
141
  value: data
140
142
  };
141
- const value = jsonValue(data);
142
- const compact = JSON.stringify(value);
143
+ const compact = JSON.stringify(data) ?? "null";
144
+ const value = JSON.parse(compact);
143
145
  if (compact.length <= budget) {
144
146
  const pretty = JSON.stringify(value, null, 2);
145
147
  return {
@@ -148,7 +150,7 @@ function boundedResult(data, budget, hint) {
148
150
  };
149
151
  }
150
152
  if (Array.isArray(value)) {
151
- const truncated = clipArray(value, largestPrefixCount(value.map((element) => JSON.stringify(element)), budget - MARKER_RESERVE), hint);
153
+ const truncated = clipArray(value, largestPrefixCount(value, budget - MARKER_RESERVE), hint);
152
154
  const text = JSON.stringify(truncated);
153
155
  if (text.length <= budget) return {
154
156
  text,
@@ -158,7 +160,7 @@ function boundedResult(data, budget, hint) {
158
160
  const key = largestArrayValuedKey(value);
159
161
  if (key !== null) {
160
162
  const array = value[key];
161
- const truncated = clipArray(array, largestPrefixCount(array.map((element) => JSON.stringify(element)), budget - MARKER_RESERVE), hint ?? DEFAULT_OBJECT_HINT, key);
163
+ const truncated = clipArray(array, largestPrefixCount(array, budget - MARKER_RESERVE), hint ?? DEFAULT_OBJECT_HINT, key);
162
164
  const text = JSON.stringify(truncated);
163
165
  if (text.length <= budget) return {
164
166
  text,
@@ -273,27 +275,6 @@ function confirmGate(ctx, message, confirmArg) {
273
275
  */
274
276
  const SERVER_INSTRUCTIONS = "Speak to the user in plain, everyday language about their training. Describe what you are doing in the TrainHeroic app's own terms (for example, say you are creating a workout rather than naming a tool). Do not surface internal tool names (the snake_case identifiers such as athlete_session_create), raw parameter names, or numeric ids in your replies unless the user explicitly asks for them; they are implementation details. The tool descriptions cross-reference each other by name only so you can chain them correctly. Keep that wiring to yourself.";
275
277
  //#endregion
276
- //#region src/history.ts
277
- /**
278
- * Trim a presented exercise history's session time-series to an inclusive YYYY-MM-DD window.
279
- * The `liftPRs` board stays all-time (PRs are not a windowed concept). Dates compare as their
280
- * first 10 chars so both "YYYY-MM-DD" and "YYYY-MM-DDThh:mm" values filter correctly. Shared by
281
- * the athlete's own history tool and the coach's per-roster-athlete history tool.
282
- */
283
- function historyInRange(presented, since, until) {
284
- if (since === void 0 && until === void 0) return presented;
285
- const sessions = presented.sessions.filter((s) => {
286
- const d = (s.date ?? "").slice(0, 10);
287
- if (since !== void 0 && d < since) return false;
288
- if (until !== void 0 && d > until) return false;
289
- return true;
290
- });
291
- return {
292
- ...presented,
293
- sessions
294
- };
295
- }
296
- //#endregion
297
278
  //#region src/tools/reads.ts
298
279
  const ATHLETE_LIFT_HISTORY_DESC = "A roster athlete's lift history for ONE exercise: the all-time PR board (liftPRs — each entry carries its rep-max label, weight, and the date it was set) plus the dated session series (sets, estimated 1RM). This is the coach-side way to answer 'show me <athlete>'s PRs / how is <athlete>'s squat trending' — pass athleteId from list_athletes and exerciseId from exercise_resolve. There is no cross-exercise PR rollup, so you query one lift at a time, but do NOT guess lift names blindly: first call athlete_training for the month(s) of interest — it lists every exercise the athlete actually performed (with the exact exercise the program used, e.g. 'Clean & Jerk' not 'Clean') — then bring those exerciseIds here. An empty result means that lift was not logged. liftPRs stay all-time; pass since/until (YYYY-MM-DD, inclusive) to window the session series. raw:true returns the untouched API object.";
299
280
  const ROSTER_ACTIVITY_DESC = "A coach's roster ranked by actual training recency: for each athleteId you pass (from list_athletes), the all-time sessionsCount, firstLoggedDate, lastLoggedDate, totalReps and totalVolume, sorted most-recently-active first. Use lastLoggedDate — the real training signal — NOT list_athletes' daysSinceLastLogin (app-login, not training) to answer 'who is my most recently active athlete' (the top row) or 'who is falling behind' (a stale or null lastLoggedDate, or low volume). A null lastLoggedDate means the athlete has never logged a session. This fans out one lookup per athlete, so for a large org pass only the athletes you care about. Then drill into a name with athlete_training (their month) or athlete_lift_history.";
@@ -1498,30 +1479,37 @@ function registerExerciseTools(server, ctx) {
1498
1479
  function registerBuild(server, ctx) {
1499
1480
  server.registerTool("workout_build", {
1500
1481
  title: "Build a workout session (draft)",
1501
- description: "Build an UNPUBLISHED session from a spec (program -> session -> blocks -> exercises). Pass programId for a team/group calendar (list_teams → group_program), or athleteId to write on that roster athlete's coach calendar (resolved via /v5/calendars/athletes/{id} — the same calendar the coach web app opens from My Athletes). athleteId requires date. Two exercises in one block become a superset. A block with empty exercises and a non-empty block instruction is a text-only Circuit / Conditioning block (type 1). Add a block 'leaderboard' for a Red-Zone score, or a top-level 'instruction' for the session note (Coach Instructions). Returns the draft ids, a read-back, and unit advisories. Review, then workout_publish.",
1482
+ description: "Build an UNPUBLISHED session from a spec (program -> session -> blocks -> exercises). Pass programId for a team/group calendar (list_teams → group_program), or athleteId to write on that roster athlete's coach calendar (resolved via /v5/calendars/athletes/{id} — the same calendar the coach web app opens from My Athletes). athleteId requires date. Two exercises in one block become a superset. A block with empty exercises and a non-empty block instruction is a text-only Circuit / Conditioning block (type 1). Add a block 'leaderboard' for a Red-Zone score, or a top-level 'instruction' for the session note (Coach Instructions). Returns the draft ids, a read-back, and unit advisories. Exercises above 10 sets are split into consecutive same-titled blocks and require confirmation (elicitation, or confirm:true). Review, then workout_publish.",
1502
1483
  inputSchema: {
1503
1484
  programId: z.number().optional(),
1504
1485
  athleteId: idParam.optional(),
1505
1486
  date: z.string().optional(),
1506
1487
  timelineDay: z.number().optional(),
1507
1488
  blocks: z.array(blockSpecSchema),
1508
- instruction: z.string().optional()
1489
+ instruction: z.string().optional(),
1490
+ confirm: z.boolean().optional()
1509
1491
  },
1510
1492
  outputSchema: toolOutputSchema(workoutBuildOutputSchema),
1511
1493
  annotations: ADDITIVE
1512
- }, ({ programId, athleteId, date, timelineDay, blocks, instruction }) => attempt(async () => {
1494
+ }, ({ programId, athleteId, date, timelineDay, blocks, instruction, confirm }, extra) => attempt(async () => {
1513
1495
  if (date === void 0 && timelineDay === void 0) return errorResult("Provide either date (YYYY-M-D) or timelineDay.");
1496
+ const typed = blocks;
1497
+ const splitSummary = setSplitSummary(typed);
1498
+ if (splitSummary !== null) {
1499
+ const blocked = confirmGate(extra, `${splitSummary} Continue?`, confirm);
1500
+ if (blocked) return blocked;
1501
+ }
1514
1502
  const resolveArgs = {};
1515
1503
  if (programId !== void 0) resolveArgs.programId = programId;
1516
1504
  if (athleteId !== void 0) resolveArgs.athleteId = toId(athleteId);
1517
1505
  if (date !== void 0) resolveArgs.date = date;
1518
1506
  const resolved = await resolveBuildProgramId(ctx.client, resolveArgs);
1519
- const typed = blocks;
1520
1507
  const opts = {
1521
1508
  programId: resolved,
1522
1509
  blocks: typed,
1523
1510
  publish: false
1524
1511
  };
1512
+ if (splitSummary !== null) opts.confirmSetSplit = true;
1525
1513
  if (date !== void 0) opts.date = parseWorkoutDate(date);
1526
1514
  if (timelineDay !== void 0) opts.timelineDay = timelineDay;
1527
1515
  if (instruction !== void 0) opts.instruction = instruction;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@trainheroic-unofficial/core",
3
- "version": "3.5.0",
3
+ "version": "3.5.2",
4
4
  "license": "MIT",
5
5
  "repository": {
6
6
  "type": "git",
@@ -25,8 +25,8 @@
25
25
  "@cfworker/json-schema": "^4.1.1",
26
26
  "@modelcontextprotocol/server": "2.0.0",
27
27
  "zod": "^4.4.3",
28
- "@trainheroic-unofficial/dto": "3.5.0",
29
- "@trainheroic-unofficial/js": "3.5.0"
28
+ "@trainheroic-unofficial/dto": "3.5.2",
29
+ "@trainheroic-unofficial/js": "3.5.2"
30
30
  },
31
31
  "devDependencies": {
32
32
  "@types/node": "^26.3.0",