catence 0.2.0-beta.23 → 0.2.0-beta.25

package/dist/contracts/release.d.ts

@@ -3,7 +3,7 @@
  * Keep these values synchronized with release/manifest.json; release checks
  * deliberately reject drift before a package can be published.
  */
-export declare const CATENCE_RUNTIME_VERSION = "0.2.0-beta.23";
+export declare const CATENCE_RUNTIME_VERSION = "0.2.0-beta.25";
 export declare const CATENCE_PROTOCOL_VERSION = 1;
 export type CatenceRuntimeCapabilities = {
     mcp: true;

package/dist/contracts/release.js

@@ -3,7 +3,7 @@
  * Keep these values synchronized with release/manifest.json; release checks
  * deliberately reject drift before a package can be published.
  */
-export const CATENCE_RUNTIME_VERSION = '0.2.0-beta.23';
+export const CATENCE_RUNTIME_VERSION = '0.2.0-beta.25';
 export const CATENCE_PROTOCOL_VERSION = 1;
 export function catenceRuntimeHealth() {
     return {

package/dist/core/query/activity-discovery.d.ts

@@ -1,6 +1,8 @@
 import { ReadOnlyRepository } from './repository.js';
 export type FindActivitiesRequest = {
     sports?: string[];
+    /** Accepted as a convenience alias for `sports: [sport]`. */
+    sport?: string;
     distanceKm?: [number, number];
     nameContains?: string[];
     startDate?: string;

package/dist/core/query/activity-discovery.js

@@ -49,7 +49,7 @@ export class ActivityDiscoveryService {
         this.repository = repository;
     }
     async findActivities(request = {}) {
-        const sports = [...new Set((request.sports ?? []).map((sport) => sport.trim()).filter(Boolean))];
+        const sports = [...new Set((request.sports ?? (request.sport ? [request.sport] : [])).map((sport) => sport.trim()).filter(Boolean))];
         const names = [...new Set((request.nameContains ?? []).map((name) => name.trim()).filter(Boolean))];
         if (sports.length > 12 || names.length > 12)
             throw new QueryValidationError('sports and nameContains each permit at most 12 values.');

package/dist/core/query/catalog.js

@@ -25,7 +25,7 @@ export const DATASET_CATALOG = {
         columns: [column('activity_source_id', 'VARCHAR', { filterable: true, groupable: true }), column('activity_id', 'VARCHAR', { filterable: true, groupable: true }), column('provider', 'VARCHAR', { filterable: true, groupable: true }), column('started_at_utc', 'TIMESTAMPTZ', { filterable: true }), column('sport', 'VARCHAR', { filterable: true, groupable: true }), column('interval_key', 'VARCHAR', { filterable: true }), column('label', 'VARCHAR', { filterable: true, groupable: true }), column('source_type', 'VARCHAR', { filterable: true, groupable: true }), column('start_s', 'DOUBLE', { unit: 's', metric: true }), column('end_s', 'DOUBLE', { unit: 's', metric: true }), column('duration_s', 'DOUBLE', { unit: 's', metric: true }), column('moving_s', 'DOUBLE', { unit: 's', metric: true }), column('distance_m', 'DOUBLE', { unit: 'm', metric: true }), column('avg_power', 'DOUBLE', { unit: 'W', metric: true }), column('avg_hr', 'DOUBLE', { unit: 'bpm', metric: true }), column('avg_pace', 'DOUBLE', { metric: true }), column('intensity', 'DOUBLE', { metric: true })],
     },
     swim_lengths: {
-        name: 'swim_lengths', relation: 'swim_length_facts', description: 'Explicit provider-supplied swim-length facts. An empty result means lengths were not supplied; Catence does not infer them from activity samples.', dateColumn: 'started_at_utc', provenanceColumns: ['activity_source_id', 'source', 'confidence', 'raw_object_hash'], permittedGroupings: ['provider', 'sport', 'source', 'confidence', 'is_rest'],
+        name: 'swim_lengths', relation: 'swim_length_facts', description: 'Explicit provider-supplied swim-length facts. An empty result means lengths were not supplied; Catence does not infer them from activity samples. Per-length swolf may be null (not supplied by all providers); derive as duration_s + stroke_count. Per-length distance is typically null in Garmin FIT; use pool_length_m to compute pace (duration_s / pool_length_m * 100 for s/100m).', dateColumn: 'started_at_utc', provenanceColumns: ['activity_source_id', 'source', 'confidence', 'raw_object_hash'], permittedGroupings: ['provider', 'sport', 'source', 'confidence', 'is_rest'],
         columns: [column('activity_source_id', 'VARCHAR', { filterable: true, groupable: true }), column('activity_id', 'VARCHAR', { filterable: true, groupable: true }), column('provider', 'VARCHAR', { filterable: true, groupable: true }), column('started_at_utc', 'TIMESTAMPTZ', { filterable: true }), column('sport', 'VARCHAR', { filterable: true, groupable: true }), column('source', 'VARCHAR', { filterable: true, groupable: true }), column('confidence', 'VARCHAR', { filterable: true, groupable: true }), column('length_index', 'INTEGER', { filterable: true, groupable: true }), column('lap_index', 'INTEGER', { filterable: true, groupable: true }), column('pool_length_m', 'DOUBLE', { unit: 'm', metric: true }), column('start_time', 'TIMESTAMPTZ', { filterable: true }), column('duration_s', 'DOUBLE', { unit: 's', metric: true }), column('active_duration_s', 'DOUBLE', { unit: 's', metric: true }), column('distance_m', 'DOUBLE', { unit: 'm', metric: true }), column('stroke_count', 'DOUBLE', { unit: 'count', metric: true }), column('stroke_rate', 'DOUBLE', { unit: 'strokes/min', metric: true }), column('swolf', 'DOUBLE', { metric: true }), column('avg_hr', 'DOUBLE', { unit: 'bpm', metric: true }), column('max_hr', 'DOUBLE', { unit: 'bpm', metric: true }), column('is_rest', 'BOOLEAN', { filterable: true, groupable: true }), column('raw_object_hash', 'VARCHAR')],
     },
     swim_sets: {

package/dist/core/query/swimming.js

@@ -86,7 +86,7 @@ export class SwimmingService {
                 availability: {
                     explicitLengthFacts: lengths.length > 0,
                     setFacts: sets.length > 0,
-                    perLengthPaceAvailable: lengths.some((length) => Number(length.duration_s) > 0 && Number(length.distance_m) > 0),
+                    perLengthPaceAvailable: lengths.some((length) => Number(length.duration_s) > 0),
                 },
             };
         }));
@@ -123,7 +123,7 @@ export class SwimmingService {
         FROM activity_quality_flags GROUP BY activity_source_id
       ), lengths AS (
         SELECT activity_source_id, count(*) AS length_fact_count,
-          count(*) FILTER (WHERE duration_s > 0 AND distance_m > 0) AS pace_length_fact_count
+          count(*) FILTER (WHERE duration_s > 0) AS pace_length_fact_count
         FROM swim_lengths GROUP BY activity_source_id
       ), sets AS (
         SELECT activity_source_id, count(*) AS set_fact_count FROM swim_sets GROUP BY activity_source_id

package/dist/interfaces/mcp/server.js

@@ -32,6 +32,7 @@ const MCP_INSTRUCTIONS = [
     'When summary metric is NULL (e.g. avg_power), fall through to FIT-derived/samples layer before declaring absence.',
     'Before reusing any prior course/elevation profile, resolve event\'s courseId and diff it against past activity\'s course; different courseId => different profile.',
     'If a needed tool is not visible in your current tool list (the host may truncate it to a subset), read the catence://tools resource to discover all available tools before concluding a capability is absent.',
+    'For swim analysis: use find_activities (sports: ["lap_swimming"] or sport: "lap_swimming") to list pool sessions. Use get_swim_laps for per-length data (pace from duration_s/pool_length_m, SPL from stroke_count, SWOLF from duration_s+stroke_count). Use swim_progress_report for session-level SWOLF, fastest-100, and stroke cadence. Per-length SWOLF is derived when the provider does not supply it. Per-length distance is typically null in Garmin FIT; use pool_length_m for pace calculations.',
 ].join(' ');
 function textResult(value) {
     return { content: [{ type: 'text', text: JSON.stringify(jsonSafe(value), null, 2) }] };
@@ -162,10 +163,29 @@ export function createCatenceMcpServer(paths = resolveCatalogPaths(), dependenci
         const originalRegister = server.registerTool.bind(server);
         server.registerTool = (name, configuration, handler) => {
             const originalInput = configuration.inputSchema;
+            let mergedInputSchema;
+            if (originalInput) {
+                const hasV4 = '_zod' in originalInput;
+                const hasV3 = '_def' in originalInput;
+                if (hasV4 || hasV3) {
+                    // originalInput is already a Zod object schema; extract its shape and
+                    // merge athleteId into a new object of the same Zod version.
+                    const rawShape = originalInput.shape;
+                    const shape = typeof rawShape === 'object' && rawShape !== null ? rawShape : {};
+                    mergedInputSchema = z.object({ ...shape, athleteId: athleteIdSchema });
+                }
+                else {
+                    // originalInput is a raw shape (plain object of Zod schemas).
+                    mergedInputSchema = { athleteId: athleteIdSchema, ...originalInput };
+                }
+            }
+            else {
+                mergedInputSchema = { athleteId: athleteIdSchema };
+            }
             return originalRegister(name, {
                 ...configuration,
                 description: `${String(configuration.description ?? '')} Requires athleteId from list_athletes.`,
-                inputSchema: { athleteId: athleteIdSchema, ...(originalInput ?? {}) },
+                inputSchema: mergedInputSchema,
             }, handler);
         };
     }
@@ -460,6 +480,7 @@ export function createCatenceMcpServer(paths = resolveCatalogPaths(), dependenci
         title: 'Find activities and likely races',
         description: 'Find canonical activities by sport, distance, name, and date. Results are paginated and transparently flag likely-race signals without claiming provider-confirmed race metadata. Read-only.',
         inputSchema: {
+            sport: z.string().min(1).optional(),
             sports: z.array(z.string().min(1)).min(1).max(12).optional(),
             distanceKm: z.tuple([z.number().min(0), z.number().min(0)]).optional(),
             nameContains: z.array(z.string().min(1)).min(1).max(12).optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "catence",
-  "version": "0.2.0-beta.23",
+  "version": "0.2.0-beta.25",
   "description": "Local MCP access to normalized Garmin, Intervals.icu, and targeted Strava fitness data.",
   "license": "AGPL-3.0-or-later",
   "repository": {