@elizaos/plugin-personal-assistant 2.0.3-beta.5 → 2.0.3-beta.7

package/dist/lifeops/google/format-helpers.js

@@ -0,0 +1,597 @@
+import {
+  assertActiveTrajectoryForLlmCall,
+  ModelType,
+  parseJsonModelRecord,
+  runWithTrajectoryContext
+} from "@elizaos/core";
+import { getLocalDateKey, getZonedDateParts } from "../time.js";
+function truncateForPreview(value, maxLength) {
+  if (value.length <= maxLength) {
+    return value;
+  }
+  return `${value.slice(0, maxLength).trimEnd()}\u2026`;
+}
+function formatEmailSender(display, email) {
+  const trimmedDisplay = typeof display === "string" ? display.trim() : "";
+  const trimmedEmail = typeof email === "string" ? email.trim() : "";
+  if (trimmedDisplay && trimmedEmail && trimmedDisplay !== trimmedEmail) {
+    return `${trimmedDisplay} <${trimmedEmail}>`;
+  }
+  return trimmedDisplay || trimmedEmail || "unknown";
+}
+function toActionData(data) {
+  const record = {};
+  for (const [key, value] of Object.entries(data)) {
+    record[key] = value;
+  }
+  return record;
+}
+function messageSource(message) {
+  const source = message.content?.source;
+  return typeof source === "string" ? source : null;
+}
+function messageText(message) {
+  const text = message.content?.text;
+  return typeof text === "string" ? text : "";
+}
+function parseLifeOpsJsonRecord(rawResponse) {
+  return parseJsonModelRecord(rawResponse);
+}
+async function runLifeOpsTextModel(args) {
+  if (typeof args.runtime.useModel !== "function") {
+    return null;
+  }
+  const modelType = args.modelType ?? ModelType.TEXT_LARGE;
+  assertActiveTrajectoryForLlmCall({
+    actionType: args.actionType,
+    modelType: String(modelType),
+    purpose: args.purpose ?? "planner"
+  });
+  try {
+    const result = await runWithTrajectoryContext(
+      { purpose: args.purpose ?? `lifeops-${args.actionType}` },
+      () => args.runtime.useModel(modelType, {
+        prompt: args.prompt
+      })
+    );
+    return typeof result === "string" ? result : "";
+  } catch (error) {
+    args.runtime.logger.warn(
+      {
+        src: args.source,
+        error: error instanceof Error ? error.message : String(error)
+      },
+      args.failureMessage
+    );
+    return null;
+  }
+}
+async function runLifeOpsJsonModel(args) {
+  const rawResponse = await runLifeOpsTextModel(args);
+  if (rawResponse === null) {
+    return null;
+  }
+  return {
+    rawResponse,
+    parsed: parseLifeOpsJsonRecord(rawResponse)
+  };
+}
+function detailString(details, key) {
+  const value = details?.[key];
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function detailNumber(details, key) {
+  const value = details?.[key];
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function detailBoolean(details, key) {
+  const value = details?.[key];
+  return typeof value === "boolean" ? value : void 0;
+}
+function detailObject(details, key) {
+  const value = details?.[key];
+  return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function detailArray(details, key) {
+  const value = details?.[key];
+  return Array.isArray(value) ? value : void 0;
+}
+function dayRange(offset) {
+  const base = /* @__PURE__ */ new Date();
+  base.setHours(0, 0, 0, 0);
+  const start = new Date(base.getTime() + offset * 864e5);
+  return {
+    timeMin: start.toISOString(),
+    timeMax: new Date(start.getTime() + 864e5).toISOString()
+  };
+}
+function weekRange() {
+  const base = /* @__PURE__ */ new Date();
+  base.setHours(0, 0, 0, 0);
+  return {
+    timeMin: base.toISOString(),
+    timeMax: new Date(base.getTime() + 7 * 864e5).toISOString()
+  };
+}
+function futureRange(days) {
+  const base = /* @__PURE__ */ new Date();
+  base.setHours(0, 0, 0, 0);
+  return {
+    timeMin: base.toISOString(),
+    timeMax: new Date(base.getTime() + days * 864e5).toISOString()
+  };
+}
+function formatCalendarDatePart(date, timeZone, options) {
+  return new Intl.DateTimeFormat("en-US", {
+    timeZone,
+    ...options
+  }).format(date);
+}
+function getCalendarYearForDisplay(date, timeZone) {
+  return Number(
+    formatCalendarDatePart(date, timeZone, {
+      year: "numeric"
+    })
+  );
+}
+function formatCalendarEventDateTime(event, options) {
+  const start = new Date(event.startAt);
+  const timeZone = event.timezone || void 0;
+  const currentYear = getCalendarYearForDisplay(/* @__PURE__ */ new Date(), timeZone);
+  const eventYear = getCalendarYearForDisplay(start, timeZone);
+  const includeYear = options?.includeYear ?? eventYear !== currentYear;
+  const month = options?.numericDate ? "numeric" : "short";
+  const datePart = formatCalendarDatePart(start, timeZone, {
+    month,
+    day: "numeric",
+    ...includeYear ? { year: "numeric" } : {}
+  });
+  const timePart = formatCalendarDatePart(start, timeZone, {
+    hour: "numeric",
+    minute: "2-digit",
+    ...options?.includeTimeZoneName ? { timeZoneName: "short" } : {}
+  });
+  return `${datePart}, ${timePart}`;
+}
+function _formatEventTime(event) {
+  if (event.isAllDay) {
+    return "all day";
+  }
+  const start = new Date(event.startAt);
+  const end = new Date(event.endAt);
+  const timeZone = event.timezone || void 0;
+  const currentYear = getCalendarYearForDisplay(/* @__PURE__ */ new Date(), timeZone);
+  const eventYear = getCalendarYearForDisplay(start, timeZone);
+  const includeYear = eventYear !== currentYear;
+  const datePart = formatCalendarDatePart(start, timeZone, {
+    month: "short",
+    day: "numeric",
+    ...includeYear ? { year: "numeric" } : {}
+  });
+  const startTime = formatCalendarDatePart(start, timeZone, {
+    hour: "numeric",
+    minute: "2-digit"
+  });
+  const endTime = formatCalendarDatePart(end, timeZone, {
+    hour: "numeric",
+    minute: "2-digit"
+  });
+  return `${datePart}, ${startTime} \u2013 ${endTime}`;
+}
+function formatRelativeMinutes(minutes) {
+  if (minutes <= 0) {
+    return "now";
+  }
+  if (minutes < 60) {
+    return `in ${Math.round(minutes)} min`;
+  }
+  const hours = Math.floor(minutes / 60);
+  const remainingMinutes = Math.round(minutes % 60);
+  return remainingMinutes === 0 ? `in ${hours}h` : `in ${hours}h ${remainingMinutes}m`;
+}
+function formatRelativeTime(isoDate) {
+  const diff = Date.now() - Date.parse(isoDate);
+  const minutes = Math.floor(diff / 6e4);
+  if (minutes < 1) {
+    return "just now";
+  }
+  if (minutes < 60) {
+    return `${minutes}m ago`;
+  }
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) {
+    return `${hours}h ago`;
+  }
+  return `${Math.floor(hours / 24)}d ago`;
+}
+function formatEmailTriage(feed) {
+  if (feed.messages.length === 0) {
+    return "No important emails right now.";
+  }
+  const { summary } = feed;
+  const parts = [];
+  if (summary.unreadCount > 0) {
+    parts.push(`${summary.unreadCount} unread`);
+  }
+  if (summary.importantNewCount > 0) {
+    parts.push(`${summary.importantNewCount} important`);
+  }
+  if (summary.likelyReplyNeededCount > 0) {
+    parts.push(`${summary.likelyReplyNeededCount} likely need a reply`);
+  }
+  const lines = [
+    parts.length > 0 ? `Email inbox: ${parts.join(", ")}.` : "Email inbox:"
+  ];
+  for (const message of feed.messages.slice(0, 8)) {
+    const badges = [];
+    if (message.isImportant) {
+      badges.push("important");
+    }
+    if (message.likelyReplyNeeded) {
+      badges.push("reply needed");
+    }
+    const badgeText = badges.length > 0 ? ` [${badges.join(", ")}]` : "";
+    const sender = formatEmailSender(message.from, message.fromEmail);
+    lines.push(`- **${message.subject}**${badgeText}`);
+    lines.push(`  From: ${sender} \xB7 ${formatRelativeTime(message.receivedAt)}`);
+    if (message.snippet) {
+      lines.push(`  ${truncateForPreview(message.snippet, 100)}`);
+    }
+  }
+  return lines.join("\n");
+}
+function formatEmailNeedsResponse(feed) {
+  if (feed.messages.length === 0) {
+    return "No emails look like they need a reply right now.";
+  }
+  const lines = [
+    `Emails that likely need a reply: ${feed.summary.totalCount}.`
+  ];
+  for (const message of feed.messages.slice(0, 8)) {
+    const sender = formatEmailSender(message.from, message.fromEmail);
+    lines.push(
+      `- **${message.subject}** from ${sender} \xB7 ${formatRelativeTime(message.receivedAt)}`
+    );
+    if (message.snippet) {
+      lines.push(`  ${truncateForPreview(message.snippet, 120)}`);
+    }
+  }
+  return lines.join("\n");
+}
+function formatGmailRecommendations(feed) {
+  if (feed.recommendations.length === 0) {
+    return "No Gmail actions are recommended from the current email set.";
+  }
+  const lines = [`Recommended Gmail actions: ${feed.summary.totalCount}.`];
+  for (const recommendation of feed.recommendations.slice(0, 6)) {
+    const operation = recommendation.operation ? ` (${recommendation.operation.replace("_", " ")})` : "";
+    lines.push(
+      `- **${recommendation.title}**${operation}: ${recommendation.affectedCount} message${recommendation.affectedCount === 1 ? "" : "s"}`
+    );
+    lines.push(`  ${recommendation.rationale}`);
+    for (const sample of recommendation.sampleMessages.slice(0, 2)) {
+      const sender = formatEmailSender(sample.from, sample.fromEmail);
+      lines.push(`  - ${sample.subject} from ${sender}`);
+    }
+  }
+  return lines.join("\n");
+}
+function describeEmailSearchQuery(query) {
+  const parts = query.trim().split(/\s+/).map((part) => part.trim()).filter((part) => part.length > 0);
+  if (parts.length === 0) {
+    return `"${query}"`;
+  }
+  const sender = parts.find((part) => /^from:/i.test(part))?.replace(/^from:/i, "").replace(/^"|"$/g, "");
+  const newerThan = parts.find((part) => /^newer_than:/i.test(part))?.replace(/^newer_than:/i, "");
+  const before = parts.find((part) => /^before:/i.test(part))?.replace(/^before:/i, "");
+  const after = parts.find((part) => /^after:/i.test(part))?.replace(/^after:/i, "");
+  const isUnread = parts.some((part) => /^is:unread$/i.test(part));
+  const isImportant = parts.some((part) => /^is:important$/i.test(part));
+  const keywords = parts.filter(
+    (part) => !/^(from|newer_than|before|after|is):/i.test(part) && part.trim().length > 0
+  );
+  const descriptions = [];
+  const formatRelativeWindow = (value) => {
+    const match = value.match(/^(\d+)([dmy])$/i);
+    if (!match) {
+      return value;
+    }
+    const unitToken = match[2];
+    if (!unitToken) {
+      return value;
+    }
+    const unit = unitToken.toLowerCase() === "d" ? "day" : unitToken.toLowerCase() === "m" ? "month" : "year";
+    const amountToken = match[1];
+    if (!amountToken) {
+      return value;
+    }
+    const amount = Number(amountToken);
+    return `${amount} ${unit}${amount === 1 ? "" : "s"}`;
+  };
+  if (sender) {
+    descriptions.push(`sender "${sender}"`);
+  }
+  if (keywords.length > 0) {
+    descriptions.push(`matching "${keywords.join(" ")}"`);
+  }
+  if (newerThan) {
+    descriptions.push(`from the last ${formatRelativeWindow(newerThan)}`);
+  }
+  if (after) {
+    descriptions.push(`after ${after}`);
+  }
+  if (before) {
+    descriptions.push(`before ${before}`);
+  }
+  if (isUnread) {
+    descriptions.push("that are unread");
+  }
+  if (isImportant) {
+    descriptions.push("that are marked important");
+  }
+  return descriptions.length > 0 ? descriptions.join(" ") : `"${query}"`;
+}
+function formatEmailSearch(feed) {
+  const queryDescription = describeEmailSearchQuery(feed.query);
+  if (feed.messages.length === 0) {
+    return `No email matched ${queryDescription}.`;
+  }
+  const lines = [
+    `Found ${feed.summary.totalCount} email${feed.summary.totalCount === 1 ? "" : "s"} for ${queryDescription}.`
+  ];
+  for (const message of feed.messages.slice(0, 8)) {
+    const badges = [];
+    if (message.isImportant) {
+      badges.push("important");
+    }
+    if (message.likelyReplyNeeded) {
+      badges.push("reply needed");
+    }
+    const badgeText = badges.length > 0 ? ` [${badges.join(", ")}]` : "";
+    const sender = formatEmailSender(message.from, message.fromEmail);
+    lines.push(
+      `- **${message.subject}**${badgeText} from ${sender} \xB7 ${formatRelativeTime(message.receivedAt)}`
+    );
+    if (message.snippet) {
+      lines.push(`  ${truncateForPreview(message.snippet, 120)}`);
+    }
+  }
+  return lines.join("\n");
+}
+function formatEmailRead(result) {
+  const from = formatEmailSender(result.message.from, result.message.fromEmail);
+  const bodyText = result.bodyText.trim();
+  const maxChars = 2500;
+  const truncated = bodyText.length > maxChars;
+  const preview = truncated ? `${bodyText.slice(0, maxChars).trimEnd()}
+
+[truncated]` : bodyText;
+  const lines = [
+    `**${result.message.subject}** from ${from} \xB7 ${formatRelativeTime(result.message.receivedAt)}`
+  ];
+  if (result.query) {
+    lines.push(`Resolved from ${describeEmailSearchQuery(result.query)}.`);
+  }
+  if (preview.length > 0) {
+    lines.push(preview);
+  } else if (result.message.snippet) {
+    lines.push(
+      `No readable body was available. Snippet: ${result.message.snippet}`
+    );
+  } else {
+    lines.push("No readable body was available for that email.");
+  }
+  return lines.join("\n\n");
+}
+function formatGmailReplyDraft(draft) {
+  const lines = [`Drafted reply for **${draft.subject}**.`];
+  if (draft.to.length > 0) {
+    lines.push(`To: ${draft.to.join(", ")}`);
+  }
+  if (draft.cc.length > 0) {
+    lines.push(`Cc: ${draft.cc.join(", ")}`);
+  }
+  lines.push("Preview:");
+  for (const line of draft.previewLines.slice(0, 5)) {
+    lines.push(`- ${line}`);
+  }
+  lines.push(
+    draft.sendAllowed ? "Send is allowed, but still requires explicit confirmation." : "Send is not allowed with the current Google grant."
+  );
+  return lines.join("\n");
+}
+function formatGmailBatchReplyDrafts(batch) {
+  if (batch.drafts.length === 0) {
+    return "No Gmail reply drafts were created.";
+  }
+  const lines = [
+    `Drafted ${batch.summary.totalCount} Gmail repl${batch.summary.totalCount === 1 ? "y" : "ies"}.`
+  ];
+  for (const draft of batch.drafts.slice(0, 5)) {
+    lines.push(
+      `- **${draft.subject}** \u2192 ${draft.to.join(", ") || "reply recipients"}`
+    );
+  }
+  if (batch.summary.requiresConfirmationCount > 0) {
+    lines.push(
+      `${batch.summary.requiresConfirmationCount} draft${batch.summary.requiresConfirmationCount === 1 ? "" : "s"} still require send confirmation.`
+    );
+  }
+  return lines.join("\n");
+}
+function formatOverview(overview) {
+  const summary = overview.owner.summary;
+  const lines = [
+    "Life Ops overview:",
+    `- ${summary.activeOccurrenceCount} active items (${summary.overdueOccurrenceCount} overdue, ${summary.snoozedOccurrenceCount} snoozed)`,
+    `- ${summary.activeGoalCount} active goals`,
+    `- ${summary.activeReminderCount} pending reminders`
+  ];
+  if (overview.schedule) {
+    const schedule = overview.schedule;
+    const isAsleepState = schedule.circadianState === "sleeping" || schedule.circadianState === "napping";
+    const sleepLine = isAsleepState ? schedule.currentSleepStartedAt ? `Likely asleep since ${schedule.currentSleepStartedAt}` : "Likely asleep now" : schedule.lastSleepEndedAt ? `Last wake ${schedule.lastSleepEndedAt}${schedule.lastSleepDurationMinutes ? ` after ${schedule.lastSleepDurationMinutes} minutes asleep` : ""}` : `Sleep status ${schedule.sleepStatus}`;
+    lines.push(`- Circadian state: ${schedule.circadianState}`);
+    if (schedule.relativeTime.minutesSinceWake !== null) {
+      const bedtimeClause = schedule.relativeTime.minutesUntilBedtimeTarget !== null ? `; bedtime in ${schedule.relativeTime.minutesUntilBedtimeTarget} minutes` : schedule.relativeTime.minutesSinceBedtimeTarget !== null ? `; bedtime was ${schedule.relativeTime.minutesSinceBedtimeTarget} minutes ago` : "";
+      lines.push(
+        `- Relative time: woke ${schedule.relativeTime.minutesSinceWake} minutes ago${bedtimeClause}`
+      );
+    } else if (schedule.relativeTime.minutesUntilBedtimeTarget !== null) {
+      lines.push(
+        `- Relative time: bedtime in ${schedule.relativeTime.minutesUntilBedtimeTarget} minutes`
+      );
+    } else if (schedule.relativeTime.minutesSinceBedtimeTarget !== null) {
+      lines.push(
+        `- Relative time: bedtime was ${schedule.relativeTime.minutesSinceBedtimeTarget} minutes ago`
+      );
+    }
+    lines.push(`- ${sleepLine}`);
+    if (schedule.nextMealLabel && schedule.nextMealWindowStartAt) {
+      lines.push(
+        `- Next ${schedule.nextMealLabel} window starts ${schedule.nextMealWindowStartAt} (${Math.round(schedule.nextMealConfidence * 100)}% confidence)`
+      );
+    } else if (schedule.lastMealAt) {
+      lines.push(`- Last inferred meal ${schedule.lastMealAt}`);
+    }
+  }
+  if (overview.owner.occurrences.length > 0) {
+    lines.push("\nCurrent items:");
+    for (const occurrence of overview.owner.occurrences.slice(0, 5)) {
+      const state = occurrence.state !== "visible" ? ` (${occurrence.state})` : "";
+      lines.push(`- ${occurrence.title}${state}`);
+    }
+  }
+  if (overview.owner.goals.length > 0) {
+    lines.push("\nActive goals:");
+    for (const goal of overview.owner.goals.slice(0, 3)) {
+      lines.push(`- ${goal.title} (${goal.status})`);
+    }
+  }
+  return lines.join("\n");
+}
+const REMAINING_TODAY_QUERY_RE = /\b(?:what'?s still left(?: for today)?|what do i still need to do today|anything else .*?(?:get done|finish).*?today|what life ops tasks are still left for today|what remains today|what(?:'s| is) left today)\b/i;
+function looksLikeRemainingTodayOverviewQuery(query) {
+  return REMAINING_TODAY_QUERY_RE.test(query);
+}
+function overviewAnchorIso(occurrence) {
+  return occurrence.snoozedUntil ?? occurrence.dueAt ?? occurrence.scheduledAt ?? occurrence.relevanceStartAt;
+}
+function isRelevantToToday(occurrence, now) {
+  const timeZone = typeof occurrence.timezone === "string" && occurrence.timezone.trim() ? occurrence.timezone.trim() : "UTC";
+  const anchor = new Date(overviewAnchorIso(occurrence));
+  if (!Number.isFinite(anchor.getTime())) {
+    return true;
+  }
+  const todayKey = getLocalDateKey(getZonedDateParts(now, timeZone));
+  const anchorKey = getLocalDateKey(getZonedDateParts(anchor, timeZone));
+  return anchorKey <= todayKey;
+}
+function normalizeRemainingTodayWindowLabel(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed.toLowerCase() : null;
+}
+function buildRemainingTodayGroups(occurrences, now) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const occurrence of occurrences) {
+    if (!isRelevantToToday(occurrence, now)) {
+      continue;
+    }
+    const key = `${occurrence.definitionId}:${occurrence.title}`;
+    const anchorMs = Date.parse(overviewAnchorIso(occurrence));
+    const windowLabel = normalizeRemainingTodayWindowLabel(
+      occurrence.windowName
+    );
+    const existing = groups.get(key);
+    if (existing) {
+      existing.count += 1;
+      if (Number.isFinite(anchorMs) && anchorMs < existing.earliestAnchorMs) {
+        existing.earliestAnchorMs = anchorMs;
+      }
+      if (windowLabel && !existing.windows.includes(windowLabel)) {
+        existing.windows.push(windowLabel);
+      }
+      continue;
+    }
+    groups.set(key, {
+      definitionId: occurrence.definitionId,
+      title: occurrence.title,
+      count: 1,
+      earliestAnchorMs: Number.isFinite(anchorMs) ? anchorMs : Number.MAX_SAFE_INTEGER,
+      windows: windowLabel ? [windowLabel] : []
+    });
+  }
+  return [...groups.values()].sort(
+    (left, right) => left.earliestAnchorMs - right.earliestAnchorMs
+  );
+}
+function formatRemainingTodayLabel(group) {
+  if (group.windows.length === 1) {
+    return `${group.title} ${group.windows[0]}`;
+  }
+  if (group.windows.length > 1) {
+    return `${group.title} (${formatHumanList(group.windows)})`;
+  }
+  if (group.count > 1) {
+    return `${group.title} (${group.count} times)`;
+  }
+  return group.title;
+}
+function formatHumanList(items) {
+  if (items.length === 0) return "";
+  if (items.length === 1) return items[0] || "";
+  return new Intl.ListFormat("en", {
+    style: "long",
+    type: "conjunction"
+  }).format(items);
+}
+function formatOverviewForQuery(overview, query, now = /* @__PURE__ */ new Date()) {
+  if (!looksLikeRemainingTodayOverviewQuery(query)) {
+    return formatOverview(overview);
+  }
+  const remainingTodayGroups = buildRemainingTodayGroups(
+    overview.owner.occurrences,
+    now
+  );
+  if (remainingTodayGroups.length === 0) {
+    return "You don't have any LifeOps tasks left for today.";
+  }
+  const labels = remainingTodayGroups.slice(0, 5).map((group) => formatRemainingTodayLabel(group));
+  const noun = remainingTodayGroups.length === 1 ? "task" : "tasks";
+  if (remainingTodayGroups.length <= labels.length) {
+    return `You have ${remainingTodayGroups.length} LifeOps ${noun} left for today: ${formatHumanList(labels)}.`;
+  }
+  return `You have ${remainingTodayGroups.length} LifeOps ${noun} left for today. Next up: ${formatHumanList(labels)}, plus ${remainingTodayGroups.length - labels.length} more.`;
+}
+export {
+  dayRange,
+  detailArray,
+  detailBoolean,
+  detailNumber,
+  detailObject,
+  detailString,
+  formatCalendarEventDateTime,
+  formatEmailNeedsResponse,
+  formatEmailRead,
+  formatEmailSearch,
+  formatEmailTriage,
+  formatGmailBatchReplyDrafts,
+  formatGmailRecommendations,
+  formatGmailReplyDraft,
+  formatOverview,
+  formatOverviewForQuery,
+  formatRelativeMinutes,
+  formatRelativeTime,
+  futureRange,
+  messageSource,
+  messageText,
+  parseLifeOpsJsonRecord,
+  runLifeOpsJsonModel,
+  runLifeOpsTextModel,
+  toActionData,
+  weekRange
+};
+//# sourceMappingURL=format-helpers.js.map