@demind-inc/core 1.7.49 → 1.7.50

package/dist/models/Calendar.d.ts

@@ -1,5 +1,6 @@
 import { DocumentReference } from "@google-cloud/firestore";
 import { TodoAppFrom } from "./TodoTasks";
+import { RichContext } from "./RichContext";
 export type CalendarType = "google" | "outlook" | "lifestack" | "apple";
 export type CalendarScope = "owner" | "writer" | "reader" | "freeBusyReader";
 export type CalendarEventStatus = "confirmed" | "tentative" | "cancelled";
@@ -46,6 +47,7 @@ export interface CalendarEvent {
     eventId: string;
     summary: string;
     description?: string;
+    richContext?: RichContext | null;
     start: {
         date: string;
         timeZone: string;

package/dist/models/RichContext.d.ts

@@ -0,0 +1,166 @@
+export type SignalSource = "location" | "weather" | "energy" | "sleep" | "screen_time" | "commute" | "menstrual_cycle" | "steps" | "medication" | (string & {});
+export interface Location {
+    name: string;
+    lat: number | null;
+    lng: number | null;
+}
+export interface Signal {
+    signal_source: SignalSource;
+    urgency: "now" | "today" | "info";
+    body: string;
+    expires_at: string | null;
+    data: SignalData | null;
+}
+export type SignalData = {
+    name: string;
+    distance_m: number | null;
+    lat: number | null;
+    lng: number | null;
+    place_type: string | null;
+} | {
+    condition: string;
+    temp_c: number | null;
+    feels_like_c: number | null;
+    rain_probability: number | null;
+    uv_index: number | null;
+} | {
+    zone: "peak" | "calm" | "low" | "recovering";
+    hrv: number | null;
+    sleep_score: number | null;
+    readiness_score: number | null;
+} | {
+    duration_h: number;
+    quality_score: number | null;
+    deep_h: number | null;
+    rem_h: number | null;
+    awakenings: number | null;
+} | {
+    total_min: number;
+    last_2h_min: number | null;
+    top_app: string | null;
+} | {
+    duration_min: number;
+    mode: "transit" | "driving" | "walking" | "cycling";
+    origin: string | null;
+    destination: string | null;
+} | {
+    phase: "menstrual" | "follicular" | "ovulatory" | "luteal";
+    day_in_cycle: number;
+    energy_modifier: number;
+} | {
+    today: number;
+    goal: number;
+    percent_complete: number;
+} | {
+    name: string;
+    dose: string | null;
+    taken_today: boolean;
+    next_due_at: string | null;
+} | Record<string, unknown>;
+export type ActionType = "start_timer" | "open_map" | "open_url" | "log_metric" | "dismiss" | (string & {});
+export type ActionPayload = {
+    duration_min: number;
+    session_title: string | null;
+} | {
+    destination_name: string;
+    lat: number;
+    lng: number;
+} | {
+    url: string | null;
+    open_in: "webview" | "browser";
+} | {
+    metric_type: string;
+    value: number | null;
+    unit: string | null;
+} | null;
+export interface Action {
+    label: string;
+    action_type: ActionType;
+    payload: ActionPayload;
+}
+export type ContentType = "workout_plan" | "checklist" | "meal_suggestion" | "transit_route" | "journal_prompts" | "audio_player" | "energy_summary" | "sleep_summary" | "metric_bar" | "meal_plan_week" | (string & {});
+export type ContentPayload = {
+    plan_title: string;
+    difficulty: "beginner" | "intermediate" | "advanced";
+    exercises: {
+        name: string;
+        sets: number;
+        reps: number;
+        note: string | null;
+    }[];
+} | {
+    label: string | null;
+    items: {
+        text: string;
+        done: boolean;
+    }[];
+} | {
+    venue_name: string;
+    dish_name: string;
+    dish_tags: string[];
+    kcal: number | null;
+    image_url: string | null;
+    price: number | null;
+    rating: number | null;
+    menu_url: string | null;
+} | {
+    origin: string;
+    destination: string;
+    depart_by: string;
+} | {
+    label: string | null;
+    prompts: string[];
+} | {
+    track_name: string;
+    category: "sleep" | "focus" | "meditation" | "wind_down";
+    duration_min: number | null;
+    stream_url: string | null;
+} | {
+    current_zone: "peak" | "calm" | "low" | "recovering";
+    zones: {
+        label: string;
+        start: string;
+        end: string;
+        level: "peak" | "calm" | "low";
+    }[];
+} | {
+    duration_h: number;
+    quality_score: number | null;
+    deep_h: number | null;
+    rem_h: number | null;
+    awakenings: number | null;
+    chart_data: {
+        stage: "awake" | "light" | "deep" | "rem";
+        start_min: number;
+        end_min: number;
+    }[];
+} | {
+    label: string;
+    value: number;
+    unit: string;
+    min: number;
+    max: number;
+    baseline: number | null;
+    color_ramp: "red_to_green" | "green_to_red" | "neutral";
+} | {
+    days: {
+        date: string;
+        meals: {
+            slot: "breakfast" | "lunch" | "dinner" | "snack";
+            dish: string;
+            kcal: number | null;
+            time: string | null;
+        }[];
+    }[];
+} | Record<string, unknown>;
+export interface Content {
+    type: ContentType;
+    payload: ContentPayload;
+}
+export interface RichContext {
+    signals: Signal[];
+    location: Location | null;
+    reminder_min: number | null;
+    action: Action | null;
+    content: Content | Content[] | null;
+}

package/dist/models/RichContext.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/index.d.ts

@@ -15,3 +15,4 @@ export * from "./TaskLabels";
 export * from "./Routine";
 export * from "./Chat";
 export * from "./SharedAccess";
+export * from "./RichContext";

package/dist/models/index.js

@@ -31,3 +31,4 @@ __exportStar(require("./TaskLabels"), exports);
 __exportStar(require("./Routine"), exports);
 __exportStar(require("./Chat"), exports);
 __exportStar(require("./SharedAccess"), exports);
+__exportStar(require("./RichContext"), exports);

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import { CalendarEvent, CalendarRoutineFrom, CalendarTaskFrom, EMASatisfaction, EnergyFeedbackType, EventCategorySet, MealType, MetricActivity, MetricHRValueSet, MetricMealDetail, MetricMealSummary, MetricStressValueSet, PhaseStartEndSet, RoutineActivity, SleepDetail, TaskItem, TaskPriority, TodoAppFrom } from "./models";
+import { CalendarEvent, CalendarRoutineFrom, CalendarTaskFrom, EMASatisfaction, EnergyFeedbackType, EventCategorySet, MealType, MetricActivity, MetricHRValueSet, MetricMealDetail, MetricMealSummary, MetricStressValueSet, PhaseStartEndSet, RichContext, RoutineActivity, SleepDetail, TaskItem, TaskPriority, TodoAppFrom } from "./models";
 export type SupportedTerraProvidersType = "FITBIT" | "OURA" | "GARMIN" | "WHOOP" | "ULTRAHUMAN" | "STRAVA" | "MYFITNESSPAL";
 export type SupportedTerraSDKType = "APPLE" | "GOOGLE_FIT" | "SAMSUNG_HEALTH" | "FREESTYLE_LIBRE";
 export type CircadianPhase = "default" | "wakeup_low" | "wakeup_normal" | "morning_high" | "morning_normal" | "morning_low" | "evening_high" | "evening_low" | "evening_normal";
@@ -41,6 +41,7 @@ export interface ScheduledAction {
     eventFrom?: ScheduledActionEventFrom;
     priority?: TaskPriority;
     actionType?: ScheduledActionType;
+    richContext?: RichContext | null;
 }
 export interface ScheduledActionOptions {
     startDate: string;

package/lib/models/Calendar.ts

@@ -1,5 +1,6 @@
 import { DocumentReference } from "@google-cloud/firestore";
 import { TodoAppFrom } from "./TodoTasks";
+import { RichContext } from "./RichContext";
 
 export type CalendarType = "google" | "outlook" | "lifestack" | "apple";
 export type CalendarScope = "owner" | "writer" | "reader" | "freeBusyReader";
@@ -52,6 +53,7 @@ export interface CalendarEvent {
   eventId: string;
   summary: string;
   description?: string;
+  richContext?: RichContext | null;
   start: {
     date: string;
     timeZone: string;

package/lib/models/RichContext.ts

@@ -0,0 +1,252 @@
+export type SignalSource =
+  | "location"
+  | "weather"
+  | "energy"
+  | "sleep"
+  | "screen_time"
+  | "commute"
+  | "menstrual_cycle"
+  | "steps"
+  | "medication"
+  | (string & {});
+
+export interface Location {
+  name: string;
+  lat: number | null;
+  lng: number | null;
+}
+
+export interface Signal {
+  signal_source: SignalSource;
+  urgency: "now" | "today" | "info";
+  // Must describe a concrete value (ex: "HRV 64"), not an opinion (ex: "energy is good").
+  body: string;
+  // ISO 8601
+  expires_at: string | null;
+  data: SignalData | null;
+}
+
+export type SignalData =
+  | {
+      // location
+      name: string;
+      distance_m: number | null;
+      lat: number | null;
+      lng: number | null;
+      place_type: string | null;
+    }
+  | {
+      // weather
+      condition: string;
+      temp_c: number | null;
+      feels_like_c: number | null;
+      rain_probability: number | null;
+      uv_index: number | null;
+    }
+  | {
+      // energy
+      zone: "peak" | "calm" | "low" | "recovering";
+      hrv: number | null;
+      sleep_score: number | null;
+      readiness_score: number | null;
+    }
+  | {
+      // sleep
+      duration_h: number;
+      quality_score: number | null;
+      deep_h: number | null;
+      rem_h: number | null;
+      awakenings: number | null;
+    }
+  | {
+      // screen_time
+      total_min: number;
+      last_2h_min: number | null;
+      top_app: string | null;
+    }
+  | {
+      // commute
+      duration_min: number;
+      mode: "transit" | "driving" | "walking" | "cycling";
+      origin: string | null;
+      destination: string | null;
+    }
+  | {
+      // menstrual_cycle
+      phase: "menstrual" | "follicular" | "ovulatory" | "luteal";
+      day_in_cycle: number;
+      energy_modifier: number;
+    }
+  | {
+      // steps
+      today: number;
+      goal: number;
+      percent_complete: number;
+    }
+  | {
+      // medication
+      name: string;
+      dose: string | null;
+      taken_today: boolean;
+      next_due_at: string | null;
+    }
+  | Record<string, unknown>;
+
+export type ActionType =
+  | "start_timer"
+  | "open_map"
+  | "open_url"
+  | "log_metric"
+  | "dismiss"
+  | (string & {});
+
+export type ActionPayload =
+  | {
+      // start_timer
+      duration_min: number;
+      session_title: string | null;
+    }
+  | {
+      // open_map
+      destination_name: string;
+      lat: number;
+      lng: number;
+    }
+  | {
+      // open_url
+      url: string | null;
+      open_in: "webview" | "browser";
+    }
+  | {
+      // log_metric
+      metric_type: string;
+      value: number | null;
+      unit: string | null;
+    }
+  | null;
+
+export interface Action {
+  label: string;
+  action_type: ActionType;
+  payload: ActionPayload;
+}
+
+export type ContentType =
+  | "workout_plan"
+  | "checklist"
+  | "meal_suggestion"
+  | "transit_route"
+  | "journal_prompts"
+  | "audio_player"
+  | "energy_summary"
+  | "sleep_summary"
+  | "metric_bar"
+  | "meal_plan_week"
+  | (string & {});
+
+export type ContentPayload =
+  | {
+      // workout_plan
+      plan_title: string;
+      difficulty: "beginner" | "intermediate" | "advanced";
+      exercises: {
+        name: string;
+        sets: number;
+        reps: number;
+        note: string | null;
+      }[];
+    }
+  | {
+      // checklist
+      label: string | null;
+      items: { text: string; done: boolean }[];
+    }
+  | {
+      // meal_suggestion
+      venue_name: string;
+      dish_name: string;
+      dish_tags: string[];
+      kcal: number | null;
+      image_url: string | null;
+      price: number | null;
+      rating: number | null;
+      menu_url: string | null;
+    }
+  | {
+      // transit_route
+      origin: string;
+      destination: string;
+      depart_by: string;
+    }
+  | {
+      // journal_prompts
+      label: string | null;
+      prompts: string[];
+    }
+  | {
+      // audio_player
+      track_name: string;
+      category: "sleep" | "focus" | "meditation" | "wind_down";
+      duration_min: number | null;
+      stream_url: string | null;
+    }
+  | {
+      // energy_summary
+      current_zone: "peak" | "calm" | "low" | "recovering";
+      zones: {
+        label: string;
+        start: string;
+        end: string;
+        level: "peak" | "calm" | "low";
+      }[];
+    }
+  | {
+      // sleep_summary
+      duration_h: number;
+      quality_score: number | null;
+      deep_h: number | null;
+      rem_h: number | null;
+      awakenings: number | null;
+      chart_data: {
+        stage: "awake" | "light" | "deep" | "rem";
+        start_min: number;
+        end_min: number;
+      }[];
+    }
+  | {
+      // metric_bar
+      label: string;
+      value: number;
+      unit: string;
+      min: number;
+      max: number;
+      baseline: number | null;
+      color_ramp: "red_to_green" | "green_to_red" | "neutral";
+    }
+  | {
+      // meal_plan_week
+      days: {
+        date: string;
+        meals: {
+          slot: "breakfast" | "lunch" | "dinner" | "snack";
+          dish: string;
+          kcal: number | null;
+          time: string | null;
+        }[];
+      }[];
+    }
+  | Record<string, unknown>;
+
+export interface Content {
+  type: ContentType;
+  payload: ContentPayload;
+}
+
+export interface RichContext {
+  signals: Signal[];
+  location: Location | null;
+  reminder_min: number | null;
+  action: Action | null;
+  content: Content | Content[] | null;
+}
+

package/lib/models/index.ts

@@ -15,3 +15,4 @@ export * from "./TaskLabels";
 export * from "./Routine";
 export * from "./Chat";
 export * from "./SharedAccess";
+export * from "./RichContext";

package/lib/types.ts

@@ -12,6 +12,7 @@ import {
   MetricMealSummary,
   MetricStressValueSet,
   PhaseStartEndSet,
+  RichContext,
   RoutineActivity,
   SleepDetail,
   TaskItem,
@@ -98,6 +99,7 @@ export interface ScheduledAction {
   eventFrom?: ScheduledActionEventFrom;
   priority?: TaskPriority;
   actionType?: ScheduledActionType;
+  richContext?: RichContext | null;
 }
 
 export interface ScheduledActionOptions {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@demind-inc/core",
-  "version": "1.7.49",
+  "version": "1.7.50",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {