@sessionplan/contracts 0.1.0

package/README.md

@@ -0,0 +1,70 @@
+# @sessionplan/contracts
+
+Type declarations for the SessionPlan API.
+
+> **Public for installation convenience; not a stable external contract until 1.0.**
+> These types describe the shapes exchanged between the SessionPlan API and its
+> first-party clients (the MCP server, the web app). They may change without a
+> major version bump while the package is in the `0.x` range. Do not depend on
+> this package for third-party integrations yet.
+
+## Install
+
+```sh
+npm install @sessionplan/contracts
+```
+
+## Usage
+
+```ts
+import type {
+  GenerationContext,
+  WorkspaceListResponse,
+  SessionResponse,
+  ResolveExercisesResponse,
+  PerformanceSummary,
+  HealthResponse,
+} from '@sessionplan/contracts';
+```
+
+The package is **type-only** apart from a single runtime export, `ContractVersion`,
+which mirrors the package version so clients can report the contract revision they
+were built against.
+
+```ts
+import { ContractVersion } from '@sessionplan/contracts';
+
+console.log(ContractVersion); // "0.1.0"
+```
+
+## Scope
+
+This package is the single source of truth for the API wire contract. It contains
+**only** `interface` / `type` declarations (plus `ContractVersion`). Runtime
+builders, validators, and helpers stay in the API and its clients.
+
+| Module       | Covers                                                        |
+| ------------ | ------------------------------------------------------------- |
+| `common`     | Shared primitives: `JsonValue`, units, scopes, pagination     |
+| `profile`    | Physical profile + training-context narrative shapes          |
+| `context`    | `GenerationContext` and its nested context blocks             |
+| `workspaces` | Workspace list/detail responses                               |
+| `sessions`   | Session create/update requests and responses                  |
+| `logs`       | Performance log content + `PerformanceSummary`                |
+| `exercises`  | Exercise resolution and search responses                      |
+| `reports`    | Progress report content and list/detail responses             |
+| `health`     | `/health` diagnostics response                                |
+
+## Versioning
+
+While in `0.x`, minor versions may introduce breaking changes. Consumers pin an
+**exact** version (`"@sessionplan/contracts": "0.1.0"`). See the contracts release
+playbook in the SES-80 work item for the publish/upgrade flow.
+
+## Development
+
+```sh
+npm install
+npm run build      # emit dist/ declarations + js
+npm run typecheck  # type-check without emitting
+```

package/dist/common.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Shared primitives used across the SessionPlan contract modules.
+ *
+ * This package is standalone: it does not import from the API codebase. The
+ * `JsonValue` alias below mirrors the Supabase `Json` type used server-side so
+ * that JSONB payload fields stay structurally compatible without a dependency.
+ */
+/** Recursive JSON value — mirrors the server-side Supabase `Json` type. */
+export type JsonValue = string | number | boolean | null | {
+    [key: string]: JsonValue | undefined;
+} | JsonValue[];
+export type UnitSystem = 'metric' | 'imperial';
+export type WeightUnit = 'lb' | 'kg';
+export type DistanceUnit = 'mi' | 'km';
+export type HeightUnit = 'ft' | 'cm';
+export type WorkspaceRole = 'admin' | 'member';
+export type TeamRole = 'facilitator' | 'participant';
+export type SessionScope = 'private' | 'workspace' | 'team';
+export type ExerciseScope = 'system' | 'workspace';
+export type LocationScope = 'system' | 'workspace' | 'private';
+export interface PaginationParams {
+    /** 1-indexed, default 1 */
+    page?: number;
+    /** default 20, max 100 */
+    limit?: number;
+}
+export interface PaginationMeta {
+    page: number;
+    limit: number;
+    total: number;
+    pages: number;
+}
+export interface PaginatedResponse<T> {
+    data: T[];
+    pagination: PaginationMeta;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;CAAE,GACxC,SAAS,EAAE,CAAC;AAMhB,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAC/C,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;AACrC,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,CAAC;AACvC,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;AAMrC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAC;AAC/C,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,aAAa,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,WAAW,CAAC;AACnD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;AAM/D,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,UAAU,EAAE,cAAc,CAAC;CAC5B"}

package/dist/common.js

@@ -0,0 +1,9 @@
+/**
+ * Shared primitives used across the SessionPlan contract modules.
+ *
+ * This package is standalone: it does not import from the API codebase. The
+ * `JsonValue` alias below mirrors the Supabase `Json` type used server-side so
+ * that JSONB payload fields stay structurally compatible without a dependency.
+ */
+export {};
+//# sourceMappingURL=common.js.map

package/dist/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/context.d.ts

@@ -0,0 +1,239 @@
+/**
+ * Generation context: the bundled, raw-data payload the API assembles for AI
+ * session generation. This is the single largest contract surface.
+ *
+ * IMPORTANT: this is RAW DATA for the AI to interpret. It contains no
+ * recommendations or training decisions — those stay with the AI client.
+ */
+import type { UnitSystem } from './common.js';
+import type { PhysicalProfile, ProfileNarrativeBlocks, MovementLimitation, TrainingProgramConfig, Sport } from './profile.js';
+import type { ExerciseSummary } from './logs.js';
+import type { ReportKPI } from './reports.js';
+export interface UserPreferences {
+    /** Total session time in minutes (wall-clock, including warm-up and cooldown). */
+    maxSessionMinutes: number;
+}
+export interface ProfileContext {
+    userId: string;
+    displayName?: string;
+    unitSystem: UnitSystem;
+    physical: PhysicalProfile;
+    narrativeBlocks: ProfileNarrativeBlocks;
+    movementLimitations: MovementLimitation[];
+    activeAggravatingPatternTags: string[];
+    injuries: string[];
+    experienceLevel: string;
+    goals: string | null;
+    trainingDays: string[];
+    splitStructure: string | null;
+    priorityMuscleGroups: string[];
+    rpeTarget: [number, number];
+    trainingProgram: TrainingProgramConfig;
+    deloadFrequencyWeeks?: number;
+    defaultLocationId: string | null;
+    sports: Sport[];
+    recoveryModalities: string[];
+    preferences: UserPreferences;
+}
+export interface EquipmentConfig {
+    type?: string;
+    weights?: number[];
+    angles?: number[];
+    available?: boolean;
+}
+export interface EquipmentContext {
+    locationId: string;
+    locationName: string;
+    locationType: 'personal' | 'commercial' | 'hotel' | 'outdoor';
+    equipment: Record<string, EquipmentConfig>;
+    dumbbellLadder?: number[];
+}
+export interface UnitContext {
+    system: UnitSystem;
+    weight: 'lb' | 'kg';
+    distance: 'mi' | 'km';
+    height: 'ft' | 'cm';
+}
+export interface ExerciseHistorySnapshot {
+    date: string;
+    load: string;
+    reps: number;
+    rpe: number;
+}
+export interface ExerciseHistorySummary {
+    exercise: string;
+    lastPerformed: string;
+    lastLoad: string;
+    lastReps: number;
+    avgRPE: number;
+    peakLoad?: string;
+    peakReps?: number;
+    peakDate?: string;
+    recentSessions?: ExerciseHistorySnapshot[];
+    volumeChange?: string;
+    prAchieved?: boolean;
+}
+export interface ExerciseIndexLog {
+    performed_at: string;
+    exerciseIndex?: Record<string, ExerciseSummary>;
+    unitSystem?: 'metric' | 'imperial';
+}
+/** Condensed from ExerciseProgressionRow — only the fields the AI needs. */
+export interface ProgressionTrend {
+    exercise: string;
+    volumeChange: string;
+    volumeChangeSentiment: 'positive' | 'neutral' | 'negative';
+    sessions: string;
+}
+export interface ReportSummary {
+    id: string;
+    grade: string;
+    periodStart: string;
+    periodEnd: string;
+    highlights: string[];
+    focusAreas: string[];
+    injuryStatus: string;
+    kpis?: ReportKPI[];
+    progressionTrends?: ProgressionTrend[];
+    recommendations?: string[];
+    blockRange?: string | null;
+}
+export interface HistoryContext {
+    source: 'report' | 'logs';
+    recentSessions: number;
+    exerciseHistory: ExerciseHistorySummary[];
+    reportSummary?: ReportSummary;
+}
+export interface SameWeekSession {
+    sessionId: string;
+    title: string;
+    scheduledFor: string;
+    exercises: string[];
+    /** Per-exercise set counts extracted from prescription (key = exercise name). */
+    exerciseSets?: Record<string, number>;
+}
+export interface CompactPrescription {
+    sets?: number | null;
+    reps?: number | string | null;
+    weight?: number | string | null;
+    multiplier?: number | null;
+    angle?: number | null;
+    rpe?: number | null;
+    timeSeconds?: number | null;
+    holdSeconds?: number | null;
+    distanceMeters?: number | null;
+    distanceMiles?: number | null;
+    restSeconds?: number | null;
+}
+export interface RecentSessionTemplateItem {
+    kind: 'exercise' | 'superset' | 'circuit';
+    name: string;
+    link?: string | null;
+    prescription?: CompactPrescription | null;
+    children?: Array<{
+        name: string;
+        link?: string | null;
+        prescription?: CompactPrescription | null;
+    }> | null;
+}
+export interface RecentSessionTemplateSection {
+    type: string;
+    title: string;
+    displayMode?: 'reference' | 'log' | null;
+    items: RecentSessionTemplateItem[];
+}
+export interface RecentSessionTemplate {
+    sessionId: string;
+    title: string;
+    scheduledFor: string | null;
+    block?: number | null;
+    week?: number | null;
+    sessionType?: string | null;
+    completion?: {
+        status: 'planned' | 'logged';
+        logId?: string;
+        performedAt?: string;
+        logKind?: 'quick' | 'full';
+        signalCompleteness?: 'session-only' | 'set-level';
+        completionStatus?: 'completed' | 'partial' | 'skipped';
+        sessionRpe?: number;
+        painType?: 'none' | 'soreness' | 'acute';
+        skippedSections?: string[];
+    };
+    sections: RecentSessionTemplateSection[];
+}
+export interface PeriodizationSignals {
+    current?: {
+        block?: number;
+        week?: number;
+        weekInCycle?: number;
+        cycleLength?: number;
+        phase?: 'reset' | 'build' | 'peak' | 'deload';
+    };
+    lastDeload?: {
+        block: number;
+        week: number;
+        scheduledFrom: string | null;
+        scheduledTo: string | null;
+        sessionIds: string[];
+        detectedBy: Array<'cycle-position' | 'prescription-reduction' | 'low-rpe'>;
+    };
+    lastHardWeek?: {
+        block: number;
+        week: number;
+        scheduledFrom: string | null;
+        scheduledTo: string | null;
+        sessionIds: string[];
+        relation: 'pre-deload' | 'latest-non-deload';
+    };
+}
+export type DefaultLogType = 'strength' | 'isometric' | 'conditioning' | 'endurance' | 'carry' | 'mobility' | 'stretch';
+export interface ExerciseEntry {
+    name: string;
+    equipment: string[];
+    tags: string[];
+    primary_muscles: string[];
+    secondary_muscles: string[];
+    movement_pattern: string | null;
+    level: string | null;
+    defaultLogType: DefaultLogType;
+}
+export interface ExerciseIndex {
+    [slug: string]: ExerciseEntry;
+}
+/** Per-muscle-group weekly set count. */
+export interface WeeklyMuscleVolume {
+    muscle: string;
+    sets: number;
+    sessions: number;
+}
+/** Metadata that helps AI clients distinguish absent profile data from user-confirmed settings. */
+export interface OnboardingState {
+    isZeroProfile: boolean;
+    hasNarrativeContext: boolean;
+    hasTrainingHistory: boolean;
+    hasDefaultLocation: boolean;
+    defaultedFields: string[];
+    recentLogCount: number;
+    recentSessionCount: number;
+    lastContextWriteAt: string | null;
+    staleContext: boolean;
+}
+export interface GenerationContext {
+    unitSystem: UnitSystem;
+    units: UnitContext;
+    /** Pre-formatted delimited block for prompt assembly. */
+    userUnitsBlock: string;
+    profile: ProfileContext;
+    equipment: EquipmentContext;
+    history: HistoryContext;
+    onboardingState: OnboardingState;
+    exercises: ExerciseIndex;
+    sameWeekSessions: SameWeekSession[];
+    recentSessionTemplates: RecentSessionTemplate[];
+    weeklyVolume?: WeeklyMuscleVolume[];
+    derivedBlock?: number;
+    derivedWeek?: number;
+    periodizationSignals?: PeriodizationSignals;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}

package/dist/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":""}

package/dist/exercises.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Exercise resolution, search, and detail responses.
+ */
+import type { JsonValue, ExerciseScope, PaginationParams } from './common.js';
+/** Confidence level of exercise name resolution. */
+export type ResolveConfidence = 'exact' | 'alias' | 'fuzzy' | 'unresolved';
+/** Single resolution result. */
+export interface ExerciseResolution {
+    /** The name the AI provided. */
+    inputName: string;
+    /** Canonical slug (always populated — computed via slugify even if unresolved). */
+    slug: string;
+    /** Whether the exercise exists in the database. */
+    found: boolean;
+    /** How the match was made. */
+    confidence: ResolveConfidence;
+    /** Canonical display name (from DB if found, from input if not). */
+    canonicalName: string;
+    /** Link path (only if found in DB). */
+    link: string | null;
+    /** Suggested alternative if fuzzy matched to a different exercise. */
+    suggestion?: string;
+}
+/** Batch resolution request. */
+export interface ResolveExercisesRequest {
+    names: string[];
+    workspace_id: string;
+}
+/** Batch resolution response. */
+export interface ResolveExercisesResponse {
+    resolutions: ExerciseResolution[];
+    stats: {
+        total: number;
+        exact: number;
+        alias: number;
+        fuzzy: number;
+        unresolved: number;
+    };
+}
+export interface ExerciseListParams extends PaginationParams {
+    tag?: string;
+    equipment?: string;
+    search?: string;
+    scope?: ExerciseScope;
+}
+export interface ExerciseCreateRequest {
+    slug: string;
+    name: string;
+    equipment?: string[];
+    tags?: string[];
+    setup?: string[];
+    steps?: string[];
+    cues?: string[];
+    mistakes?: string[];
+    safety?: string;
+    scaling?: {
+        regressions?: string[];
+        progressions?: string[];
+    };
+    variations?: string[];
+    prescription_hints?: Record<string, unknown>;
+    joints?: Record<string, unknown>;
+    media?: Record<string, unknown>;
+}
+export interface ExerciseUpdateRequest {
+    name?: string;
+    equipment?: string[];
+    tags?: string[];
+    setup?: string[];
+    steps?: string[];
+    cues?: string[];
+    mistakes?: string[];
+    safety?: string;
+    scaling?: {
+        regressions?: string[];
+        progressions?: string[];
+    };
+    variations?: string[];
+    prescription_hints?: Record<string, unknown>;
+    joints?: Record<string, unknown>;
+    media?: Record<string, unknown>;
+}
+/** Exercise with scope info for API responses. */
+export interface ExerciseWithScope {
+    id: string;
+    slug: string;
+    name: string;
+    equipment: string[];
+    tags: string[];
+    setup: string[];
+    steps: string[];
+    cues: string[];
+    mistakes: string[];
+    safety: string | null;
+    scaling: JsonValue | null;
+    variations: string[];
+    prescription_hints: JsonValue | null;
+    joints: JsonValue | null;
+    media: JsonValue | null;
+    scope: ExerciseScope;
+    workspace_id: string | null;
+    created_by: string | null;
+    created_at: string;
+    updated_at: string;
+}
+//# sourceMappingURL=exercises.d.ts.map

package/dist/exercises.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exercises.d.ts","sourceRoot":"","sources":["../src/exercises.ts"],"names":[],"mappings":"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"}

package/dist/exercises.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=exercises.js.map

package/dist/exercises.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exercises.js","sourceRoot":"","sources":["../src/exercises.ts"],"names":[],"mappings":""}

package/dist/health.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Health / diagnostics response shared by SessionPlan services.
+ *
+ * `version` is the service's own package version; `contractsVersion` is the
+ * `@sessionplan/contracts` revision the service was built against. Services also
+ * surface these as `X-Service-Version` / `X-Contracts-Version` response headers.
+ */
+export interface HealthResponse {
+    status: 'ok' | 'degraded' | 'error';
+    service: string;
+    timestamp: string;
+    /** Service package version (e.g. the API or MCP server version). */
+    version?: string;
+    /** `@sessionplan/contracts` version the service was built against. */
+    contractsVersion?: string;
+    database?: {
+        connected: boolean;
+        exerciseCount?: number;
+        locationCount?: number;
+        error?: string;
+    };
+}
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,OAAO,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE;QACT,SAAS,EAAE,OAAO,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH"}

package/dist/health.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=health.js.map

package/dist/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @sessionplan/contracts
+ *
+ * Shared TypeScript wire contracts for the SessionPlan API. Type-only except for
+ * the `ContractVersion` constant below.
+ *
+ * Public for installation convenience; not a stable external contract until 1.0.
+ */
+export * from './common.js';
+export * from './profile.js';
+export * from './context.js';
+export * from './workspaces.js';
+export * from './sessions.js';
+export * from './logs.js';
+export * from './exercises.js';
+export * from './reports.js';
+export * from './health.js';
+/**
+ * The contract revision this build was published at. Mirrors package.json
+ * version so clients can report the contract they were compiled against.
+ */
+export declare const ContractVersion = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAE5B;;;GAGG;AACH,eAAO,MAAM,eAAe,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * @sessionplan/contracts
+ *
+ * Shared TypeScript wire contracts for the SessionPlan API. Type-only except for
+ * the `ContractVersion` constant below.
+ *
+ * Public for installation convenience; not a stable external contract until 1.0.
+ */
+export * from './common.js';
+export * from './profile.js';
+export * from './context.js';
+export * from './workspaces.js';
+export * from './sessions.js';
+export * from './logs.js';
+export * from './exercises.js';
+export * from './reports.js';
+export * from './health.js';
+/**
+ * The contract revision this build was published at. Mirrors package.json
+ * version so clients can report the contract they were compiled against.
+ */
+export const ContractVersion = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAE5B;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC"}