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

package/dist/lifeops/owner/fact-store.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/owner/fact-store.ts"],"sourcesContent":["/**\n * `OwnerFactStore` — single typed store for owner facts, preferences, and\n * policies, distinguishing facts (durable owner state) from policies\n * (preferences that gate behavior).\n *\n * The store holds `LifeOpsOwnerProfile` plus the facts\n * (`travelBookingPreferences`, `quietHours`, `morningWindow`,\n * `eveningWindow`, `preferredNotificationChannel`, `locale`). Each entry\n * carries a provenance record so call sites can distinguish a value the user\n * typed in first-run customize from one the agent inferred from a connector\n * — and so audits can trace the origin.\n *\n * Reminder intensity and escalation policy flows write into the store's policy\n * entries.\n *\n * Persistence: cache-backed, single record per agent. The cache key is\n * `eliza:lifeops:owner-fact-store:v1`. The legacy `LifeOpsOwnerProfile`\n * task-metadata payload remains read-only for back-compat readers\n * (`readLifeOpsOwnerProfile` / `service-mixin-calendar.ts`) — this store\n * is the canonical writer.\n */\n\nimport type { IAgentRuntime } from \"@elizaos/core\";\nimport {\n  type LifeOpsOwnerProfilePatch,\n  persistConfiguredOwnerName,\n  updateLifeOpsOwnerProfile,\n} from \"../owner-profile.js\";\nimport { asCacheRuntime } from \"../runtime-cache.js\";\n\n// --- Types ----------------------------------------------------------------\n\nexport interface OwnerFactWindow {\n  /** \"HH:MM\" 24h. Local to `timezone`. */\n  startLocal: string;\n  /** \"HH:MM\" 24h. Local to `timezone`. */\n  endLocal: string;\n}\n\nexport interface OwnerQuietHours {\n  /** \"HH:MM\" 24h. Local to `timezone`. */\n  startLocal: string;\n  /** \"HH:MM\" 24h. Local to `timezone`. */\n  endLocal: string;\n  /** IANA timezone the start/end values are interpreted in. */\n  timezone: string;\n}\n\n/**\n * Source of truth for a stored fact. `first_run` distinguishes answers\n * captured by the first-run capability from answers captured by the\n * owner-profile extraction evaluator. `connector_inferred` covers values an\n * adapter wrote (e.g. timezone from Google Calendar). `agent_inferred`\n * covers LLM-derived values (e.g. relationshipStatus extracted from a\n * conversation).\n */\nexport type OwnerFactProvenanceSource =\n  | \"first_run\"\n  | \"profile_save\"\n  | \"connector_inferred\"\n  | \"agent_inferred\"\n  | \"policy_action\";\n\nexport interface OwnerFactProvenance {\n  source: OwnerFactProvenanceSource;\n  /** ISO-8601 timestamp of the write that produced this value. */\n  recordedAt: string;\n  /** Optional free-form note explaining the write (audit trail). */\n  note?: string;\n}\n\nexport interface OwnerFactEntry<T> {\n  value: T;\n  provenance: OwnerFactProvenance;\n}\n\nexport type ReminderIntensity =\n  | \"minimal\"\n  | \"normal\"\n  | \"persistent\"\n  | \"high_priority_only\";\n\nexport interface EscalationRule {\n  /** Optional definition id this rule scopes to; null = global default. */\n  definitionId: string | null;\n  /** Minutes after fire before escalating. */\n  timeoutMinutes: number | null;\n  /** Minutes after fire before escalating to a voice call. */\n  callAfterMinutes: number | null;\n}\n\n/**\n * Canonical fact set. Typed entries with provenance. Adding a fact means\n * adding the field here and (where needed) adding a normalizer to\n * `normalizePatch`.\n */\nexport interface OwnerFacts {\n  // Identity\n  preferredName?: OwnerFactEntry<string>;\n  relationshipStatus?: OwnerFactEntry<string>;\n  partnerName?: OwnerFactEntry<string>;\n  orientation?: OwnerFactEntry<string>;\n  gender?: OwnerFactEntry<string>;\n  age?: OwnerFactEntry<string>;\n  location?: OwnerFactEntry<string>;\n\n  // Preferences\n  travelBookingPreferences?: OwnerFactEntry<string>;\n  morningWindow?: OwnerFactEntry<OwnerFactWindow>;\n  eveningWindow?: OwnerFactEntry<OwnerFactWindow>;\n  quietHours?: OwnerFactEntry<OwnerQuietHours>;\n  preferredNotificationChannel?: OwnerFactEntry<string>;\n  locale?: OwnerFactEntry<string>;\n  timezone?: OwnerFactEntry<string>;\n\n  // Policies (writable via the policy-aware setters; read-only here)\n  reminderIntensity?: OwnerFactEntry<ReminderIntensity>;\n  escalationRules?: OwnerFactEntry<EscalationRule[]>;\n}\n\nexport interface OwnerFactsPatch {\n  preferredName?: string;\n  relationshipStatus?: string;\n  partnerName?: string;\n  orientation?: string;\n  gender?: string;\n  age?: string;\n  location?: string;\n  travelBookingPreferences?: string;\n  morningWindow?: OwnerFactWindow;\n  eveningWindow?: OwnerFactWindow;\n  quietHours?: OwnerQuietHours;\n  preferredNotificationChannel?: string;\n  locale?: string;\n  timezone?: string;\n}\n\nexport interface PolicyPatchReminderIntensity {\n  intensity: ReminderIntensity;\n  /** Optional note to include in provenance. */\n  note?: string;\n}\n\nexport interface PolicyPatchEscalationRule {\n  rule: EscalationRule;\n  /** Optional note to include in provenance. */\n  note?: string;\n}\n\nexport interface OwnerFactStore {\n  read(): Promise<OwnerFacts>;\n  /** Write fact entries. Provenance is recorded for every patched key. */\n  update(\n    patch: OwnerFactsPatch,\n    provenance: OwnerFactProvenance,\n  ): Promise<OwnerFacts>;\n  /** Set the reminder-intensity policy. */\n  setReminderIntensity(\n    patch: PolicyPatchReminderIntensity,\n    provenance: OwnerFactProvenance,\n  ): Promise<OwnerFacts>;\n  /**\n   * Upsert an escalation rule. Rules are matched by `definitionId`\n   * (`null` = global). Calling with an existing key replaces it.\n   */\n  upsertEscalationRule(\n    patch: PolicyPatchEscalationRule,\n    provenance: OwnerFactProvenance,\n  ): Promise<OwnerFacts>;\n}\n\n// --- Persistence ----------------------------------------------------------\n\nconst FACT_STORE_CACHE_KEY = \"eliza:lifeops:owner-fact-store:v1\";\n\nconst TIME_OF_DAY_PATTERN = /^([01]\\d|2[0-3]):[0-5]\\d$/;\n\ninterface PersistedRecord {\n  schemaVersion: 1;\n  facts: OwnerFacts;\n}\n\nfunction emptyRecord(): PersistedRecord {\n  return { schemaVersion: 1, facts: {} };\n}\n\nfunction isPlainRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction isWindow(value: unknown): value is OwnerFactWindow {\n  if (!isPlainRecord(value)) return false;\n  return (\n    typeof value.startLocal === \"string\" &&\n    TIME_OF_DAY_PATTERN.test(value.startLocal) &&\n    typeof value.endLocal === \"string\" &&\n    TIME_OF_DAY_PATTERN.test(value.endLocal)\n  );\n}\n\nfunction isQuietHours(value: unknown): value is OwnerQuietHours {\n  if (!isPlainRecord(value)) return false;\n  return (\n    typeof value.startLocal === \"string\" &&\n    TIME_OF_DAY_PATTERN.test(value.startLocal) &&\n    typeof value.endLocal === \"string\" &&\n    TIME_OF_DAY_PATTERN.test(value.endLocal) &&\n    typeof value.timezone === \"string\" &&\n    value.timezone.length > 0\n  );\n}\n\nfunction isReminderIntensity(value: unknown): value is ReminderIntensity {\n  return (\n    value === \"minimal\" ||\n    value === \"normal\" ||\n    value === \"persistent\" ||\n    value === \"high_priority_only\"\n  );\n}\n\nfunction isProvenanceSource(\n  value: unknown,\n): value is OwnerFactProvenanceSource {\n  return (\n    value === \"first_run\" ||\n    value === \"profile_save\" ||\n    value === \"connector_inferred\" ||\n    value === \"agent_inferred\" ||\n    value === \"policy_action\"\n  );\n}\n\nfunction normalizeProvenance(value: unknown): OwnerFactProvenance | null {\n  if (!isPlainRecord(value)) return null;\n  if (!isProvenanceSource(value.source)) return null;\n  if (typeof value.recordedAt !== \"string\" || value.recordedAt.length === 0) {\n    return null;\n  }\n  const provenance: OwnerFactProvenance = {\n    source: value.source,\n    recordedAt: value.recordedAt,\n  };\n  if (typeof value.note === \"string\" && value.note.length > 0) {\n    provenance.note = value.note;\n  }\n  return provenance;\n}\n\nfunction normalizeStringEntry(\n  value: unknown,\n): OwnerFactEntry<string> | undefined {\n  if (!isPlainRecord(value)) return undefined;\n  const stringValue = typeof value.value === \"string\" ? value.value.trim() : \"\";\n  if (!stringValue) return undefined;\n  const provenance = normalizeProvenance(value.provenance);\n  if (!provenance) return undefined;\n  return { value: stringValue, provenance };\n}\n\nfunction normalizeWindowEntry(\n  value: unknown,\n): OwnerFactEntry<OwnerFactWindow> | undefined {\n  if (!isPlainRecord(value)) return undefined;\n  const window = isWindow(value.value) ? value.value : null;\n  if (!window) return undefined;\n  const provenance = normalizeProvenance(value.provenance);\n  if (!provenance) return undefined;\n  return {\n    value: { startLocal: window.startLocal, endLocal: window.endLocal },\n    provenance,\n  };\n}\n\nfunction normalizeQuietHoursEntry(\n  value: unknown,\n): OwnerFactEntry<OwnerQuietHours> | undefined {\n  if (!isPlainRecord(value)) return undefined;\n  const quiet = isQuietHours(value.value) ? value.value : null;\n  if (!quiet) return undefined;\n  const provenance = normalizeProvenance(value.provenance);\n  if (!provenance) return undefined;\n  return {\n    value: {\n      startLocal: quiet.startLocal,\n      endLocal: quiet.endLocal,\n      timezone: quiet.timezone,\n    },\n    provenance,\n  };\n}\n\nfunction normalizeReminderIntensityEntry(\n  value: unknown,\n): OwnerFactEntry<ReminderIntensity> | undefined {\n  if (!isPlainRecord(value)) return undefined;\n  if (!isReminderIntensity(value.value)) return undefined;\n  const provenance = normalizeProvenance(value.provenance);\n  if (!provenance) return undefined;\n  return { value: value.value, provenance };\n}\n\nfunction normalizeEscalationRule(value: unknown): EscalationRule | null {\n  if (!isPlainRecord(value)) return null;\n  const definitionId =\n    typeof value.definitionId === \"string\" && value.definitionId.length > 0\n      ? value.definitionId\n      : null;\n  const timeoutMinutes =\n    typeof value.timeoutMinutes === \"number\" && value.timeoutMinutes >= 0\n      ? Math.floor(value.timeoutMinutes)\n      : null;\n  const callAfterMinutes =\n    typeof value.callAfterMinutes === \"number\" && value.callAfterMinutes >= 0\n      ? Math.floor(value.callAfterMinutes)\n      : null;\n  if (timeoutMinutes === null && callAfterMinutes === null) {\n    return null;\n  }\n  return { definitionId, timeoutMinutes, callAfterMinutes };\n}\n\nfunction normalizeEscalationRulesEntry(\n  value: unknown,\n): OwnerFactEntry<EscalationRule[]> | undefined {\n  if (!isPlainRecord(value)) return undefined;\n  const rules = Array.isArray(value.value)\n    ? value.value\n        .map(normalizeEscalationRule)\n        .filter((rule): rule is EscalationRule => rule !== null)\n    : [];\n  if (rules.length === 0) return undefined;\n  const provenance = normalizeProvenance(value.provenance);\n  if (!provenance) return undefined;\n  return { value: rules, provenance };\n}\n\nfunction normalizeRecord(value: unknown): PersistedRecord {\n  if (!isPlainRecord(value) || !isPlainRecord(value.facts)) {\n    return emptyRecord();\n  }\n  const stored = value.facts;\n  const facts: OwnerFacts = {};\n  const stringFields = [\n    \"preferredName\",\n    \"relationshipStatus\",\n    \"partnerName\",\n    \"orientation\",\n    \"gender\",\n    \"age\",\n    \"location\",\n    \"travelBookingPreferences\",\n    \"preferredNotificationChannel\",\n    \"locale\",\n    \"timezone\",\n  ] as const;\n  for (const field of stringFields) {\n    const entry = normalizeStringEntry(stored[field]);\n    if (entry) {\n      facts[field] = entry;\n    }\n  }\n  const morning = normalizeWindowEntry(stored.morningWindow);\n  if (morning) facts.morningWindow = morning;\n  const evening = normalizeWindowEntry(stored.eveningWindow);\n  if (evening) facts.eveningWindow = evening;\n  const quiet = normalizeQuietHoursEntry(stored.quietHours);\n  if (quiet) facts.quietHours = quiet;\n  const intensity = normalizeReminderIntensityEntry(stored.reminderIntensity);\n  if (intensity) facts.reminderIntensity = intensity;\n  const escalation = normalizeEscalationRulesEntry(stored.escalationRules);\n  if (escalation) facts.escalationRules = escalation;\n  return { schemaVersion: 1, facts };\n}\n\n// --- Patch normalization --------------------------------------------------\n\nfunction trimNonEmpty(value: string): string | null {\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction isWindowPatch(value: unknown): value is OwnerFactWindow {\n  return isWindow(value);\n}\n\nfunction isQuietHoursPatch(value: unknown): value is OwnerQuietHours {\n  return isQuietHours(value);\n}\n\ninterface NormalizedPatch {\n  strings: Partial<\n    Record<\n      | \"preferredName\"\n      | \"relationshipStatus\"\n      | \"partnerName\"\n      | \"orientation\"\n      | \"gender\"\n      | \"age\"\n      | \"location\"\n      | \"travelBookingPreferences\"\n      | \"preferredNotificationChannel\"\n      | \"locale\"\n      | \"timezone\",\n      string\n    >\n  >;\n  morningWindow?: OwnerFactWindow;\n  eveningWindow?: OwnerFactWindow;\n  quietHours?: OwnerQuietHours;\n}\n\nfunction normalizePatch(patch: OwnerFactsPatch): NormalizedPatch {\n  const strings: NormalizedPatch[\"strings\"] = {};\n  const result: NormalizedPatch = { strings };\n  const stringFields = [\n    \"preferredName\",\n    \"relationshipStatus\",\n    \"partnerName\",\n    \"orientation\",\n    \"gender\",\n    \"age\",\n    \"location\",\n    \"travelBookingPreferences\",\n    \"preferredNotificationChannel\",\n    \"locale\",\n    \"timezone\",\n  ] as const;\n  for (const field of stringFields) {\n    const value = patch[field];\n    if (typeof value === \"string\") {\n      const trimmed = trimNonEmpty(value);\n      if (trimmed) {\n        strings[field] = trimmed;\n      }\n    }\n  }\n  if (isWindowPatch(patch.morningWindow)) {\n    result.morningWindow = {\n      startLocal: patch.morningWindow.startLocal,\n      endLocal: patch.morningWindow.endLocal,\n    };\n  }\n  if (isWindowPatch(patch.eveningWindow)) {\n    result.eveningWindow = {\n      startLocal: patch.eveningWindow.startLocal,\n      endLocal: patch.eveningWindow.endLocal,\n    };\n  }\n  if (isQuietHoursPatch(patch.quietHours)) {\n    result.quietHours = {\n      startLocal: patch.quietHours.startLocal,\n      endLocal: patch.quietHours.endLocal,\n      timezone: patch.quietHours.timezone,\n    };\n  }\n  return result;\n}\n\n// --- Implementation -------------------------------------------------------\n\nconst LEGACY_PROFILE_FIELD_MAP = {\n  preferredName: \"name\",\n  relationshipStatus: \"relationshipStatus\",\n  partnerName: \"partnerName\",\n  orientation: \"orientation\",\n  gender: \"gender\",\n  age: \"age\",\n  location: \"location\",\n  travelBookingPreferences: \"travelBookingPreferences\",\n} as const;\n\ntype FactStringField = keyof typeof LEGACY_PROFILE_FIELD_MAP;\n\nfunction buildLegacyProfilePatch(\n  strings: NormalizedPatch[\"strings\"],\n): LifeOpsOwnerProfilePatch {\n  const legacyPatch: LifeOpsOwnerProfilePatch = {};\n  for (const [factField, profileField] of Object.entries(\n    LEGACY_PROFILE_FIELD_MAP,\n  ) as Array<\n    [FactStringField, (typeof LEGACY_PROFILE_FIELD_MAP)[FactStringField]]\n  >) {\n    const value = strings[factField];\n    if (typeof value === \"string\") {\n      legacyPatch[profileField] = value;\n    }\n  }\n  return legacyPatch;\n}\n\nclass CacheBackedOwnerFactStore implements OwnerFactStore {\n  constructor(private readonly runtime: IAgentRuntime) {}\n\n  async read(): Promise<OwnerFacts> {\n    const record = await this.readRecord();\n    return cloneFacts(record.facts);\n  }\n\n  async update(\n    patch: OwnerFactsPatch,\n    provenance: OwnerFactProvenance,\n  ): Promise<OwnerFacts> {\n    const normalized = normalizePatch(patch);\n    const hasStringPatch = Object.keys(normalized.strings).length > 0;\n    if (\n      !hasStringPatch &&\n      !normalized.morningWindow &&\n      !normalized.eveningWindow &&\n      !normalized.quietHours\n    ) {\n      const current = await this.read();\n      return current;\n    }\n\n    const record = await this.readRecord();\n    const next = cloneFacts(record.facts);\n\n    const stringFields = [\n      \"preferredName\",\n      \"relationshipStatus\",\n      \"partnerName\",\n      \"orientation\",\n      \"gender\",\n      \"age\",\n      \"location\",\n      \"travelBookingPreferences\",\n      \"preferredNotificationChannel\",\n      \"locale\",\n      \"timezone\",\n    ] as const;\n    for (const field of stringFields) {\n      const value = normalized.strings[field];\n      if (typeof value === \"string\") {\n        next[field] = { value, provenance: { ...provenance } };\n      }\n    }\n    if (normalized.morningWindow) {\n      next.morningWindow = {\n        value: { ...normalized.morningWindow },\n        provenance: { ...provenance },\n      };\n    }\n    if (normalized.eveningWindow) {\n      next.eveningWindow = {\n        value: { ...normalized.eveningWindow },\n        provenance: { ...provenance },\n      };\n    }\n    if (normalized.quietHours) {\n      next.quietHours = {\n        value: { ...normalized.quietHours },\n        provenance: { ...provenance },\n      };\n    }\n\n    await this.writeRecord({ schemaVersion: 1, facts: next });\n\n    // Mirror identity-string fields onto the legacy LifeOpsOwnerProfile so\n    // existing readers (calendar mixin, lifeops provider, memory test)\n    // stay consistent. The mirror is best-effort: writing the canonical\n    // store has already succeeded.\n    if (hasStringPatch) {\n      const legacyPatch = buildLegacyProfilePatch(normalized.strings);\n      if (Object.keys(legacyPatch).length > 0) {\n        await updateLifeOpsOwnerProfile(this.runtime, legacyPatch);\n      }\n      const namePatch = normalized.strings.preferredName;\n      if (typeof namePatch === \"string\") {\n        await persistConfiguredOwnerName(namePatch);\n      }\n    }\n\n    return cloneFacts(next);\n  }\n\n  async setReminderIntensity(\n    patch: PolicyPatchReminderIntensity,\n    provenance: OwnerFactProvenance,\n  ): Promise<OwnerFacts> {\n    if (!isReminderIntensity(patch.intensity)) {\n      throw new Error(\n        `Unsupported reminder intensity \"${String(patch.intensity)}\"`,\n      );\n    }\n    const record = await this.readRecord();\n    const next = cloneFacts(record.facts);\n    const policyProvenance: OwnerFactProvenance = patch.note\n      ? { ...provenance, note: patch.note }\n      : { ...provenance };\n    next.reminderIntensity = {\n      value: patch.intensity,\n      provenance: policyProvenance,\n    };\n    await this.writeRecord({ schemaVersion: 1, facts: next });\n    return cloneFacts(next);\n  }\n\n  async upsertEscalationRule(\n    patch: PolicyPatchEscalationRule,\n    provenance: OwnerFactProvenance,\n  ): Promise<OwnerFacts> {\n    const rule = normalizeEscalationRule(patch.rule);\n    if (!rule) {\n      throw new Error(\n        \"Escalation rule requires timeoutMinutes or callAfterMinutes\",\n      );\n    }\n    const record = await this.readRecord();\n    const next = cloneFacts(record.facts);\n    const existing = next.escalationRules?.value ?? [];\n    const filtered = existing.filter(\n      (r) => r.definitionId !== rule.definitionId,\n    );\n    filtered.push(rule);\n    const policyProvenance: OwnerFactProvenance = patch.note\n      ? { ...provenance, note: patch.note }\n      : { ...provenance };\n    next.escalationRules = {\n      value: filtered,\n      provenance: policyProvenance,\n    };\n    await this.writeRecord({ schemaVersion: 1, facts: next });\n    return cloneFacts(next);\n  }\n\n  private async readRecord(): Promise<PersistedRecord> {\n    const cache = asCacheRuntime(this.runtime);\n    const stored = await cache.getCache<PersistedRecord>(FACT_STORE_CACHE_KEY);\n    return normalizeRecord(stored);\n  }\n\n  private async writeRecord(record: PersistedRecord): Promise<void> {\n    const cache = asCacheRuntime(this.runtime);\n    await cache.setCache<PersistedRecord>(FACT_STORE_CACHE_KEY, record);\n  }\n}\n\nfunction cloneFacts(facts: OwnerFacts): OwnerFacts {\n  const next: OwnerFacts = {};\n  if (facts.preferredName) {\n    next.preferredName = cloneStringEntry(facts.preferredName);\n  }\n  if (facts.relationshipStatus) {\n    next.relationshipStatus = cloneStringEntry(facts.relationshipStatus);\n  }\n  if (facts.partnerName) {\n    next.partnerName = cloneStringEntry(facts.partnerName);\n  }\n  if (facts.orientation) {\n    next.orientation = cloneStringEntry(facts.orientation);\n  }\n  if (facts.gender) next.gender = cloneStringEntry(facts.gender);\n  if (facts.age) next.age = cloneStringEntry(facts.age);\n  if (facts.location) next.location = cloneStringEntry(facts.location);\n  if (facts.travelBookingPreferences) {\n    next.travelBookingPreferences = cloneStringEntry(\n      facts.travelBookingPreferences,\n    );\n  }\n  if (facts.morningWindow) {\n    next.morningWindow = cloneWindowEntry(facts.morningWindow);\n  }\n  if (facts.eveningWindow) {\n    next.eveningWindow = cloneWindowEntry(facts.eveningWindow);\n  }\n  if (facts.quietHours) {\n    next.quietHours = cloneQuietHoursEntry(facts.quietHours);\n  }\n  if (facts.preferredNotificationChannel) {\n    next.preferredNotificationChannel = cloneStringEntry(\n      facts.preferredNotificationChannel,\n    );\n  }\n  if (facts.locale) next.locale = cloneStringEntry(facts.locale);\n  if (facts.timezone) next.timezone = cloneStringEntry(facts.timezone);\n  if (facts.reminderIntensity) {\n    next.reminderIntensity = {\n      value: facts.reminderIntensity.value,\n      provenance: { ...facts.reminderIntensity.provenance },\n    };\n  }\n  if (facts.escalationRules) {\n    next.escalationRules = {\n      value: facts.escalationRules.value.map((rule) => ({ ...rule })),\n      provenance: { ...facts.escalationRules.provenance },\n    };\n  }\n  return next;\n}\n\nfunction cloneStringEntry(\n  entry: OwnerFactEntry<string>,\n): OwnerFactEntry<string> {\n  return { value: entry.value, provenance: { ...entry.provenance } };\n}\n\nfunction cloneWindowEntry(\n  entry: OwnerFactEntry<OwnerFactWindow>,\n): OwnerFactEntry<OwnerFactWindow> {\n  return {\n    value: { ...entry.value },\n    provenance: { ...entry.provenance },\n  };\n}\n\nfunction cloneQuietHoursEntry(\n  entry: OwnerFactEntry<OwnerQuietHours>,\n): OwnerFactEntry<OwnerQuietHours> {\n  return {\n    value: { ...entry.value },\n    provenance: { ...entry.provenance },\n  };\n}\n\n// --- Public factory -------------------------------------------------------\n\nexport function createOwnerFactStore(runtime: IAgentRuntime): OwnerFactStore {\n  return new CacheBackedOwnerFactStore(runtime);\n}\n\n// --- Runtime registration -------------------------------------------------\n\nconst STORE_KEY = Symbol.for(\"@elizaos/plugin-personal-assistant:owner-fact-store\");\n\ninterface FactStoreHostRuntime extends IAgentRuntime {\n  [STORE_KEY]?: OwnerFactStore;\n}\n\nexport function registerOwnerFactStore(\n  runtime: IAgentRuntime,\n  store: OwnerFactStore,\n): void {\n  (runtime as FactStoreHostRuntime)[STORE_KEY] = store;\n}\n\nexport function getOwnerFactStore(\n  runtime: IAgentRuntime,\n): OwnerFactStore | null {\n  return (runtime as FactStoreHostRuntime)[STORE_KEY] ?? null;\n}\n\n/**\n * Resolve the registered store, falling back to a fresh instance when the\n * registry slot is empty (e.g. tests instantiating services without going\n * through `plugin.init`). Either way the underlying cache is the same, so\n * facts persist across the boundary.\n */\nexport function resolveOwnerFactStore(runtime: IAgentRuntime): OwnerFactStore {\n  return getOwnerFactStore(runtime) ?? createOwnerFactStore(runtime);\n}\n\n// --- Convenience views ----------------------------------------------------\n\n/**\n * Reduces a typed `OwnerFacts` record to the minimal `OwnerFactsView`\n * surface consumed by the `ScheduledTask` runner (gates and completion\n * checks). Provenance is intentionally dropped — readers want the value.\n */\nexport function ownerFactsToView(\n  facts: OwnerFacts,\n): import(\"@elizaos/plugin-scheduling\").OwnerFactsView {\n  const view: import(\"@elizaos/plugin-scheduling\").OwnerFactsView = {};\n  if (facts.preferredName) view.preferredName = facts.preferredName.value;\n  if (facts.timezone) view.timezone = facts.timezone.value;\n  if (facts.locale) view.locale = facts.locale.value;\n  if (facts.morningWindow) {\n    view.morningWindow = {\n      start: facts.morningWindow.value.startLocal,\n      end: facts.morningWindow.value.endLocal,\n    };\n  }\n  if (facts.eveningWindow) {\n    view.eveningWindow = {\n      start: facts.eveningWindow.value.startLocal,\n      end: facts.eveningWindow.value.endLocal,\n    };\n  }\n  if (facts.quietHours) {\n    view.quietHours = {\n      start: facts.quietHours.value.startLocal,\n      end: facts.quietHours.value.endLocal,\n      tz: facts.quietHours.value.timezone,\n    };\n  }\n  return view;\n}\n"],"mappings":"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","names":[]}

package/dist/lifeops/owner/profile-extraction-evaluator.d.ts

@@ -0,0 +1,3 @@
+import type { ResponseHandlerEvaluator } from "@elizaos/core";
+export declare const ownerProfileExtractionEvaluator: ResponseHandlerEvaluator;
+//# sourceMappingURL=profile-extraction-evaluator.d.ts.map

package/dist/lifeops/owner/profile-extraction-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-extraction-evaluator.d.ts","sourceRoot":"","sources":["../../../src/lifeops/owner/profile-extraction-evaluator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,wBAAwB,EAEzB,MAAM,eAAe,CAAC;AA2NvB,eAAO,MAAM,+BAA+B,EAAE,wBAuF7C,CAAC"}

package/dist/lifeops/owner/profile-extraction-evaluator.js

@@ -0,0 +1,241 @@
+import { hasOwnerAccess, resolveKnowledgeGraphService } from "@elizaos/agent";
+import { SELF_ENTITY_ID } from "../entities/types.js";
+import {
+  createOwnerFactStore
+} from "../owner/fact-store.js";
+import {
+  applyExtractedEdges
+} from "../relationships/extraction.js";
+const FACT_PATTERNS = [
+  {
+    key: "preferredName",
+    pattern: /\b(?:my name is|people call me|you can call me)\s+([^,.!?]{2,60})/iu
+  },
+  {
+    key: "preferredName",
+    pattern: /\bcall me\s+(?!at\b|on\b)([^,.!?]{2,60})/iu
+  },
+  {
+    key: "location",
+    pattern: /\b(?:i live in|i'm in|i am in|my location is)\s+([^,.!?]{2,80})/iu
+  },
+  {
+    key: "timezone",
+    pattern: /\bmy timezone is\s+([A-Za-z0-9_/+.-]{2,60})/iu
+  },
+  {
+    key: "partnerName",
+    pattern: /\bmy partner(?:'s name)? is\s+([^,.!?]{2,60})/iu
+  }
+];
+const TRAVEL_PREFERENCE_CONTEXT = /\b(?:travel|booking|bookings|trip|trips|flight|flights|hotel|hotels)\b/iu;
+const TRAVEL_PREFERENCE_DETAILS = /\b(?:aisle|window|seat|seats|checked\s+bag|checked\s+bags|carry-?on|luggage|hotel|hotels|budget|\$\d|venue|venues|mile|miles|night|nights)\b/iu;
+const RELATIONSHIP_TYPES = {
+  boss: "managed_by",
+  manager: "managed_by",
+  partner: "partner_of",
+  spouse: "partner_of",
+  colleague: "colleague_of",
+  coworker: "colleague_of",
+  teammate: "colleague_of",
+  friend: "knows"
+};
+function messageText(value) {
+  if (!value || typeof value !== "object") return "";
+  const content = value.content;
+  if (!content || typeof content !== "object") return "";
+  const text = content.text;
+  return typeof text === "string" ? text : "";
+}
+function cleanName(raw) {
+  const value = raw?.replace(/["'`]/g, "").replace(/\s+/g, " ").trim();
+  if (!value || value.length < 2 || value.length > 80) return null;
+  if (/^(?:me|my|mine|you|them|someone|somebody|at|on)$/iu.test(value)) {
+    return null;
+  }
+  return value;
+}
+function cleanHandle(raw) {
+  const value = raw?.trim().replace(/[),.;!?]+$/u, "");
+  if (!value || value.length < 2 || value.length > 120) return null;
+  return value;
+}
+function normalizePlatform(raw) {
+  const normalized = raw.trim().toLowerCase();
+  if (normalized === "twitter") return "x";
+  return normalized;
+}
+function collectFactHints(text, facts) {
+  for (const entry of FACT_PATTERNS) {
+    const match = entry.pattern.exec(text);
+    const value = cleanName(match?.[1]);
+    if (value) {
+      facts[entry.key] = value;
+    }
+  }
+}
+function cleanTravelPreference(raw) {
+  const value = raw?.replace(/\s+/g, " ").replace(/^[\s:,-]+/u, "").replace(/[.!?]+$/u, "").trim();
+  if (!value || value.length < 8) {
+    return null;
+  }
+  const withoutLeadIn = value.replace(/^(?:that\s+)?(?:i\s+)?prefer\s+/iu, "").trim();
+  if (!TRAVEL_PREFERENCE_DETAILS.test(withoutLeadIn)) {
+    return null;
+  }
+  const normalized = withoutLeadIn.replace(
+    /^(.)/u,
+    (first) => first.toUpperCase()
+  );
+  return `Prefer ${normalized}`;
+}
+function collectTravelPreferenceHints(text, facts) {
+  if (facts.travelBookingPreferences || !/\bprefer(?:ence|ences|s|red)?\b/iu.test(text) || !TRAVEL_PREFERENCE_CONTEXT.test(text)) {
+    return;
+  }
+  const patterns = [
+    /\b(?:for\s+(?:all\s+)?future\s+travel\s+bookings?|for\s+travel\s+bookings?|when\s+booking\s+travel)[:,-]?\s*((?:i\s+)?prefer\s+[^.!?]{8,240})/iu,
+    /\b(?:travel|booking|flight|hotel)\s+preferences?\s*(?:are|is|:|-)\s*([^.!?]{8,240})/iu,
+    /\b(?:remember\s+that\s+)?((?:i\s+)?prefer\s+[^.!?]{8,240})/iu
+  ];
+  for (const pattern of patterns) {
+    const preference = cleanTravelPreference(pattern.exec(text)?.[1]);
+    if (preference) {
+      facts.travelBookingPreferences = preference;
+      return;
+    }
+  }
+}
+function collectIdentityHints(text) {
+  const hints = [];
+  const patterns = [
+    /\b([A-Z][A-Za-z0-9 .'-]{1,60})'s\s+(telegram|slack|discord|twitter|x|email|github|nostr)\s+(?:handle|username|account|profile)\s+is\s+(@?[A-Za-z0-9_.+\-@]+)\b/gu,
+    /\b(?:the\s+)?(telegram|slack|discord|twitter|x|email|github|nostr)\s+(?:handle|username|account|profile)\s+for\s+([A-Z][A-Za-z0-9 .'-]{1,60})\s+is\s+(@?[A-Za-z0-9_.+\-@]+)\b/gu,
+    /\b([A-Z][A-Za-z0-9 .'-]{1,60})\s+(?:goes by|is)\s+(@[A-Za-z0-9_.+-]+)\s+on\s+(telegram|slack|discord|twitter|x|github|nostr)\b/gu
+  ];
+  for (const pattern of patterns) {
+    for (const match of text.matchAll(pattern)) {
+      const first = match[1] ?? "";
+      const second = match[2] ?? "";
+      const third = match[3] ?? "";
+      const platformFirst = /^(telegram|slack|discord|twitter|x|email|github|nostr)$/iu.test(first);
+      const name = cleanName(platformFirst ? second : first);
+      const platform = normalizePlatform(
+        platformFirst ? first : third || second
+      );
+      const handle = cleanHandle(platformFirst ? third : second);
+      if (name && platform && handle) {
+        hints.push({ name, platform, handle });
+      }
+    }
+  }
+  return hints;
+}
+function collectRelationshipHints(text) {
+  const hints = [];
+  const pattern = /\b([A-Z][A-Za-z0-9 .'-]{1,60})\s+is\s+my\s+(boss|manager|partner|spouse|colleague|coworker|teammate|friend)\b/gu;
+  for (const match of text.matchAll(pattern)) {
+    const name = cleanName(match[1]);
+    const role = (match[2] ?? "").toLowerCase();
+    const type = RELATIONSHIP_TYPES[role];
+    if (name && type) {
+      hints.push({ name, type });
+    }
+  }
+  return hints;
+}
+function extractProfileDetails(text) {
+  const facts = {};
+  collectFactHints(text, facts);
+  collectTravelPreferenceHints(text, facts);
+  return {
+    facts,
+    identities: collectIdentityHints(text),
+    relationships: collectRelationshipHints(text)
+  };
+}
+function hasExtraction(extraction) {
+  return Object.keys(extraction.facts).length > 0 || extraction.identities.length > 0 || extraction.relationships.length > 0;
+}
+const ownerProfileExtractionEvaluator = {
+  name: "owner.profile_extraction",
+  description: "Extract stable owner facts, nicknames, handles, relationship aliases before planning.",
+  priority: 30,
+  async shouldRun({ runtime, message }) {
+    if (!await hasOwnerAccess(runtime, message)) {
+      return false;
+    }
+    return hasExtraction(extractProfileDetails(messageText(message)));
+  },
+  async evaluate({
+    runtime,
+    message
+  }) {
+    const text = messageText(message);
+    const extraction = extractProfileDetails(text);
+    if (!hasExtraction(extraction)) {
+      return void 0;
+    }
+    const evidenceId = `message:${String(message.id ?? Date.now())}`;
+    const recordedAt = (/* @__PURE__ */ new Date()).toISOString();
+    const debug = [];
+    if (Object.keys(extraction.facts).length > 0) {
+      await createOwnerFactStore(runtime).update(extraction.facts, {
+        source: "agent_inferred",
+        recordedAt,
+        note: `response-handler extraction from ${evidenceId}`
+      });
+      debug.push(`facts=${Object.keys(extraction.facts).length}`);
+    }
+    if (extraction.identities.length > 0 || extraction.relationships.length > 0) {
+      const agentId = runtime.agentId;
+      const knowledgeGraph = resolveKnowledgeGraphService(runtime);
+      if (!knowledgeGraph) {
+        throw new Error(
+          "[owner.profile_extraction] KnowledgeGraphService is not registered on the runtime"
+        );
+      }
+      const entityStore = knowledgeGraph.getEntityStore(agentId);
+      const relationshipStore = knowledgeGraph.getRelationshipStore(agentId);
+      for (const identity of extraction.identities) {
+        await entityStore.observeIdentity({
+          platform: identity.platform,
+          handle: identity.handle,
+          displayName: identity.name,
+          evidence: [evidenceId],
+          confidence: 0.76,
+          suggestedType: "person"
+        });
+      }
+      if (extraction.identities.length > 0) {
+        debug.push(`identities=${extraction.identities.length}`);
+      }
+      const edges = extraction.relationships.map((hint) => ({
+        fromRef: { id: SELF_ENTITY_ID },
+        toRef: { name: hint.name, type: "person" },
+        type: hint.type,
+        confidence: 0.74
+      }));
+      if (edges.length > 0) {
+        await applyExtractedEdges({
+          entityStore,
+          relationshipStore,
+          evidenceId,
+          edges,
+          source: "extraction"
+        });
+        debug.push(`relationships=${edges.length}`);
+      }
+    }
+    return {
+      debug,
+      addContextSlices: [
+        "Owner profile/entity details were extracted before planning."
+      ]
+    };
+  }
+};
+export {
+  ownerProfileExtractionEvaluator
+};
+//# sourceMappingURL=profile-extraction-evaluator.js.map

package/dist/lifeops/owner/profile-extraction-evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/owner/profile-extraction-evaluator.ts"],"sourcesContent":["import { hasOwnerAccess, resolveKnowledgeGraphService } from \"@elizaos/agent\";\nimport type {\n  ResponseHandlerEvaluator,\n  ResponseHandlerPatch,\n} from \"@elizaos/core\";\nimport { SELF_ENTITY_ID } from \"../entities/types.js\";\nimport {\n  createOwnerFactStore,\n  type OwnerFactsPatch,\n} from \"../owner/fact-store.js\";\nimport {\n  applyExtractedEdges,\n  type ExtractedEdge,\n} from \"../relationships/extraction.js\";\n\ntype IdentityHint = {\n  name: string;\n  platform: string;\n  handle: string;\n};\n\ntype RelationshipHint = {\n  name: string;\n  type: string;\n};\n\ntype ProfileExtraction = {\n  facts: OwnerFactsPatch;\n  identities: IdentityHint[];\n  relationships: RelationshipHint[];\n};\n\nconst FACT_PATTERNS = [\n  {\n    key: \"preferredName\",\n    pattern:\n      /\\b(?:my name is|people call me|you can call me)\\s+([^,.!?]{2,60})/iu,\n  },\n  {\n    key: \"preferredName\",\n    pattern: /\\bcall me\\s+(?!at\\b|on\\b)([^,.!?]{2,60})/iu,\n  },\n  {\n    key: \"location\",\n    pattern:\n      /\\b(?:i live in|i'm in|i am in|my location is)\\s+([^,.!?]{2,80})/iu,\n  },\n  {\n    key: \"timezone\",\n    pattern: /\\bmy timezone is\\s+([A-Za-z0-9_/+.-]{2,60})/iu,\n  },\n  {\n    key: \"partnerName\",\n    pattern: /\\bmy partner(?:'s name)? is\\s+([^,.!?]{2,60})/iu,\n  },\n] as const;\n\nconst TRAVEL_PREFERENCE_CONTEXT =\n  /\\b(?:travel|booking|bookings|trip|trips|flight|flights|hotel|hotels)\\b/iu;\nconst TRAVEL_PREFERENCE_DETAILS =\n  /\\b(?:aisle|window|seat|seats|checked\\s+bag|checked\\s+bags|carry-?on|luggage|hotel|hotels|budget|\\$\\d|venue|venues|mile|miles|night|nights)\\b/iu;\n\nconst RELATIONSHIP_TYPES: Record<string, string> = {\n  boss: \"managed_by\",\n  manager: \"managed_by\",\n  partner: \"partner_of\",\n  spouse: \"partner_of\",\n  colleague: \"colleague_of\",\n  coworker: \"colleague_of\",\n  teammate: \"colleague_of\",\n  friend: \"knows\",\n};\n\nfunction messageText(value: unknown): string {\n  if (!value || typeof value !== \"object\") return \"\";\n  const content = (value as { content?: unknown }).content;\n  if (!content || typeof content !== \"object\") return \"\";\n  const text = (content as { text?: unknown }).text;\n  return typeof text === \"string\" ? text : \"\";\n}\n\nfunction cleanName(raw: string | undefined): string | null {\n  const value = raw?.replace(/[\"'`]/g, \"\").replace(/\\s+/g, \" \").trim();\n  if (!value || value.length < 2 || value.length > 80) return null;\n  if (/^(?:me|my|mine|you|them|someone|somebody|at|on)$/iu.test(value)) {\n    return null;\n  }\n  return value;\n}\n\nfunction cleanHandle(raw: string | undefined): string | null {\n  const value = raw?.trim().replace(/[),.;!?]+$/u, \"\");\n  if (!value || value.length < 2 || value.length > 120) return null;\n  return value;\n}\n\nfunction normalizePlatform(raw: string): string {\n  const normalized = raw.trim().toLowerCase();\n  if (normalized === \"twitter\") return \"x\";\n  return normalized;\n}\n\nfunction collectFactHints(text: string, facts: OwnerFactsPatch): void {\n  for (const entry of FACT_PATTERNS) {\n    const match = entry.pattern.exec(text);\n    const value = cleanName(match?.[1]);\n    if (value) {\n      facts[entry.key] = value;\n    }\n  }\n}\n\nfunction cleanTravelPreference(raw: string | undefined): string | null {\n  const value = raw\n    ?.replace(/\\s+/g, \" \")\n    .replace(/^[\\s:,-]+/u, \"\")\n    .replace(/[.!?]+$/u, \"\")\n    .trim();\n  if (!value || value.length < 8) {\n    return null;\n  }\n\n  const withoutLeadIn = value\n    .replace(/^(?:that\\s+)?(?:i\\s+)?prefer\\s+/iu, \"\")\n    .trim();\n  if (!TRAVEL_PREFERENCE_DETAILS.test(withoutLeadIn)) {\n    return null;\n  }\n\n  const normalized = withoutLeadIn.replace(/^(.)/u, (first) =>\n    first.toUpperCase(),\n  );\n  return `Prefer ${normalized}`;\n}\n\nfunction collectTravelPreferenceHints(\n  text: string,\n  facts: OwnerFactsPatch,\n): void {\n  if (\n    facts.travelBookingPreferences ||\n    !/\\bprefer(?:ence|ences|s|red)?\\b/iu.test(text) ||\n    !TRAVEL_PREFERENCE_CONTEXT.test(text)\n  ) {\n    return;\n  }\n\n  const patterns = [\n    /\\b(?:for\\s+(?:all\\s+)?future\\s+travel\\s+bookings?|for\\s+travel\\s+bookings?|when\\s+booking\\s+travel)[:,-]?\\s*((?:i\\s+)?prefer\\s+[^.!?]{8,240})/iu,\n    /\\b(?:travel|booking|flight|hotel)\\s+preferences?\\s*(?:are|is|:|-)\\s*([^.!?]{8,240})/iu,\n    /\\b(?:remember\\s+that\\s+)?((?:i\\s+)?prefer\\s+[^.!?]{8,240})/iu,\n  ];\n\n  for (const pattern of patterns) {\n    const preference = cleanTravelPreference(pattern.exec(text)?.[1]);\n    if (preference) {\n      facts.travelBookingPreferences = preference;\n      return;\n    }\n  }\n}\n\nfunction collectIdentityHints(text: string): IdentityHint[] {\n  const hints: IdentityHint[] = [];\n  const patterns = [\n    /\\b([A-Z][A-Za-z0-9 .'-]{1,60})'s\\s+(telegram|slack|discord|twitter|x|email|github|nostr)\\s+(?:handle|username|account|profile)\\s+is\\s+(@?[A-Za-z0-9_.+\\-@]+)\\b/gu,\n    /\\b(?:the\\s+)?(telegram|slack|discord|twitter|x|email|github|nostr)\\s+(?:handle|username|account|profile)\\s+for\\s+([A-Z][A-Za-z0-9 .'-]{1,60})\\s+is\\s+(@?[A-Za-z0-9_.+\\-@]+)\\b/gu,\n    /\\b([A-Z][A-Za-z0-9 .'-]{1,60})\\s+(?:goes by|is)\\s+(@[A-Za-z0-9_.+-]+)\\s+on\\s+(telegram|slack|discord|twitter|x|github|nostr)\\b/gu,\n  ];\n  for (const pattern of patterns) {\n    for (const match of text.matchAll(pattern)) {\n      const first = match[1] ?? \"\";\n      const second = match[2] ?? \"\";\n      const third = match[3] ?? \"\";\n      const platformFirst =\n        /^(telegram|slack|discord|twitter|x|email|github|nostr)$/iu.test(first);\n      const name = cleanName(platformFirst ? second : first);\n      const platform = normalizePlatform(\n        platformFirst ? first : third || second,\n      );\n      const handle = cleanHandle(platformFirst ? third : second);\n      if (name && platform && handle) {\n        hints.push({ name, platform, handle });\n      }\n    }\n  }\n  return hints;\n}\n\nfunction collectRelationshipHints(text: string): RelationshipHint[] {\n  const hints: RelationshipHint[] = [];\n  const pattern =\n    /\\b([A-Z][A-Za-z0-9 .'-]{1,60})\\s+is\\s+my\\s+(boss|manager|partner|spouse|colleague|coworker|teammate|friend)\\b/gu;\n  for (const match of text.matchAll(pattern)) {\n    const name = cleanName(match[1]);\n    const role = (match[2] ?? \"\").toLowerCase();\n    const type = RELATIONSHIP_TYPES[role];\n    if (name && type) {\n      hints.push({ name, type });\n    }\n  }\n  return hints;\n}\n\nfunction extractProfileDetails(text: string): ProfileExtraction {\n  const facts: OwnerFactsPatch = {};\n  collectFactHints(text, facts);\n  collectTravelPreferenceHints(text, facts);\n  return {\n    facts,\n    identities: collectIdentityHints(text),\n    relationships: collectRelationshipHints(text),\n  };\n}\n\nfunction hasExtraction(extraction: ProfileExtraction): boolean {\n  return (\n    Object.keys(extraction.facts).length > 0 ||\n    extraction.identities.length > 0 ||\n    extraction.relationships.length > 0\n  );\n}\n\nexport const ownerProfileExtractionEvaluator: ResponseHandlerEvaluator = {\n  name: \"owner.profile_extraction\",\n  description:\n    \"Extract stable owner facts, nicknames, handles, relationship aliases before planning.\",\n  priority: 30,\n  async shouldRun({ runtime, message }) {\n    if (!(await hasOwnerAccess(runtime, message))) {\n      return false;\n    }\n    return hasExtraction(extractProfileDetails(messageText(message)));\n  },\n  async evaluate({\n    runtime,\n    message,\n  }): Promise<ResponseHandlerPatch | undefined> {\n    const text = messageText(message);\n    const extraction = extractProfileDetails(text);\n    if (!hasExtraction(extraction)) {\n      return undefined;\n    }\n\n    const evidenceId = `message:${String(message.id ?? Date.now())}`;\n    const recordedAt = new Date().toISOString();\n    const debug: string[] = [];\n\n    if (Object.keys(extraction.facts).length > 0) {\n      await createOwnerFactStore(runtime).update(extraction.facts, {\n        source: \"agent_inferred\",\n        recordedAt,\n        note: `response-handler extraction from ${evidenceId}`,\n      });\n      debug.push(`facts=${Object.keys(extraction.facts).length}`);\n    }\n\n    if (\n      extraction.identities.length > 0 ||\n      extraction.relationships.length > 0\n    ) {\n      const agentId = runtime.agentId;\n      const knowledgeGraph = resolveKnowledgeGraphService(runtime);\n      if (!knowledgeGraph) {\n        throw new Error(\n          \"[owner.profile_extraction] KnowledgeGraphService is not registered on the runtime\",\n        );\n      }\n      const entityStore = knowledgeGraph.getEntityStore(agentId);\n      const relationshipStore = knowledgeGraph.getRelationshipStore(agentId);\n\n      for (const identity of extraction.identities) {\n        await entityStore.observeIdentity({\n          platform: identity.platform,\n          handle: identity.handle,\n          displayName: identity.name,\n          evidence: [evidenceId],\n          confidence: 0.76,\n          suggestedType: \"person\",\n        });\n      }\n      if (extraction.identities.length > 0) {\n        debug.push(`identities=${extraction.identities.length}`);\n      }\n\n      const edges: ExtractedEdge[] = extraction.relationships.map((hint) => ({\n        fromRef: { id: SELF_ENTITY_ID },\n        toRef: { name: hint.name, type: \"person\" },\n        type: hint.type,\n        confidence: 0.74,\n      }));\n      if (edges.length > 0) {\n        await applyExtractedEdges({\n          entityStore,\n          relationshipStore,\n          evidenceId,\n          edges,\n          source: \"extraction\",\n        });\n        debug.push(`relationships=${edges.length}`);\n      }\n    }\n\n    return {\n      debug,\n      addContextSlices: [\n        \"Owner profile/entity details were extracted before planning.\",\n      ],\n    };\n  },\n};\n"],"mappings":"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","names":[]}

package/dist/lifeops/owner-profile.d.ts

@@ -0,0 +1,61 @@
+import type { IAgentRuntime } from "@elizaos/core";
+export declare const OWNER_NAME_MAX_LENGTH = 60;
+export declare const LIFEOPS_OWNER_PROFILE_FIELDS: readonly ["name", "relationshipStatus", "partnerName", "orientation", "gender", "age", "location", "travelBookingPreferences", "morningCheckinTime", "nightCheckinTime"];
+export type LifeOpsOwnerProfileField = (typeof LIFEOPS_OWNER_PROFILE_FIELDS)[number];
+export type LifeOpsOwnerProfilePatch = Partial<Record<LifeOpsOwnerProfileField, string>>;
+export type LifeOpsOwnerProfile = Record<LifeOpsOwnerProfileField, string> & {
+    updatedAt: string | null;
+};
+export declare function normalizeLifeOpsOwnerProfilePatch(patch: Record<string, unknown> | LifeOpsOwnerProfilePatch | null | undefined): LifeOpsOwnerProfilePatch;
+export declare function fetchConfiguredOwnerName(): Promise<string | null>;
+export declare function persistConfiguredOwnerName(name: string): Promise<boolean>;
+export declare function resolveLifeOpsOwnerProfile(metadata: Record<string, unknown> | null | undefined, configuredName?: string | null): LifeOpsOwnerProfile;
+export declare function readLifeOpsOwnerProfile(runtime: IAgentRuntime): Promise<LifeOpsOwnerProfile>;
+export interface LifeOpsCalendarFeedPreferences {
+    calendarFeedIncludes: Record<string, boolean>;
+    updatedAt: string | null;
+}
+/**
+ * Preference key for a calendar under a specific account grant. Google returns
+ * `calendarId: "primary"` for every account's primary calendar, so keying on
+ * `calendarId` alone would collide across multi-account users. The grantId
+ * disambiguates the account.
+ */
+export declare function calendarFeedPreferenceKey(grantId: string, calendarId: string): string;
+export interface CalendarFeedPreferenceIdentifier {
+    grantId: string;
+    calendarId: string;
+}
+export declare function readLifeOpsCalendarFeedPreferences(runtime: IAgentRuntime): Promise<LifeOpsCalendarFeedPreferences>;
+export declare function ensureLifeOpsCalendarFeedIncludes(runtime: IAgentRuntime, identifiers: readonly CalendarFeedPreferenceIdentifier[]): Promise<LifeOpsCalendarFeedPreferences>;
+export declare function setLifeOpsCalendarFeedIncluded(runtime: IAgentRuntime, identifier: CalendarFeedPreferenceIdentifier, included: boolean): Promise<LifeOpsCalendarFeedPreferences>;
+/**
+ * Meeting preferences — stored alongside the owner profile in the LifeOps
+ * scheduler task's metadata. Consumed by scheduling-with-others actions to
+ * propose candidate slots that respect the owner's working hours, blackout
+ * windows (e.g. lunch, focus blocks), and travel buffer.
+ */
+export interface LifeOpsMeetingPreferencesBlackout {
+    label: string;
+    /** Local time-of-day in "HH:MM" 24h format (inclusive). */
+    startLocal: string;
+    /** Local time-of-day in "HH:MM" 24h format (exclusive). */
+    endLocal: string;
+    /** 0=Sun..6=Sat. Omit for every day. */
+    daysOfWeek?: number[];
+}
+export interface LifeOpsMeetingPreferences {
+    timeZone: string;
+    preferredStartLocal: string;
+    preferredEndLocal: string;
+    defaultDurationMinutes: number;
+    travelBufferMinutes: number;
+    blackoutWindows: LifeOpsMeetingPreferencesBlackout[];
+    updatedAt: string | null;
+}
+export type LifeOpsMeetingPreferencesPatch = Partial<Omit<LifeOpsMeetingPreferences, "updatedAt">>;
+export declare function normalizeLifeOpsMeetingPreferencesPatch(patch: Record<string, unknown> | LifeOpsMeetingPreferencesPatch | null | undefined): LifeOpsMeetingPreferencesPatch;
+export declare function readLifeOpsMeetingPreferences(runtime: IAgentRuntime): Promise<LifeOpsMeetingPreferences>;
+export declare function updateLifeOpsMeetingPreferences(runtime: IAgentRuntime, patch: LifeOpsMeetingPreferencesPatch | Record<string, unknown>): Promise<LifeOpsMeetingPreferences | null>;
+export declare function updateLifeOpsOwnerProfile(runtime: IAgentRuntime, patch: LifeOpsOwnerProfilePatch | Record<string, unknown>): Promise<LifeOpsOwnerProfile | null>;
+//# sourceMappingURL=owner-profile.d.ts.map

package/dist/lifeops/owner-profile.d.ts.map

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