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

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

@@ -0,0 +1,455 @@
+import { asCacheRuntime } from "../runtime-cache.js";
+import {
+  buildDefaultsPack,
+  deriveMorningWindow,
+  parseWakeTime
+} from "./defaults.js";
+import {
+  CUSTOMIZE_CATEGORIES,
+  DEFAULT_EVENING_WINDOW,
+  DEFAULT_MORNING_WINDOW,
+  parseCategories,
+  parsePreferredName,
+  parseRelationships,
+  parseTimeWindow,
+  parseTimezone,
+  validateChannel
+} from "./questions.js";
+import { partialAnswersFromFacts } from "./replay.js";
+import {
+  createFirstRunStateStore,
+  createOwnerFactStore
+} from "./state.js";
+let registeredRunner = null;
+function setScheduledTaskRunner(runner) {
+  registeredRunner = runner;
+}
+function getScheduledTaskRunner() {
+  return registeredRunner;
+}
+const FALLBACK_RUNNER_CACHE_KEY = "eliza:lifeops:first-run:fallback-tasks:v1";
+class FallbackInMemoryRunner {
+  constructor(runtime) {
+    this.runtime = runtime;
+  }
+  runtime;
+  async schedule(task) {
+    const cache = asCacheRuntime(this.runtime);
+    const taskId = task.idempotencyKey ?? `first-run-task-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    const scheduled = {
+      ...task,
+      taskId,
+      state: { status: "scheduled", followupCount: 0 }
+    };
+    const stored = await cache.getCache(FALLBACK_RUNNER_CACHE_KEY) ?? [];
+    const filtered = task.idempotencyKey ? stored.filter(
+      (entry) => entry.input.idempotencyKey !== task.idempotencyKey
+    ) : stored.slice();
+    filtered.push({
+      taskId,
+      input: task,
+      scheduledAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    await cache.setCache(
+      FALLBACK_RUNNER_CACHE_KEY,
+      filtered
+    );
+    return scheduled;
+  }
+}
+async function readFallbackScheduledTasks(runtime) {
+  const cache = asCacheRuntime(runtime);
+  const stored = await cache.getCache(
+    FALLBACK_RUNNER_CACHE_KEY
+  );
+  return Array.isArray(stored) ? stored.slice() : [];
+}
+async function clearFallbackScheduledTasks(runtime) {
+  const cache = asCacheRuntime(runtime);
+  await cache.deleteCache(FALLBACK_RUNNER_CACHE_KEY);
+}
+function flattenFacts(facts) {
+  const flat = {};
+  if (facts.preferredName) flat.preferredName = facts.preferredName.value;
+  if (facts.timezone) flat.timezone = facts.timezone.value;
+  if (facts.morningWindow) {
+    flat.morningWindow = {
+      startLocal: facts.morningWindow.value.startLocal,
+      endLocal: facts.morningWindow.value.endLocal
+    };
+  }
+  if (facts.eveningWindow) {
+    flat.eveningWindow = {
+      startLocal: facts.eveningWindow.value.startLocal,
+      endLocal: facts.eveningWindow.value.endLocal
+    };
+  }
+  if (facts.preferredNotificationChannel) {
+    flat.preferredNotificationChannel = facts.preferredNotificationChannel.value;
+  }
+  if (facts.locale) flat.locale = facts.locale.value;
+  return flat;
+}
+function makeFirstRunProvenance(note) {
+  const provenance = {
+    source: "first_run",
+    recordedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  if (note) provenance.note = note;
+  return provenance;
+}
+class FirstRunService {
+  constructor(runtime, options) {
+    this.runtime = runtime;
+    this.stateStore = options?.stateStore ?? createFirstRunStateStore(runtime);
+    this.factStore = options?.factStore ?? createOwnerFactStore(runtime);
+    if (options?.runner) {
+      this.runnerOverride = options.runner;
+    }
+  }
+  runtime;
+  stateStore;
+  factStore;
+  runnerOverride = null;
+  resolveRunner() {
+    return this.runnerOverride ?? registeredRunner ?? new FallbackInMemoryRunner(this.runtime);
+  }
+  async readState() {
+    return this.stateStore.read();
+  }
+  async readFacts() {
+    return flattenFacts(await this.factStore.read());
+  }
+  /**
+   * 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.
+   */
+  async runDefaultsPath(input) {
+    let record = await this.stateStore.read();
+    if (record.status === "complete") {
+      return {
+        status: "already_complete",
+        record,
+        facts: flattenFacts(await this.factStore.read()),
+        scheduledTasks: [],
+        message: "First-run already completed. Use the replay path to re-confirm settings.",
+        warnings: []
+      };
+    }
+    if (record.path !== "defaults" || record.status === "pending") {
+      record = await this.stateStore.begin("defaults");
+    }
+    const wakeRaw = typeof input.wakeTime === "string" && input.wakeTime.trim().length > 0 ? input.wakeTime : typeof record.partialAnswers.wakeTime === "string" ? record.partialAnswers.wakeTime : void 0;
+    if (!wakeRaw) {
+      return {
+        status: "needs_more_input",
+        record,
+        facts: flattenFacts(await this.factStore.read()),
+        scheduledTasks: [],
+        awaitingQuestion: "wakeTime",
+        message: "What time do you usually wake up?",
+        warnings: []
+      };
+    }
+    const parsed = parseWakeTime(wakeRaw);
+    if (!parsed) {
+      return {
+        status: "needs_more_input",
+        record,
+        facts: flattenFacts(await this.factStore.read()),
+        scheduledTasks: [],
+        awaitingQuestion: "wakeTime",
+        message: "I didn't catch that wake time. Try something like '6am', '07:30', or 'noon'.",
+        warnings: []
+      };
+    }
+    record = await this.stateStore.recordAnswer("wakeTime", parsed);
+    const morningWindow = deriveMorningWindow(parsed);
+    const timezone = parseTimezone(input.timezone) ?? this.resolveTimezone();
+    const channelValidation = validateChannel(
+      input.channel ?? "in_app",
+      this.runtime
+    );
+    const factsPatch = {
+      morningWindow,
+      timezone,
+      eveningWindow: DEFAULT_EVENING_WINDOW,
+      preferredNotificationChannel: channelValidation.channel
+    };
+    const facts = await this.factStore.update(
+      factsPatch,
+      makeFirstRunProvenance("defaults path: wake-time answer")
+    );
+    const pack = buildDefaultsPack({
+      morningWindow,
+      timezone,
+      agentId: this.runtime.agentId,
+      channel: channelValidation.channel
+    });
+    const runner = this.resolveRunner();
+    const scheduledTasks = [];
+    for (const input2 of pack) {
+      scheduledTasks.push(await runner.schedule(input2));
+    }
+    const completed = await this.stateStore.complete();
+    return {
+      status: "ok",
+      record: completed,
+      facts: flattenFacts(facts),
+      scheduledTasks,
+      message: this.formatDefaultsCompleteMessage(scheduledTasks.length),
+      warnings: channelValidation.warning ? [channelValidation.warning] : []
+    };
+  }
+  /**
+   * 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.
+   */
+  async runCustomizePath(input) {
+    let record = await this.stateStore.read();
+    if (record.status === "complete") {
+      return {
+        status: "already_complete",
+        record,
+        facts: flattenFacts(await this.factStore.read()),
+        scheduledTasks: [],
+        message: "First-run already completed. Use the replay path to re-confirm settings.",
+        warnings: []
+      };
+    }
+    if (record.path !== "customize") {
+      record = await this.stateStore.begin("customize");
+    }
+    const merged = mergeCustomizeAnswers(record.partialAnswers, input);
+    record = await persistCustomizePartials(this.stateStore, merged);
+    const next = nextCustomizeQuestion(merged);
+    if (next) {
+      return {
+        status: "needs_more_input",
+        record,
+        facts: flattenFacts(await this.factStore.read()),
+        scheduledTasks: [],
+        awaitingQuestion: next.id,
+        message: next.prompt,
+        warnings: []
+      };
+    }
+    const finalized = finalizeCustomizeAnswers(merged, this.runtime);
+    const factsPatch = {
+      preferredName: finalized.preferredName,
+      timezone: finalized.timezone,
+      morningWindow: finalized.morningWindow,
+      eveningWindow: finalized.eveningWindow,
+      preferredNotificationChannel: finalized.channel
+    };
+    const facts = await this.factStore.update(
+      factsPatch,
+      makeFirstRunProvenance("customize path: completed questionnaire")
+    );
+    const pack = buildDefaultsPack({
+      morningWindow: finalized.morningWindow,
+      timezone: finalized.timezone,
+      agentId: this.runtime.agentId,
+      channel: finalized.channel
+    });
+    const runner = this.resolveRunner();
+    const scheduledTasks = [];
+    for (const input2 of pack) {
+      scheduledTasks.push(await runner.schedule(input2));
+    }
+    const completed = await this.stateStore.complete();
+    const warnings = [];
+    if (finalized.channelWarning) {
+      warnings.push(finalized.channelWarning);
+    }
+    return {
+      status: "ok",
+      record: completed,
+      facts: flattenFacts(facts),
+      scheduledTasks,
+      message: this.formatCustomizeCompleteMessage(
+        finalized,
+        scheduledTasks.length
+      ),
+      warnings
+    };
+  }
+  /**
+   * Replay. Keeps existing tasks intact (the runner upserts by
+   * `idempotencyKey`); only OwnerFactStore facts the questions touch are
+   * updated.
+   */
+  async runReplayPath(input) {
+    let record = await this.stateStore.read();
+    if (record.status !== "in_progress" || record.path !== "replay") {
+      record = await this.stateStore.begin("replay");
+    }
+    const currentTypedFacts = await this.factStore.read();
+    const partial = partialAnswersFromFacts(currentTypedFacts);
+    const merged = mergeCustomizeAnswers(
+      {
+        ...partial,
+        ...record.partialAnswers
+      },
+      input
+    );
+    record = await persistCustomizePartials(this.stateStore, merged);
+    const next = nextCustomizeQuestion(merged);
+    if (next) {
+      return {
+        status: "needs_more_input",
+        record,
+        facts: flattenFacts(currentTypedFacts),
+        scheduledTasks: [],
+        awaitingQuestion: next.id,
+        message: next.prompt,
+        warnings: []
+      };
+    }
+    const finalized = finalizeCustomizeAnswers(merged, this.runtime);
+    const factsPatch = {
+      preferredName: finalized.preferredName,
+      timezone: finalized.timezone,
+      morningWindow: finalized.morningWindow,
+      eveningWindow: finalized.eveningWindow,
+      preferredNotificationChannel: finalized.channel
+    };
+    const facts = await this.factStore.update(
+      factsPatch,
+      makeFirstRunProvenance("replay path: refreshed answers")
+    );
+    const pack = buildDefaultsPack({
+      morningWindow: finalized.morningWindow,
+      timezone: finalized.timezone,
+      agentId: this.runtime.agentId,
+      channel: finalized.channel
+    });
+    const runner = this.resolveRunner();
+    const scheduledTasks = [];
+    for (const taskInput of pack) {
+      scheduledTasks.push(await runner.schedule(taskInput));
+    }
+    const completed = await this.stateStore.complete();
+    const warnings = [];
+    if (finalized.channelWarning) warnings.push(finalized.channelWarning);
+    return {
+      status: "ok",
+      record: completed,
+      facts: flattenFacts(facts),
+      scheduledTasks,
+      message: "Settings refreshed. Existing scheduled tasks were preserved.",
+      warnings
+    };
+  }
+  /** Clears lifecycle state without rerunning first-run. */
+  async resetState() {
+    await this.stateStore.reset();
+  }
+  resolveTimezone() {
+    try {
+      return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
+    } catch {
+      return "UTC";
+    }
+  }
+  formatDefaultsCompleteMessage(taskCount) {
+    return `Defaults applied \u2014 ${taskCount} reminders scheduled (gm, gn, daily check-in, morning brief).`;
+  }
+  formatCustomizeCompleteMessage(answers, taskCount) {
+    const name = answers.preferredName ? `, ${answers.preferredName}` : "";
+    return `Setup complete${name} \u2014 ${taskCount} reminders scheduled. Channel: ${answers.channel}${answers.channelFallbackToInApp ? " (fallback)" : ""}.`;
+  }
+}
+function mergeCustomizeAnswers(current, patch) {
+  const next = { ...current };
+  if (typeof patch.preferredName === "string") {
+    next.preferredName = patch.preferredName;
+  }
+  if (typeof patch.timezone === "string") {
+    next.timezone = patch.timezone;
+  }
+  if (patch.morningWindow) next.morningWindow = patch.morningWindow;
+  if (patch.eveningWindow) next.eveningWindow = patch.eveningWindow;
+  if (Array.isArray(patch.categories)) next.categories = patch.categories;
+  if (typeof patch.channel === "string") next.channel = patch.channel;
+  if (Array.isArray(patch.relationships)) {
+    next.relationships = patch.relationships;
+  }
+  return next;
+}
+async function persistCustomizePartials(store, merged) {
+  let last = await store.read();
+  for (const [key, value] of Object.entries(merged)) {
+    if (last.partialAnswers[key] === value) continue;
+    last = await store.recordAnswer(key, value);
+  }
+  return last;
+}
+function nextCustomizeQuestion(answers) {
+  if (!parsePreferredName(answers.preferredName)) {
+    return {
+      id: "preferredName",
+      prompt: "What should I call you?"
+    };
+  }
+  if (!parseTimezone(answers.timezone) || !parseTimeWindow(answers.morningWindow) || !parseTimeWindow(answers.eveningWindow)) {
+    return {
+      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.)"
+    };
+  }
+  if (parseCategories(answers.categories) === null) {
+    return {
+      id: "categories",
+      prompt: `Which categories sound useful to enable now? (multi-select: ${CUSTOMIZE_CATEGORIES.join(", ")})`
+    };
+  }
+  const channelRaw = answers.channel;
+  if (typeof channelRaw !== "string" || channelRaw.trim().length === 0) {
+    return {
+      id: "channel",
+      prompt: "Where do you want me to nudge you? (in_app, push, imessage, discord, telegram)"
+    };
+  }
+  const categories = parseCategories(answers.categories) ?? [];
+  if (categories.includes("follow-ups") && parseRelationships(answers.relationships) === null) {
+    return {
+      id: "relationships",
+      prompt: "List 3\u20135 important relationships and a default cadence (e.g. 'Pat \u2014 14 days; Sam \u2014 weekly')."
+    };
+  }
+  return null;
+}
+function finalizeCustomizeAnswers(answers, runtime) {
+  const preferredName = parsePreferredName(answers.preferredName) ?? "";
+  const timezone = parseTimezone(answers.timezone) ?? "UTC";
+  const morningWindow = parseTimeWindow(answers.morningWindow) ?? DEFAULT_MORNING_WINDOW;
+  const eveningWindow = parseTimeWindow(answers.eveningWindow) ?? DEFAULT_EVENING_WINDOW;
+  const categories = parseCategories(answers.categories) ?? [];
+  const validation = validateChannel(answers.channel, runtime);
+  const relationships = parseRelationships(answers.relationships) ?? void 0;
+  const finalized = {
+    preferredName,
+    timezone,
+    morningWindow,
+    eveningWindow,
+    categories,
+    channel: validation.channel,
+    channelFallbackToInApp: validation.fallbackToInApp
+  };
+  if (validation.warning) finalized.channelWarning = validation.warning;
+  if (relationships)
+    finalized.relationships = relationships;
+  return finalized;
+}
+export {
+  FirstRunService,
+  clearFallbackScheduledTasks,
+  getScheduledTaskRunner,
+  readFallbackScheduledTasks,
+  setScheduledTaskRunner
+};
+//# sourceMappingURL=service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/first-run/service.ts"],"sourcesContent":["/**\n * `FirstRunService` — orchestrator for the first-run capability.\n *\n * Owns:\n *   - the lifecycle state machine (`pending` → `in_progress` → `complete`)\n *     via `FirstRunStateStore`\n *   - writes to the canonical `OwnerFactStore`\n *   - emission of the defaults pack into the `ScheduledTaskRunner`\n *   - the replay path (re-run without destroying tasks)\n *\n * The runner is injected: if the production runner is registered on the\n * runtime by the time the action fires, this service uses it; otherwise it\n * falls back to an in-memory recorder that is sufficient for unit /\n * integration tests.\n */\n\nimport type { IAgentRuntime } from \"@elizaos/core\";\nimport { asCacheRuntime } from \"../runtime-cache.js\";\nimport type { ScheduledTask, ScheduledTaskInput } from \"../wave1-types.js\";\nimport {\n  buildDefaultsPack,\n  deriveMorningWindow,\n  parseWakeTime,\n} from \"./defaults.js\";\nimport {\n  CUSTOMIZE_CATEGORIES,\n  type CustomizeAnswers,\n  type CustomizeCategory,\n  DEFAULT_EVENING_WINDOW,\n  DEFAULT_MORNING_WINDOW,\n  parseCategories,\n  parsePreferredName,\n  parseRelationships,\n  parseTimeWindow,\n  parseTimezone,\n  type RelationshipAnswerEntry,\n  validateChannel,\n} from \"./questions.js\";\nimport { partialAnswersFromFacts } from \"./replay.js\";\nimport {\n  createFirstRunStateStore,\n  createOwnerFactStore,\n  type FirstRunRecord,\n  type FirstRunStateStore,\n  type OwnerFactProvenance,\n  type OwnerFactStore,\n  type OwnerFacts,\n  type OwnerFactsPatch,\n} from \"./state.js\";\n\n// --- Runner injection ------------------------------------------------------\n\nexport interface ScheduledTaskRunnerLike {\n  schedule(task: ScheduledTaskInput): Promise<ScheduledTask>;\n}\n\n/**\n * Runtime-side hook used to expose the production runner. The plugin `init`\n * registers an instance via `setScheduledTaskRunner`; the first-run service\n * calls `getScheduledTaskRunner` to fetch it. When unset, the service uses\n * the in-memory fallback which is sufficient for tests.\n */\nlet registeredRunner: ScheduledTaskRunnerLike | null = null;\n\nexport function setScheduledTaskRunner(\n  runner: ScheduledTaskRunnerLike | null,\n): void {\n  registeredRunner = runner;\n}\n\nexport function getScheduledTaskRunner(): ScheduledTaskRunnerLike | null {\n  return registeredRunner;\n}\n\ninterface CachedTaskRecord {\n  taskId: string;\n  input: ScheduledTaskInput;\n  scheduledAt: string;\n}\n\nconst FALLBACK_RUNNER_CACHE_KEY = \"eliza:lifeops:first-run:fallback-tasks:v1\";\n\nclass FallbackInMemoryRunner implements ScheduledTaskRunnerLike {\n  constructor(private readonly runtime: IAgentRuntime) {}\n  async schedule(task: ScheduledTaskInput): Promise<ScheduledTask> {\n    const cache = asCacheRuntime(this.runtime);\n    const taskId =\n      task.idempotencyKey ??\n      `first-run-task-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n    const scheduled: ScheduledTask = {\n      ...task,\n      taskId,\n      state: { status: \"scheduled\", followupCount: 0 },\n    };\n    const stored =\n      (await cache.getCache<CachedTaskRecord[]>(FALLBACK_RUNNER_CACHE_KEY)) ??\n      [];\n    const filtered = task.idempotencyKey\n      ? stored.filter(\n          (entry) => entry.input.idempotencyKey !== task.idempotencyKey,\n        )\n      : stored.slice();\n    filtered.push({\n      taskId,\n      input: task,\n      scheduledAt: new Date().toISOString(),\n    });\n    await cache.setCache<CachedTaskRecord[]>(\n      FALLBACK_RUNNER_CACHE_KEY,\n      filtered,\n    );\n    return scheduled;\n  }\n}\n\nexport async function readFallbackScheduledTasks(\n  runtime: IAgentRuntime,\n): Promise<CachedTaskRecord[]> {\n  const cache = asCacheRuntime(runtime);\n  const stored = await cache.getCache<CachedTaskRecord[]>(\n    FALLBACK_RUNNER_CACHE_KEY,\n  );\n  return Array.isArray(stored) ? stored.slice() : [];\n}\n\nexport async function clearFallbackScheduledTasks(\n  runtime: IAgentRuntime,\n): Promise<void> {\n  const cache = asCacheRuntime(runtime);\n  await cache.deleteCache(FALLBACK_RUNNER_CACHE_KEY);\n}\n\n// --- Flat-facts view (test-facing) ----------------------------------------\n\n/**\n * Flat projection of the typed `OwnerFacts` store, used by callers that\n * want quick scalar access to fact values (first-run tests, replay\n * pre-fill). Provenance is intentionally elided — readers that need it go\n * through the typed `OwnerFactStore` directly.\n */\nexport interface FirstRunFlatFacts {\n  preferredName?: string;\n  timezone?: string;\n  morningWindow?: { startLocal: string; endLocal: string };\n  eveningWindow?: { startLocal: string; endLocal: string };\n  preferredNotificationChannel?: string;\n  locale?: string;\n}\n\nfunction flattenFacts(facts: OwnerFacts): FirstRunFlatFacts {\n  const flat: FirstRunFlatFacts = {};\n  if (facts.preferredName) flat.preferredName = facts.preferredName.value;\n  if (facts.timezone) flat.timezone = facts.timezone.value;\n  if (facts.morningWindow) {\n    flat.morningWindow = {\n      startLocal: facts.morningWindow.value.startLocal,\n      endLocal: facts.morningWindow.value.endLocal,\n    };\n  }\n  if (facts.eveningWindow) {\n    flat.eveningWindow = {\n      startLocal: facts.eveningWindow.value.startLocal,\n      endLocal: facts.eveningWindow.value.endLocal,\n    };\n  }\n  if (facts.preferredNotificationChannel) {\n    flat.preferredNotificationChannel =\n      facts.preferredNotificationChannel.value;\n  }\n  if (facts.locale) flat.locale = facts.locale.value;\n  return flat;\n}\n\nfunction makeFirstRunProvenance(note?: string): OwnerFactProvenance {\n  const provenance: OwnerFactProvenance = {\n    source: \"first_run\",\n    recordedAt: new Date().toISOString(),\n  };\n  if (note) provenance.note = note;\n  return provenance;\n}\n\n// --- Service ---------------------------------------------------------------\n\nexport interface FirstRunRunResult {\n  status: \"ok\" | \"needs_more_input\" | \"already_complete\";\n  record: FirstRunRecord;\n  facts: FirstRunFlatFacts;\n  scheduledTasks: ScheduledTask[];\n  /** Question id awaiting an answer (only set when status = needs_more_input). */\n  awaitingQuestion?: string;\n  /** Human-readable message the action surfaces back. */\n  message: string;\n  /** Warnings collected during the flow (e.g. channel-validation fallback). */\n  warnings: string[];\n}\n\nexport interface DefaultsPathInput {\n  /** Free-text wake time, e.g. \"6am\", \"07:30\". Required on first invocation. */\n  wakeTime?: string;\n  /** IANA timezone; defaults to runtime / system value if absent. */\n  timezone?: string;\n  /** Optional notification channel; defaults to in_app. */\n  channel?: string;\n}\n\nexport interface CustomizePathInput {\n  preferredName?: string;\n  timezone?: string;\n  morningWindow?: { startLocal: string; endLocal: string };\n  eveningWindow?: { startLocal: string; endLocal: string };\n  categories?: string[];\n  channel?: string;\n  relationships?: Array<{ name: string; cadenceDays: number }>;\n}\n\nexport interface ReplayPathInput {\n  /** Allows the same answer keys as customize, but only applied when present. */\n  preferredName?: string;\n  timezone?: string;\n  morningWindow?: { startLocal: string; endLocal: string };\n  eveningWindow?: { startLocal: string; endLocal: string };\n  categories?: string[];\n  channel?: string;\n  relationships?: Array<{ name: string; cadenceDays: number }>;\n}\n\nexport class FirstRunService {\n  private readonly stateStore: FirstRunStateStore;\n  private readonly factStore: OwnerFactStore;\n  constructor(\n    private readonly runtime: IAgentRuntime,\n    options?: {\n      stateStore?: FirstRunStateStore;\n      factStore?: OwnerFactStore;\n      runner?: ScheduledTaskRunnerLike;\n    },\n  ) {\n    this.stateStore = options?.stateStore ?? createFirstRunStateStore(runtime);\n    this.factStore = options?.factStore ?? createOwnerFactStore(runtime);\n    if (options?.runner) {\n      // Caller-supplied runner trumps the registered one (used by tests).\n      this.runnerOverride = options.runner;\n    }\n  }\n  private runnerOverride: ScheduledTaskRunnerLike | null = null;\n\n  private resolveRunner(): ScheduledTaskRunnerLike {\n    return (\n      this.runnerOverride ??\n      registeredRunner ??\n      new FallbackInMemoryRunner(this.runtime)\n    );\n  }\n\n  async readState(): Promise<FirstRunRecord> {\n    return this.stateStore.read();\n  }\n\n  async readFacts(): Promise<FirstRunFlatFacts> {\n    return flattenFacts(await this.factStore.read());\n  }\n\n  /**\n   * Path A: defaults. Asks ONE question (wake time) before scheduling. The\n   * action invokes `runDefaultsPath` once with no `wakeTime`, gets back a\n   * `needs_more_input` result and the question text, then re-invokes with\n   * the parsed answer.\n   */\n  async runDefaultsPath(input: DefaultsPathInput): Promise<FirstRunRunResult> {\n    let record = await this.stateStore.read();\n    if (record.status === \"complete\") {\n      return {\n        status: \"already_complete\",\n        record,\n        facts: flattenFacts(await this.factStore.read()),\n        scheduledTasks: [],\n        message:\n          \"First-run already completed. Use the replay path to re-confirm settings.\",\n        warnings: [],\n      };\n    }\n    if (record.path !== \"defaults\" || record.status === \"pending\") {\n      record = await this.stateStore.begin(\"defaults\");\n    }\n\n    const wakeRaw =\n      typeof input.wakeTime === \"string\" && input.wakeTime.trim().length > 0\n        ? input.wakeTime\n        : typeof record.partialAnswers.wakeTime === \"string\"\n          ? (record.partialAnswers.wakeTime as string)\n          : undefined;\n\n    if (!wakeRaw) {\n      return {\n        status: \"needs_more_input\",\n        record,\n        facts: flattenFacts(await this.factStore.read()),\n        scheduledTasks: [],\n        awaitingQuestion: \"wakeTime\",\n        message: \"What time do you usually wake up?\",\n        warnings: [],\n      };\n    }\n\n    const parsed = parseWakeTime(wakeRaw);\n    if (!parsed) {\n      return {\n        status: \"needs_more_input\",\n        record,\n        facts: flattenFacts(await this.factStore.read()),\n        scheduledTasks: [],\n        awaitingQuestion: \"wakeTime\",\n        message:\n          \"I didn't catch that wake time. Try something like '6am', '07:30', or 'noon'.\",\n        warnings: [],\n      };\n    }\n    record = await this.stateStore.recordAnswer(\"wakeTime\", parsed);\n\n    const morningWindow = deriveMorningWindow(parsed);\n    const timezone = parseTimezone(input.timezone) ?? this.resolveTimezone();\n    const channelValidation = validateChannel(\n      input.channel ?? \"in_app\",\n      this.runtime,\n    );\n    const factsPatch: OwnerFactsPatch = {\n      morningWindow,\n      timezone,\n      eveningWindow: DEFAULT_EVENING_WINDOW,\n      preferredNotificationChannel: channelValidation.channel,\n    };\n    const facts = await this.factStore.update(\n      factsPatch,\n      makeFirstRunProvenance(\"defaults path: wake-time answer\"),\n    );\n\n    const pack = buildDefaultsPack({\n      morningWindow,\n      timezone,\n      agentId: this.runtime.agentId,\n      channel: channelValidation.channel,\n    });\n    const runner = this.resolveRunner();\n    const scheduledTasks: ScheduledTask[] = [];\n    for (const input of pack) {\n      scheduledTasks.push(await runner.schedule(input));\n    }\n\n    const completed = await this.stateStore.complete();\n\n    return {\n      status: \"ok\",\n      record: completed,\n      facts: flattenFacts(facts),\n      scheduledTasks,\n      message: this.formatDefaultsCompleteMessage(scheduledTasks.length),\n      warnings: channelValidation.warning ? [channelValidation.warning] : [],\n    };\n  }\n\n  /**\n   * Path B: customize. Walks through the 5-question set, persisting each\n   * answer to `partialAnswers`. Returns `needs_more_input` until every\n   * required-and-conditional question has an answer.\n   */\n  async runCustomizePath(\n    input: CustomizePathInput,\n  ): Promise<FirstRunRunResult> {\n    let record = await this.stateStore.read();\n    if (record.status === \"complete\") {\n      return {\n        status: \"already_complete\",\n        record,\n        facts: flattenFacts(await this.factStore.read()),\n        scheduledTasks: [],\n        message:\n          \"First-run already completed. Use the replay path to re-confirm settings.\",\n        warnings: [],\n      };\n    }\n    if (record.path !== \"customize\") {\n      record = await this.stateStore.begin(\"customize\");\n    }\n\n    const merged = mergeCustomizeAnswers(record.partialAnswers, input);\n    record = await persistCustomizePartials(this.stateStore, merged);\n\n    const next = nextCustomizeQuestion(merged);\n    if (next) {\n      return {\n        status: \"needs_more_input\",\n        record,\n        facts: flattenFacts(await this.factStore.read()),\n        scheduledTasks: [],\n        awaitingQuestion: next.id,\n        message: next.prompt,\n        warnings: [],\n      };\n    }\n\n    const finalized = finalizeCustomizeAnswers(merged, this.runtime);\n\n    const factsPatch: OwnerFactsPatch = {\n      preferredName: finalized.preferredName,\n      timezone: finalized.timezone,\n      morningWindow: finalized.morningWindow,\n      eveningWindow: finalized.eveningWindow,\n      preferredNotificationChannel: finalized.channel,\n    };\n    const facts = await this.factStore.update(\n      factsPatch,\n      makeFirstRunProvenance(\"customize path: completed questionnaire\"),\n    );\n\n    const pack = buildDefaultsPack({\n      morningWindow: finalized.morningWindow,\n      timezone: finalized.timezone,\n      agentId: this.runtime.agentId,\n      channel: finalized.channel,\n    });\n    const runner = this.resolveRunner();\n    const scheduledTasks: ScheduledTask[] = [];\n    for (const input of pack) {\n      scheduledTasks.push(await runner.schedule(input));\n    }\n    // Categories that gate followups would create per-relationship watcher\n    // tasks via the followup-starter pack. Here we just record the\n    // selection on the answers; the pack reads those facts at boot.\n\n    const completed = await this.stateStore.complete();\n    const warnings: string[] = [];\n    if (finalized.channelWarning) {\n      warnings.push(finalized.channelWarning);\n    }\n    return {\n      status: \"ok\",\n      record: completed,\n      facts: flattenFacts(facts),\n      scheduledTasks,\n      message: this.formatCustomizeCompleteMessage(\n        finalized,\n        scheduledTasks.length,\n      ),\n      warnings,\n    };\n  }\n\n  /**\n   * Replay. Keeps existing tasks intact (the runner upserts by\n   * `idempotencyKey`); only OwnerFactStore facts the questions touch are\n   * updated.\n   */\n  async runReplayPath(input: ReplayPathInput): Promise<FirstRunRunResult> {\n    let record = await this.stateStore.read();\n    if (record.status !== \"in_progress\" || record.path !== \"replay\") {\n      record = await this.stateStore.begin(\"replay\");\n    }\n    const currentTypedFacts = await this.factStore.read();\n    const partial = partialAnswersFromFacts(currentTypedFacts);\n    const merged = mergeCustomizeAnswers(\n      {\n        ...partial,\n        ...record.partialAnswers,\n      },\n      input,\n    );\n    record = await persistCustomizePartials(this.stateStore, merged);\n\n    const next = nextCustomizeQuestion(merged);\n    if (next) {\n      return {\n        status: \"needs_more_input\",\n        record,\n        facts: flattenFacts(currentTypedFacts),\n        scheduledTasks: [],\n        awaitingQuestion: next.id,\n        message: next.prompt,\n        warnings: [],\n      };\n    }\n\n    const finalized = finalizeCustomizeAnswers(merged, this.runtime);\n    const factsPatch: OwnerFactsPatch = {\n      preferredName: finalized.preferredName,\n      timezone: finalized.timezone,\n      morningWindow: finalized.morningWindow,\n      eveningWindow: finalized.eveningWindow,\n      preferredNotificationChannel: finalized.channel,\n    };\n    const facts = await this.factStore.update(\n      factsPatch,\n      makeFirstRunProvenance(\"replay path: refreshed answers\"),\n    );\n\n    // Re-emit the defaults pack with the same idempotency keys so the runner\n    // upserts in place. Existing user-authored tasks (different idempotency\n    // keys) are untouched.\n    const pack = buildDefaultsPack({\n      morningWindow: finalized.morningWindow,\n      timezone: finalized.timezone,\n      agentId: this.runtime.agentId,\n      channel: finalized.channel,\n    });\n    const runner = this.resolveRunner();\n    const scheduledTasks: ScheduledTask[] = [];\n    for (const taskInput of pack) {\n      scheduledTasks.push(await runner.schedule(taskInput));\n    }\n\n    const completed = await this.stateStore.complete();\n    const warnings: string[] = [];\n    if (finalized.channelWarning) warnings.push(finalized.channelWarning);\n    return {\n      status: \"ok\",\n      record: completed,\n      facts: flattenFacts(facts),\n      scheduledTasks,\n      message: \"Settings refreshed. Existing scheduled tasks were preserved.\",\n      warnings,\n    };\n  }\n\n  /** Clears lifecycle state without rerunning first-run. */\n  async resetState(): Promise<void> {\n    await this.stateStore.reset();\n  }\n\n  private resolveTimezone(): string {\n    try {\n      return Intl.DateTimeFormat().resolvedOptions().timeZone || \"UTC\";\n    } catch {\n      return \"UTC\";\n    }\n  }\n\n  private formatDefaultsCompleteMessage(taskCount: number): string {\n    return `Defaults applied — ${taskCount} reminders scheduled (gm, gn, daily check-in, morning brief).`;\n  }\n\n  private formatCustomizeCompleteMessage(\n    answers: FinalizedCustomizeAnswers,\n    taskCount: number,\n  ): string {\n    const name = answers.preferredName ? `, ${answers.preferredName}` : \"\";\n    return `Setup complete${name} — ${taskCount} reminders scheduled. Channel: ${answers.channel}${\n      answers.channelFallbackToInApp ? \" (fallback)\" : \"\"\n    }.`;\n  }\n}\n\n// --- Customize internals --------------------------------------------------\n\nfunction mergeCustomizeAnswers(\n  current: Record<string, unknown>,\n  patch: CustomizePathInput,\n): Record<string, unknown> {\n  const next: Record<string, unknown> = { ...current };\n  if (typeof patch.preferredName === \"string\") {\n    next.preferredName = patch.preferredName;\n  }\n  if (typeof patch.timezone === \"string\") {\n    next.timezone = patch.timezone;\n  }\n  if (patch.morningWindow) next.morningWindow = patch.morningWindow;\n  if (patch.eveningWindow) next.eveningWindow = patch.eveningWindow;\n  if (Array.isArray(patch.categories)) next.categories = patch.categories;\n  if (typeof patch.channel === \"string\") next.channel = patch.channel;\n  if (Array.isArray(patch.relationships)) {\n    next.relationships = patch.relationships;\n  }\n  return next;\n}\n\nasync function persistCustomizePartials(\n  store: FirstRunStateStore,\n  merged: Record<string, unknown>,\n): Promise<FirstRunRecord> {\n  let last: FirstRunRecord = await store.read();\n  for (const [key, value] of Object.entries(merged)) {\n    if (last.partialAnswers[key] === value) continue;\n    last = await store.recordAnswer(key, value);\n  }\n  return last;\n}\n\ninterface CustomizeQuestionState {\n  id:\n    | \"preferredName\"\n    | \"timezoneAndWindows\"\n    | \"categories\"\n    | \"channel\"\n    | \"relationships\";\n  prompt: string;\n}\n\nfunction nextCustomizeQuestion(\n  answers: Record<string, unknown>,\n): CustomizeQuestionState | null {\n  if (!parsePreferredName(answers.preferredName)) {\n    return {\n      id: \"preferredName\",\n      prompt: \"What should I call you?\",\n    };\n  }\n  if (\n    !parseTimezone(answers.timezone) ||\n    !parseTimeWindow(answers.morningWindow) ||\n    !parseTimeWindow(answers.eveningWindow)\n  ) {\n    return {\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    };\n  }\n  if (parseCategories(answers.categories) === null) {\n    return {\n      id: \"categories\",\n      prompt: `Which categories sound useful to enable now? (multi-select: ${CUSTOMIZE_CATEGORIES.join(\", \")})`,\n    };\n  }\n  const channelRaw = answers.channel;\n  if (typeof channelRaw !== \"string\" || channelRaw.trim().length === 0) {\n    return {\n      id: \"channel\",\n      prompt:\n        \"Where do you want me to nudge you? (in_app, push, imessage, discord, telegram)\",\n    };\n  }\n  const categories = parseCategories(answers.categories) ?? [];\n  if (\n    categories.includes(\"follow-ups\") &&\n    parseRelationships(answers.relationships) === null\n  ) {\n    return {\n      id: \"relationships\",\n      prompt:\n        \"List 3–5 important relationships and a default cadence (e.g. 'Pat — 14 days; Sam — weekly').\",\n    };\n  }\n  return null;\n}\n\ninterface FinalizedCustomizeAnswers extends CustomizeAnswers {\n  channelFallbackToInApp: boolean;\n}\n\nfunction finalizeCustomizeAnswers(\n  answers: Record<string, unknown>,\n  runtime: IAgentRuntime,\n): FinalizedCustomizeAnswers {\n  const preferredName = parsePreferredName(answers.preferredName) ?? \"\";\n  const timezone = parseTimezone(answers.timezone) ?? \"UTC\";\n  const morningWindow =\n    parseTimeWindow(answers.morningWindow) ?? DEFAULT_MORNING_WINDOW;\n  const eveningWindow =\n    parseTimeWindow(answers.eveningWindow) ?? DEFAULT_EVENING_WINDOW;\n  const categories = parseCategories(answers.categories) ?? [];\n  const validation = validateChannel(answers.channel, runtime);\n  const relationships = parseRelationships(answers.relationships) ?? undefined;\n  const finalized: FinalizedCustomizeAnswers = {\n    preferredName,\n    timezone,\n    morningWindow,\n    eveningWindow,\n    categories: categories as CustomizeCategory[],\n    channel: validation.channel,\n    channelFallbackToInApp: validation.fallbackToInApp,\n  };\n  if (validation.warning) finalized.channelWarning = validation.warning;\n  if (relationships)\n    finalized.relationships = relationships as RelationshipAnswerEntry[];\n  return finalized;\n}\n"],"mappings":"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","names":["input"]}

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

@@ -0,0 +1,36 @@
+/**
+ * First-run lifecycle state.
+ *
+ * Owns the `pending` → `in_progress` → `complete` lifecycle and the
+ * Q-by-Q `partialAnswers` accumulator used by the customize path. The
+ * canonical owner-fact store lives in `../owner/fact-store.ts`.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+export type { EscalationRule, OwnerFactEntry, OwnerFactProvenance, OwnerFactProvenanceSource, OwnerFactStore, OwnerFacts, OwnerFactsPatch, OwnerFactWindow, OwnerQuietHours, PolicyPatchEscalationRule, PolicyPatchReminderIntensity, ReminderIntensity, } from "../owner/fact-store.js";
+export { createOwnerFactStore, getOwnerFactStore, ownerFactsToView, registerOwnerFactStore, resolveOwnerFactStore, } from "../owner/fact-store.js";
+export type FirstRunPath = "defaults" | "customize" | "replay";
+export type FirstRunStatus = "pending" | "in_progress" | "complete";
+export interface FirstRunRecord {
+    status: FirstRunStatus;
+    path?: FirstRunPath;
+    /** Q-by-Q answers persisted as the customize flow advances. */
+    partialAnswers: Record<string, unknown>;
+    /** First time this user kicked off first-run. */
+    startedAt?: string;
+    /** Set when status flipped to `complete`. */
+    completedAt?: string;
+    /** Number of completed runs (replay increments this). */
+    completionCount: number;
+}
+export interface FirstRunStateStore {
+    read(): Promise<FirstRunRecord>;
+    begin(path: FirstRunPath): Promise<FirstRunRecord>;
+    recordAnswer(key: string, value: unknown): Promise<FirstRunRecord>;
+    abandon(): Promise<FirstRunRecord>;
+    complete(): Promise<FirstRunRecord>;
+    /** Reset the lifecycle entirely and replay re-entry. */
+    reset(): Promise<void>;
+}
+export declare function createFirstRunStateStore(runtime: IAgentRuntime): FirstRunStateStore;
+export declare const FIRST_RUN_AFFORDANCE_PATHS: ReadonlyArray<"defaults" | "customize">;
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/lifeops/first-run/state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAKnD,YAAY,EACV,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,yBAAyB,EACzB,cAAc,EACd,UAAU,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,4BAA4B,EAC5B,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE/D,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;AAEpE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,+DAA+D;IAC/D,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,eAAe,EAAE,MAAM,CAAC;CACzB;AAID,MAAM,WAAW,kBAAkB;IACjC,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACnD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACnE,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACpC,wDAAwD;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAyDD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,aAAa,GACrB,kBAAkB,CA8EpB;AAED,eAAO,MAAM,0BAA0B,EAAE,aAAa,CACpD,UAAU,GAAG,WAAW,CACG,CAAC"}