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

package/dist/lifeops/first-run/questions.js

@@ -0,0 +1,184 @@
+const FIRST_RUN_QUESTIONS = [
+  {
+    id: "preferredName",
+    prompt: "What should I call you?",
+    shouldAsk: () => true
+  },
+  {
+    id: "timezoneAndWindows",
+    prompt: "What time zone are you in, and what counts as your morning / evening? (Defaults: morning 06:00\u201311:00, evening 18:00\u201322:00.)",
+    shouldAsk: () => true
+  },
+  {
+    id: "categories",
+    prompt: "Which categories sound useful to enable now? (multi-select: sleep tracking, reminder packs, inbox triage, blockers/focus, follow-ups)",
+    shouldAsk: () => true
+  },
+  {
+    id: "channel",
+    prompt: "Where do you want me to nudge you? (in_app, push, imessage, discord, telegram)",
+    shouldAsk: () => true
+  },
+  {
+    id: "relationships",
+    prompt: "List 3\u20135 important relationships and a default cadence (e.g. 'Pat \u2014 14 days; Sam \u2014 weekly').",
+    shouldAsk: (answers) => {
+      const categories = answers.categories;
+      if (!Array.isArray(categories)) return false;
+      return categories.some(
+        (c) => typeof c === "string" && c.toLowerCase() === "follow-ups"
+      );
+    }
+  }
+];
+const CUSTOMIZE_CATEGORIES = [
+  "sleep tracking",
+  "reminder packs",
+  "inbox triage",
+  "blockers/focus",
+  "follow-ups"
+];
+const DEFAULT_MORNING_WINDOW = {
+  startLocal: "06:00",
+  endLocal: "11:00"
+};
+const DEFAULT_EVENING_WINDOW = {
+  startLocal: "18:00",
+  endLocal: "22:00"
+};
+const SUPPORTED_NOTIFICATION_CHANNELS = [
+  "in_app",
+  "push",
+  "imessage",
+  "discord",
+  "telegram"
+];
+function nextUnansweredQuestion(answers) {
+  for (const q of FIRST_RUN_QUESTIONS) {
+    if (!q.shouldAsk(answers)) continue;
+    if (answers[q.id] === void 0) return q;
+  }
+  return null;
+}
+const TIME_OF_DAY_PATTERN = /^([01]\d|2[0-3]):[0-5]\d$/;
+function parsePreferredName(value) {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  if (trimmed.length === 0 || trimmed.length > 60) return null;
+  return trimmed;
+}
+function parseTimeWindow(value) {
+  if (!value || typeof value !== "object") return null;
+  const v = value;
+  if (typeof v.startLocal !== "string" || typeof v.endLocal !== "string" || !TIME_OF_DAY_PATTERN.test(v.startLocal) || !TIME_OF_DAY_PATTERN.test(v.endLocal) || v.startLocal >= v.endLocal) {
+    return null;
+  }
+  return { startLocal: v.startLocal, endLocal: v.endLocal };
+}
+function parseTimezone(value) {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  if (trimmed.length === 0 || trimmed.length > 64) return null;
+  return trimmed;
+}
+function parseCategories(value) {
+  if (!Array.isArray(value)) return null;
+  const allowed = new Set(CUSTOMIZE_CATEGORIES);
+  const out = [];
+  for (const entry of value) {
+    if (typeof entry !== "string") continue;
+    const normalized = entry.trim().toLowerCase();
+    if (allowed.has(normalized)) {
+      out.push(normalized);
+    }
+  }
+  return out;
+}
+function parseRelationships(value) {
+  if (!Array.isArray(value)) return null;
+  const out = [];
+  for (const entry of value) {
+    if (!entry || typeof entry !== "object") continue;
+    const obj = entry;
+    const name = typeof obj.name === "string" ? obj.name.trim() : "";
+    const cadenceDays = typeof obj.cadenceDays === "number" && obj.cadenceDays > 0 ? Math.floor(obj.cadenceDays) : null;
+    if (!name || cadenceDays === null) continue;
+    out.push({ name, cadenceDays });
+    if (out.length >= 5) break;
+  }
+  return out;
+}
+class FallbackChannelInspector {
+  isRegistered(channel) {
+    return SUPPORTED_NOTIFICATION_CHANNELS.includes(
+      channel
+    );
+  }
+  /**
+   * Default: treat `in_app` as always connected and other channels as
+   * "registered but unconnected" so the validator returns the right fallback
+   * warning shape. The real `ChannelRegistry` reads connector status from
+   * `ConnectorRegistry`.
+   */
+  isConnected(channel) {
+    return channel === "in_app";
+  }
+}
+let activeInspector = new FallbackChannelInspector();
+function setChannelInspector(inspector) {
+  activeInspector = inspector ?? new FallbackChannelInspector();
+}
+function validateChannel(rawChannel, _runtime) {
+  const normalized = typeof rawChannel === "string" ? rawChannel.trim().toLowerCase() : "";
+  if (!normalized) {
+    return {
+      channel: "in_app",
+      registered: true,
+      connected: true,
+      fallbackToInApp: true,
+      warning: "No channel was selected \u2014 defaulting to in-app notifications."
+    };
+  }
+  const registered = activeInspector.isRegistered(normalized);
+  if (!registered) {
+    return {
+      channel: "in_app",
+      registered: false,
+      connected: true,
+      fallbackToInApp: true,
+      warning: `Channel "${normalized}" is not registered \u2014 falling back to in-app notifications.`
+    };
+  }
+  const connected = activeInspector.isConnected(normalized);
+  if (!connected) {
+    return {
+      channel: normalized,
+      registered: true,
+      connected: false,
+      fallbackToInApp: true,
+      warning: `Channel "${normalized}" is registered but currently disconnected \u2014 your reminders will fall back to in-app until you connect it.`
+    };
+  }
+  return {
+    channel: normalized,
+    registered: true,
+    connected: true,
+    fallbackToInApp: false
+  };
+}
+export {
+  CUSTOMIZE_CATEGORIES,
+  DEFAULT_EVENING_WINDOW,
+  DEFAULT_MORNING_WINDOW,
+  FIRST_RUN_QUESTIONS,
+  SUPPORTED_NOTIFICATION_CHANNELS,
+  nextUnansweredQuestion,
+  parseCategories,
+  parsePreferredName,
+  parseRelationships,
+  parseTimeWindow,
+  parseTimezone,
+  setChannelInspector,
+  validateChannel
+};
+//# sourceMappingURL=questions.js.map

package/dist/lifeops/first-run/questions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/first-run/questions.ts"],"sourcesContent":["/**\n * Customize-path question set for first-run.\n *\n * Five questions: Q1/Q2/Q4 always asked; Q3/Q5 conditional. Partial answers\n * are persisted Q-by-Q via `FirstRunStateStore.recordAnswer` so a user can\n * abandon mid-flow and resume without losing progress.\n *\n * Channel-validation for Q4: the chosen channel must be registered AND have\n * a connected dispatcher. If neither is the case the answer is recorded with\n * `fallbackToInApp: true` and a warning surfaces back through the action\n * result. The `ChannelRegistry` is the eventual checker; the local inspector\n * below leans on `getDefaultTriageService` adapter registration as a\n * connectivity proxy.\n */\n\nimport type { IAgentRuntime } from \"@elizaos/core\";\nimport type { OwnerFactWindow } from \"./state.js\";\n\nexport type FirstRunQuestionId =\n  | \"preferredName\"\n  | \"timezoneAndWindows\"\n  | \"categories\"\n  | \"channel\"\n  | \"relationships\";\n\nexport interface FirstRunQuestionDefinition {\n  id: FirstRunQuestionId;\n  prompt: string;\n  /** Whether the question should be asked given the current answers. */\n  shouldAsk(answers: Record<string, unknown>): boolean;\n}\n\n/**\n * Canonical question text. The action's prompt-rendering layer (planner) is\n * responsible for actually asking the user; these strings are the contract\n * the planner reads from.\n */\nexport const FIRST_RUN_QUESTIONS: readonly FirstRunQuestionDefinition[] = [\n  {\n    id: \"preferredName\",\n    prompt: \"What should I call you?\",\n    shouldAsk: () => true,\n  },\n  {\n    id: \"timezoneAndWindows\",\n    prompt:\n      \"What time zone are you in, and what counts as your morning / evening? (Defaults: morning 06:00–11:00, evening 18:00–22:00.)\",\n    shouldAsk: () => true,\n  },\n  {\n    id: \"categories\",\n    prompt:\n      \"Which categories sound useful to enable now? (multi-select: sleep tracking, reminder packs, inbox triage, blockers/focus, follow-ups)\",\n    shouldAsk: () => true,\n  },\n  {\n    id: \"channel\",\n    prompt:\n      \"Where do you want me to nudge you? (in_app, push, imessage, discord, telegram)\",\n    shouldAsk: () => true,\n  },\n  {\n    id: \"relationships\",\n    prompt:\n      \"List 3–5 important relationships and a default cadence (e.g. 'Pat — 14 days; Sam — weekly').\",\n    shouldAsk: (answers) => {\n      const categories = answers.categories;\n      if (!Array.isArray(categories)) return false;\n      return categories.some(\n        (c) => typeof c === \"string\" && c.toLowerCase() === \"follow-ups\",\n      );\n    },\n  },\n] as const;\n\nexport type CustomizeCategory =\n  | \"sleep tracking\"\n  | \"reminder packs\"\n  | \"inbox triage\"\n  | \"blockers/focus\"\n  | \"follow-ups\";\n\nexport const CUSTOMIZE_CATEGORIES: readonly CustomizeCategory[] = [\n  \"sleep tracking\",\n  \"reminder packs\",\n  \"inbox triage\",\n  \"blockers/focus\",\n  \"follow-ups\",\n];\n\nexport interface RelationshipAnswerEntry {\n  name: string;\n  cadenceDays: number;\n}\n\nexport interface CustomizeAnswers {\n  preferredName: string;\n  timezone: string;\n  morningWindow: OwnerFactWindow;\n  eveningWindow: OwnerFactWindow;\n  categories: CustomizeCategory[];\n  channel: string;\n  channelFallbackToInApp: boolean;\n  channelWarning?: string;\n  relationships?: RelationshipAnswerEntry[];\n}\n\nexport const DEFAULT_MORNING_WINDOW: OwnerFactWindow = {\n  startLocal: \"06:00\",\n  endLocal: \"11:00\",\n};\n\nexport const DEFAULT_EVENING_WINDOW: OwnerFactWindow = {\n  startLocal: \"18:00\",\n  endLocal: \"22:00\",\n};\n\nexport const SUPPORTED_NOTIFICATION_CHANNELS = [\n  \"in_app\",\n  \"push\",\n  \"imessage\",\n  \"discord\",\n  \"telegram\",\n] as const;\n\nexport type SupportedNotificationChannel =\n  (typeof SUPPORTED_NOTIFICATION_CHANNELS)[number];\n\nexport function nextUnansweredQuestion(\n  answers: Record<string, unknown>,\n): FirstRunQuestionDefinition | null {\n  for (const q of FIRST_RUN_QUESTIONS) {\n    if (!q.shouldAsk(answers)) continue;\n    if (answers[q.id] === undefined) return q;\n  }\n  return null;\n}\n\n// --- Validators / parsers --------------------------------------------------\n\nconst TIME_OF_DAY_PATTERN = /^([01]\\d|2[0-3]):[0-5]\\d$/;\n\nexport function parsePreferredName(value: unknown): string | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim();\n  if (trimmed.length === 0 || trimmed.length > 60) return null;\n  return trimmed;\n}\n\nexport function parseTimeWindow(value: unknown): OwnerFactWindow | null {\n  if (!value || typeof value !== \"object\") return null;\n  const v = value as Record<string, unknown>;\n  if (\n    typeof v.startLocal !== \"string\" ||\n    typeof v.endLocal !== \"string\" ||\n    !TIME_OF_DAY_PATTERN.test(v.startLocal) ||\n    !TIME_OF_DAY_PATTERN.test(v.endLocal) ||\n    v.startLocal >= v.endLocal\n  ) {\n    return null;\n  }\n  return { startLocal: v.startLocal, endLocal: v.endLocal };\n}\n\nexport function parseTimezone(value: unknown): string | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim();\n  if (trimmed.length === 0 || trimmed.length > 64) return null;\n  // RFC-grade timezone validation lives at the OwnerFactStore layer; for\n  // first-run we accept any non-empty string and trust the IANA name.\n  // Catastrophically wrong names surface later via downstream resolution.\n  return trimmed;\n}\n\nexport function parseCategories(value: unknown): CustomizeCategory[] | null {\n  if (!Array.isArray(value)) return null;\n  const allowed = new Set<string>(CUSTOMIZE_CATEGORIES);\n  const out: CustomizeCategory[] = [];\n  for (const entry of value) {\n    if (typeof entry !== \"string\") continue;\n    const normalized = entry.trim().toLowerCase();\n    if (allowed.has(normalized)) {\n      out.push(normalized as CustomizeCategory);\n    }\n  }\n  return out;\n}\n\nexport function parseRelationships(\n  value: unknown,\n): RelationshipAnswerEntry[] | null {\n  if (!Array.isArray(value)) return null;\n  const out: RelationshipAnswerEntry[] = [];\n  for (const entry of value) {\n    if (!entry || typeof entry !== \"object\") continue;\n    const obj = entry as Record<string, unknown>;\n    const name = typeof obj.name === \"string\" ? obj.name.trim() : \"\";\n    const cadenceDays =\n      typeof obj.cadenceDays === \"number\" && obj.cadenceDays > 0\n        ? Math.floor(obj.cadenceDays)\n        : null;\n    if (!name || cadenceDays === null) continue;\n    out.push({ name, cadenceDays });\n    if (out.length >= 5) break;\n  }\n  return out;\n}\n\n// --- Channel validation (Q4) ---------------------------------------------\n\nexport interface ChannelValidationResult {\n  channel: string;\n  registered: boolean;\n  connected: boolean;\n  fallbackToInApp: boolean;\n  warning?: string;\n}\n\n/**\n * Inspector contract — pluggable so the `ChannelRegistry` can replace the\n * default implementation without touching this module.\n */\nexport interface ChannelInspector {\n  isRegistered(channel: string): boolean;\n  isConnected(channel: string): boolean;\n}\n\nclass FallbackChannelInspector implements ChannelInspector {\n  isRegistered(channel: string): boolean {\n    return SUPPORTED_NOTIFICATION_CHANNELS.includes(\n      channel as SupportedNotificationChannel,\n    );\n  }\n  /**\n   * Default: treat `in_app` as always connected and other channels as\n   * \"registered but unconnected\" so the validator returns the right fallback\n   * warning shape. The real `ChannelRegistry` reads connector status from\n   * `ConnectorRegistry`.\n   */\n  isConnected(channel: string): boolean {\n    return channel === \"in_app\";\n  }\n}\n\nlet activeInspector: ChannelInspector = new FallbackChannelInspector();\n\nexport function setChannelInspector(inspector: ChannelInspector | null): void {\n  activeInspector = inspector ?? new FallbackChannelInspector();\n}\n\nexport function validateChannel(\n  rawChannel: unknown,\n  _runtime: IAgentRuntime,\n): ChannelValidationResult {\n  const normalized =\n    typeof rawChannel === \"string\" ? rawChannel.trim().toLowerCase() : \"\";\n  if (!normalized) {\n    return {\n      channel: \"in_app\",\n      registered: true,\n      connected: true,\n      fallbackToInApp: true,\n      warning: \"No channel was selected — defaulting to in-app notifications.\",\n    };\n  }\n  const registered = activeInspector.isRegistered(normalized);\n  if (!registered) {\n    return {\n      channel: \"in_app\",\n      registered: false,\n      connected: true,\n      fallbackToInApp: true,\n      warning: `Channel \"${normalized}\" is not registered — falling back to in-app notifications.`,\n    };\n  }\n  const connected = activeInspector.isConnected(normalized);\n  if (!connected) {\n    return {\n      channel: normalized,\n      registered: true,\n      connected: false,\n      fallbackToInApp: true,\n      warning: `Channel \"${normalized}\" is registered but currently disconnected — your reminders will fall back to in-app until you connect it.`,\n    };\n  }\n  return {\n    channel: normalized,\n    registered: true,\n    connected: true,\n    fallbackToInApp: false,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/lifeops/first-run/replay.d.ts

@@ -0,0 +1,41 @@
+/**
+ * First-run replay semantics.
+ *
+ * Replay = re-run the first-run flow without destroying anything:
+ *   - Existing `ScheduledTask` records are NOT touched. The runner sees the
+ *     same `idempotencyKey` and upserts in place.
+ *   - `OwnerFactStore` facts that the questions touch ARE updated. New
+ *     answers append; previously-answered fields show their current value as
+ *     the "default" for the user to confirm or change.
+ *   - `partialAnswers` for the in-progress lifecycle is reset on entry —
+ *     replay always starts a fresh answer slate (the user can still skip
+ *     unchanged questions).
+ *
+ * This module exposes the read-only helpers replay uses to surface current
+ * facts as defaults.
+ */
+import type { CustomizeAnswers, RelationshipAnswerEntry } from "./questions.js";
+import type { OwnerFactStore, OwnerFacts } from "./state.js";
+export interface ReplayContext {
+    currentFacts: OwnerFacts;
+}
+/**
+ * Build the planner-visible "defaults to confirm" payload for the customize
+ * path. The action serializes this into the prompt so the user sees their
+ * current values as pre-filled options.
+ */
+export declare function buildReplayContext(store: OwnerFactStore): Promise<ReplayContext>;
+/**
+ * Project the current facts into a partial `CustomizeAnswers` so the planner
+ * can pre-fill the questionnaire. Missing values stay missing — the user has
+ * to provide them this round.
+ */
+export declare function partialAnswersFromFacts(facts: OwnerFacts): Partial<CustomizeAnswers>;
+/**
+ * Replay never wipes existing relationship answers but it also has no way of
+ * reading back into the question slate which relationships the user
+ * previously named. Replay treats the relationships question as a fresh
+ * round (the user lists them again or skips).
+ */
+export declare function relationshipsFallbackForReplay(): RelationshipAnswerEntry[];
+//# sourceMappingURL=replay.d.ts.map

package/dist/lifeops/first-run/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../../src/lifeops/first-run/replay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,UAAU,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,aAAa,CAAC,CAGxB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAoB3B;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,IAAI,uBAAuB,EAAE,CAE1E"}

package/dist/lifeops/first-run/replay.js

@@ -0,0 +1,34 @@
+async function buildReplayContext(store) {
+  const currentFacts = await store.read();
+  return { currentFacts };
+}
+function partialAnswersFromFacts(facts) {
+  const partial = {};
+  if (facts.preferredName) partial.preferredName = facts.preferredName.value;
+  if (facts.timezone) partial.timezone = facts.timezone.value;
+  if (facts.morningWindow) {
+    partial.morningWindow = {
+      startLocal: facts.morningWindow.value.startLocal,
+      endLocal: facts.morningWindow.value.endLocal
+    };
+  }
+  if (facts.eveningWindow) {
+    partial.eveningWindow = {
+      startLocal: facts.eveningWindow.value.startLocal,
+      endLocal: facts.eveningWindow.value.endLocal
+    };
+  }
+  if (facts.preferredNotificationChannel) {
+    partial.channel = facts.preferredNotificationChannel.value;
+  }
+  return partial;
+}
+function relationshipsFallbackForReplay() {
+  return [];
+}
+export {
+  buildReplayContext,
+  partialAnswersFromFacts,
+  relationshipsFallbackForReplay
+};
+//# sourceMappingURL=replay.js.map

package/dist/lifeops/first-run/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/first-run/replay.ts"],"sourcesContent":["/**\n * First-run replay semantics.\n *\n * Replay = re-run the first-run flow without destroying anything:\n *   - Existing `ScheduledTask` records are NOT touched. The runner sees the\n *     same `idempotencyKey` and upserts in place.\n *   - `OwnerFactStore` facts that the questions touch ARE updated. New\n *     answers append; previously-answered fields show their current value as\n *     the \"default\" for the user to confirm or change.\n *   - `partialAnswers` for the in-progress lifecycle is reset on entry —\n *     replay always starts a fresh answer slate (the user can still skip\n *     unchanged questions).\n *\n * This module exposes the read-only helpers replay uses to surface current\n * facts as defaults.\n */\n\nimport type { CustomizeAnswers, RelationshipAnswerEntry } from \"./questions.js\";\nimport type { OwnerFactStore, OwnerFacts } from \"./state.js\";\n\nexport interface ReplayContext {\n  currentFacts: OwnerFacts;\n}\n\n/**\n * Build the planner-visible \"defaults to confirm\" payload for the customize\n * path. The action serializes this into the prompt so the user sees their\n * current values as pre-filled options.\n */\nexport async function buildReplayContext(\n  store: OwnerFactStore,\n): Promise<ReplayContext> {\n  const currentFacts = await store.read();\n  return { currentFacts };\n}\n\n/**\n * Project the current facts into a partial `CustomizeAnswers` so the planner\n * can pre-fill the questionnaire. Missing values stay missing — the user has\n * to provide them this round.\n */\nexport function partialAnswersFromFacts(\n  facts: OwnerFacts,\n): Partial<CustomizeAnswers> {\n  const partial: Partial<CustomizeAnswers> = {};\n  if (facts.preferredName) partial.preferredName = facts.preferredName.value;\n  if (facts.timezone) partial.timezone = facts.timezone.value;\n  if (facts.morningWindow) {\n    partial.morningWindow = {\n      startLocal: facts.morningWindow.value.startLocal,\n      endLocal: facts.morningWindow.value.endLocal,\n    };\n  }\n  if (facts.eveningWindow) {\n    partial.eveningWindow = {\n      startLocal: facts.eveningWindow.value.startLocal,\n      endLocal: facts.eveningWindow.value.endLocal,\n    };\n  }\n  if (facts.preferredNotificationChannel) {\n    partial.channel = facts.preferredNotificationChannel.value;\n  }\n  return partial;\n}\n\n/**\n * Replay never wipes existing relationship answers but it also has no way of\n * reading back into the question slate which relationships the user\n * previously named. Replay treats the relationships question as a fresh\n * round (the user lists them again or skips).\n */\nexport function relationshipsFallbackForReplay(): RelationshipAnswerEntry[] {\n  return [];\n}\n"],"mappings":"AA6BA,eAAsB,mBACpB,OACwB;AACxB,QAAM,eAAe,MAAM,MAAM,KAAK;AACtC,SAAO,EAAE,aAAa;AACxB;AAOO,SAAS,wBACd,OAC2B;AAC3B,QAAM,UAAqC,CAAC;AAC5C,MAAI,MAAM,cAAe,SAAQ,gBAAgB,MAAM,cAAc;AACrE,MAAI,MAAM,SAAU,SAAQ,WAAW,MAAM,SAAS;AACtD,MAAI,MAAM,eAAe;AACvB,YAAQ,gBAAgB;AAAA,MACtB,YAAY,MAAM,cAAc,MAAM;AAAA,MACtC,UAAU,MAAM,cAAc,MAAM;AAAA,IACtC;AAAA,EACF;AACA,MAAI,MAAM,eAAe;AACvB,YAAQ,gBAAgB;AAAA,MACtB,YAAY,MAAM,cAAc,MAAM;AAAA,MACtC,UAAU,MAAM,cAAc,MAAM;AAAA,IACtC;AAAA,EACF;AACA,MAAI,MAAM,8BAA8B;AACtC,YAAQ,UAAU,MAAM,6BAA6B;AAAA,EACvD;AACA,SAAO;AACT;AAQO,SAAS,iCAA4D;AAC1E,SAAO,CAAC;AACV;","names":[]}

package/dist/lifeops/first-run/service.d.ts

@@ -0,0 +1,147 @@
+/**
+ * `FirstRunService` — orchestrator for the first-run capability.
+ *
+ * Owns:
+ *   - the lifecycle state machine (`pending` → `in_progress` → `complete`)
+ *     via `FirstRunStateStore`
+ *   - writes to the canonical `OwnerFactStore`
+ *   - emission of the defaults pack into the `ScheduledTaskRunner`
+ *   - the replay path (re-run without destroying tasks)
+ *
+ * The runner is injected: if the production runner is registered on the
+ * runtime by the time the action fires, this service uses it; otherwise it
+ * falls back to an in-memory recorder that is sufficient for unit /
+ * integration tests.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { ScheduledTask, ScheduledTaskInput } from "../wave1-types.js";
+import { type FirstRunRecord, type FirstRunStateStore, type OwnerFactStore } from "./state.js";
+export interface ScheduledTaskRunnerLike {
+    schedule(task: ScheduledTaskInput): Promise<ScheduledTask>;
+}
+export declare function setScheduledTaskRunner(runner: ScheduledTaskRunnerLike | null): void;
+export declare function getScheduledTaskRunner(): ScheduledTaskRunnerLike | null;
+interface CachedTaskRecord {
+    taskId: string;
+    input: ScheduledTaskInput;
+    scheduledAt: string;
+}
+export declare function readFallbackScheduledTasks(runtime: IAgentRuntime): Promise<CachedTaskRecord[]>;
+export declare function clearFallbackScheduledTasks(runtime: IAgentRuntime): Promise<void>;
+/**
+ * Flat projection of the typed `OwnerFacts` store, used by callers that
+ * want quick scalar access to fact values (first-run tests, replay
+ * pre-fill). Provenance is intentionally elided — readers that need it go
+ * through the typed `OwnerFactStore` directly.
+ */
+export interface FirstRunFlatFacts {
+    preferredName?: string;
+    timezone?: string;
+    morningWindow?: {
+        startLocal: string;
+        endLocal: string;
+    };
+    eveningWindow?: {
+        startLocal: string;
+        endLocal: string;
+    };
+    preferredNotificationChannel?: string;
+    locale?: string;
+}
+export interface FirstRunRunResult {
+    status: "ok" | "needs_more_input" | "already_complete";
+    record: FirstRunRecord;
+    facts: FirstRunFlatFacts;
+    scheduledTasks: ScheduledTask[];
+    /** Question id awaiting an answer (only set when status = needs_more_input). */
+    awaitingQuestion?: string;
+    /** Human-readable message the action surfaces back. */
+    message: string;
+    /** Warnings collected during the flow (e.g. channel-validation fallback). */
+    warnings: string[];
+}
+export interface DefaultsPathInput {
+    /** Free-text wake time, e.g. "6am", "07:30". Required on first invocation. */
+    wakeTime?: string;
+    /** IANA timezone; defaults to runtime / system value if absent. */
+    timezone?: string;
+    /** Optional notification channel; defaults to in_app. */
+    channel?: string;
+}
+export interface CustomizePathInput {
+    preferredName?: string;
+    timezone?: string;
+    morningWindow?: {
+        startLocal: string;
+        endLocal: string;
+    };
+    eveningWindow?: {
+        startLocal: string;
+        endLocal: string;
+    };
+    categories?: string[];
+    channel?: string;
+    relationships?: Array<{
+        name: string;
+        cadenceDays: number;
+    }>;
+}
+export interface ReplayPathInput {
+    /** Allows the same answer keys as customize, but only applied when present. */
+    preferredName?: string;
+    timezone?: string;
+    morningWindow?: {
+        startLocal: string;
+        endLocal: string;
+    };
+    eveningWindow?: {
+        startLocal: string;
+        endLocal: string;
+    };
+    categories?: string[];
+    channel?: string;
+    relationships?: Array<{
+        name: string;
+        cadenceDays: number;
+    }>;
+}
+export declare class FirstRunService {
+    private readonly runtime;
+    private readonly stateStore;
+    private readonly factStore;
+    constructor(runtime: IAgentRuntime, options?: {
+        stateStore?: FirstRunStateStore;
+        factStore?: OwnerFactStore;
+        runner?: ScheduledTaskRunnerLike;
+    });
+    private runnerOverride;
+    private resolveRunner;
+    readState(): Promise<FirstRunRecord>;
+    readFacts(): Promise<FirstRunFlatFacts>;
+    /**
+     * Path A: defaults. Asks ONE question (wake time) before scheduling. The
+     * action invokes `runDefaultsPath` once with no `wakeTime`, gets back a
+     * `needs_more_input` result and the question text, then re-invokes with
+     * the parsed answer.
+     */
+    runDefaultsPath(input: DefaultsPathInput): Promise<FirstRunRunResult>;
+    /**
+     * Path B: customize. Walks through the 5-question set, persisting each
+     * answer to `partialAnswers`. Returns `needs_more_input` until every
+     * required-and-conditional question has an answer.
+     */
+    runCustomizePath(input: CustomizePathInput): Promise<FirstRunRunResult>;
+    /**
+     * Replay. Keeps existing tasks intact (the runner upserts by
+     * `idempotencyKey`); only OwnerFactStore facts the questions touch are
+     * updated.
+     */
+    runReplayPath(input: ReplayPathInput): Promise<FirstRunRunResult>;
+    /** Clears lifecycle state without rerunning first-run. */
+    resetState(): Promise<void>;
+    private resolveTimezone;
+    private formatDefaultsCompleteMessage;
+    private formatCustomizeCompleteMessage;
+}
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/lifeops/first-run/service.d.ts.map

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