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

package/dist/lifeops/relationships/extraction.js

@@ -0,0 +1,146 @@
+import { SELF_ENTITY_ID } from "../entities/types.js";
+async function applyExtractedEdges(args) {
+  const resolved = /* @__PURE__ */ new Map();
+  const provenance = {
+    [args.evidenceId]: { entityIds: [], relationshipIds: [] }
+  };
+  const refKey = (ref) => {
+    if (ref.id) return `id:${ref.id}`;
+    if (ref.identity) {
+      return `id_${ref.identity.platform}:${ref.identity.handle}`;
+    }
+    if (ref.name)
+      return `name:${ref.name.toLowerCase()}|type:${ref.type ?? "person"}`;
+    return "unknown";
+  };
+  const resolveRef = async (ref) => {
+    const key = refKey(ref);
+    const cached = resolved.get(key);
+    if (cached) return cached;
+    if (ref.id === SELF_ENTITY_ID) {
+      const self = await args.entityStore.ensureSelf();
+      resolved.set(key, self);
+      return self;
+    }
+    if (ref.id) {
+      const existing = await args.entityStore.get(ref.id);
+      if (!existing) {
+        throw new Error(
+          `[applyExtractedEdges] entity id "${ref.id}" not found`
+        );
+      }
+      resolved.set(key, existing);
+      return existing;
+    }
+    if (ref.identity) {
+      const candidates = await args.entityStore.resolve({
+        identity: ref.identity,
+        type: ref.type ?? "person"
+      });
+      const first = candidates[0];
+      if (first) {
+        resolved.set(key, first.entity);
+        return first.entity;
+      }
+      const result = await args.entityStore.observeIdentity({
+        platform: ref.identity.platform,
+        handle: ref.identity.handle,
+        ...ref.name ? { displayName: ref.name } : {},
+        evidence: [args.evidenceId],
+        confidence: 0.7,
+        suggestedType: ref.type ?? "person"
+      });
+      resolved.set(key, result.entity);
+      return result.entity;
+    }
+    if (ref.name) {
+      const candidates = await args.entityStore.resolve({
+        name: ref.name,
+        type: ref.type ?? "person"
+      });
+      const exact = candidates.find(
+        (c) => c.entity.preferredName.toLowerCase() === ref.name?.toLowerCase()
+      );
+      if (exact) {
+        resolved.set(key, exact.entity);
+        return exact.entity;
+      }
+      const created = await args.entityStore.upsert({
+        type: ref.type ?? "person",
+        preferredName: ref.name,
+        identities: [],
+        tags: [],
+        visibility: "owner_agent_admin",
+        state: {}
+      });
+      resolved.set(key, created);
+      return created;
+    }
+    throw new Error(
+      "[applyExtractedEdges] entity ref has no identity, id, or name"
+    );
+  };
+  const edgePairs = [];
+  for (const edge of args.edges) {
+    const from = await resolveRef(edge.fromRef);
+    const to = await resolveRef(edge.toRef);
+    edgePairs.push({ from, to, edge });
+    provenance[args.evidenceId]?.entityIds.push(from.entityId, to.entityId);
+  }
+  const relationships = [];
+  for (const { from, to, edge } of edgePairs) {
+    const relationship = await args.relationshipStore.observe({
+      fromEntityId: from.entityId,
+      toEntityId: to.entityId,
+      type: edge.type,
+      ...edge.metadata ? { metadataPatch: edge.metadata } : {},
+      evidence: [args.evidenceId],
+      confidence: edge.confidence,
+      source: args.source ?? "extraction"
+    });
+    relationships.push(relationship);
+    provenance[args.evidenceId]?.relationshipIds.push(
+      relationship.relationshipId
+    );
+  }
+  const entityMap = /* @__PURE__ */ new Map();
+  for (const entity of resolved.values()) {
+    entityMap.set(entity.entityId, entity);
+  }
+  return {
+    entities: Array.from(entityMap.values()),
+    relationships,
+    provenance
+  };
+}
+function managerOfAtCompany(managerName, companyName, options = {}) {
+  const confidence = options.confidence ?? 0.85;
+  return [
+    {
+      fromRef: { id: SELF_ENTITY_ID },
+      toRef: { name: managerName, type: "person" },
+      type: "managed_by",
+      ...options.managerRole ? { metadata: { role: options.managerRole } } : {},
+      confidence
+    },
+    {
+      fromRef: { id: SELF_ENTITY_ID },
+      toRef: { name: companyName, type: "organization" },
+      type: "works_at",
+      ...options.selfRole ? { metadata: { role: options.selfRole } } : {},
+      confidence
+    },
+    {
+      fromRef: { name: managerName, type: "person" },
+      toRef: { name: companyName, type: "organization" },
+      type: "works_at",
+      ...options.managerRole ? { metadata: { role: options.managerRole } } : {},
+      confidence
+    }
+  ];
+}
+export {
+  applyExtractedEdges,
+  managerOfAtCompany
+};
+//# sourceMappingURL=extraction.js.map

package/dist/lifeops/relationships/extraction.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/relationships/extraction.ts"],"sourcesContent":["/**\n * Extraction helpers — the canonical entry point for \"ingest this\n * observation into the graph\". Tests verify these produce both nodes\n * and edges.\n *\n * Take an observation tuple (\"Pat is my manager at Acme\") and produce a\n * pair of (entities, edges) writes that the planner can apply\n * atomically. All writes carry full provenance (the source utterance is\n * the evidence id).\n */\n\nimport type { EntityStore } from \"../entities/store.js\";\nimport type { Entity } from \"../entities/types.js\";\nimport { SELF_ENTITY_ID } from \"../entities/types.js\";\nimport type { RelationshipStore } from \"./store.js\";\nimport type { Relationship, RelationshipSource } from \"./types.js\";\n\n/**\n * High-level extracted edge. The planner / chat ingest produces these\n * from natural-language observations; the runtime applies them via\n * `applyExtractedEdges`.\n */\nexport interface ExtractedEdge {\n  fromRef: ExtractedEntityRef;\n  toRef: ExtractedEntityRef;\n  type: string;\n  metadata?: Record<string, unknown>;\n  confidence: number;\n}\n\nexport interface ExtractedEntityRef {\n  /** `\"self\"`, an existing entityId, or a name to resolve. */\n  id?: string;\n  name?: string;\n  type?: string;\n  /** Identity hints to disambiguate same-named entities. */\n  identity?: { platform: string; handle: string };\n}\n\nexport interface ExtractionResult {\n  entities: Entity[];\n  relationships: Relationship[];\n  /** Evidence-id → list of (entityId, relationshipId) it touched. */\n  provenance: Record<\n    string,\n    { entityIds: string[]; relationshipIds: string[] }\n  >;\n}\n\n/**\n * Apply a batch of extracted edges. Resolves each entity ref to a\n * concrete Entity (creating it if needed), then strengthens or creates\n * each edge via `RelationshipStore.observe`.\n *\n * Always idempotent across re-runs of the same evidence id.\n */\nexport async function applyExtractedEdges(args: {\n  entityStore: EntityStore;\n  relationshipStore: RelationshipStore;\n  evidenceId: string;\n  edges: ExtractedEdge[];\n  source?: RelationshipSource;\n}): Promise<ExtractionResult> {\n  const resolved = new Map<string, Entity>();\n  const provenance: Record<\n    string,\n    { entityIds: string[]; relationshipIds: string[] }\n  > = {\n    [args.evidenceId]: { entityIds: [], relationshipIds: [] },\n  };\n\n  // First, resolve every entity reference. Cache by canonical key so\n  // multiple edges on the same entity reuse the same row.\n  const refKey = (ref: ExtractedEntityRef): string => {\n    if (ref.id) return `id:${ref.id}`;\n    if (ref.identity) {\n      return `id_${ref.identity.platform}:${ref.identity.handle}`;\n    }\n    if (ref.name)\n      return `name:${ref.name.toLowerCase()}|type:${ref.type ?? \"person\"}`;\n    return \"unknown\";\n  };\n\n  const resolveRef = async (ref: ExtractedEntityRef): Promise<Entity> => {\n    const key = refKey(ref);\n    const cached = resolved.get(key);\n    if (cached) return cached;\n\n    if (ref.id === SELF_ENTITY_ID) {\n      const self = await args.entityStore.ensureSelf();\n      resolved.set(key, self);\n      return self;\n    }\n\n    if (ref.id) {\n      const existing = await args.entityStore.get(ref.id);\n      if (!existing) {\n        throw new Error(\n          `[applyExtractedEdges] entity id \"${ref.id}\" not found`,\n        );\n      }\n      resolved.set(key, existing);\n      return existing;\n    }\n\n    if (ref.identity) {\n      const candidates = await args.entityStore.resolve({\n        identity: ref.identity,\n        type: ref.type ?? \"person\",\n      });\n      const first = candidates[0];\n      if (first) {\n        resolved.set(key, first.entity);\n        return first.entity;\n      }\n      // Create via observeIdentity so identity-merge logic runs.\n      const result = await args.entityStore.observeIdentity({\n        platform: ref.identity.platform,\n        handle: ref.identity.handle,\n        ...(ref.name ? { displayName: ref.name } : {}),\n        evidence: [args.evidenceId],\n        confidence: 0.7,\n        suggestedType: ref.type ?? \"person\",\n      });\n      resolved.set(key, result.entity);\n      return result.entity;\n    }\n\n    if (ref.name) {\n      const candidates = await args.entityStore.resolve({\n        name: ref.name,\n        type: ref.type ?? \"person\",\n      });\n      const exact = candidates.find(\n        (c) => c.entity.preferredName.toLowerCase() === ref.name?.toLowerCase(),\n      );\n      if (exact) {\n        resolved.set(key, exact.entity);\n        return exact.entity;\n      }\n      const created = await args.entityStore.upsert({\n        type: ref.type ?? \"person\",\n        preferredName: ref.name,\n        identities: [],\n        tags: [],\n        visibility: \"owner_agent_admin\",\n        state: {},\n      });\n      resolved.set(key, created);\n      return created;\n    }\n\n    throw new Error(\n      \"[applyExtractedEdges] entity ref has no identity, id, or name\",\n    );\n  };\n\n  // Resolve all refs first so we know the entities involved.\n  const edgePairs: Array<{ from: Entity; to: Entity; edge: ExtractedEdge }> =\n    [];\n  for (const edge of args.edges) {\n    const from = await resolveRef(edge.fromRef);\n    const to = await resolveRef(edge.toRef);\n    edgePairs.push({ from, to, edge });\n    provenance[args.evidenceId]?.entityIds.push(from.entityId, to.entityId);\n  }\n\n  // Then apply each edge via observe (strengthen or create).\n  const relationships: Relationship[] = [];\n  for (const { from, to, edge } of edgePairs) {\n    const relationship = await args.relationshipStore.observe({\n      fromEntityId: from.entityId,\n      toEntityId: to.entityId,\n      type: edge.type,\n      ...(edge.metadata ? { metadataPatch: edge.metadata } : {}),\n      evidence: [args.evidenceId],\n      confidence: edge.confidence,\n      source: args.source ?? \"extraction\",\n    });\n    relationships.push(relationship);\n    provenance[args.evidenceId]?.relationshipIds.push(\n      relationship.relationshipId,\n    );\n  }\n\n  // Dedupe entities returned (resolveRef may map to the same entity).\n  const entityMap = new Map<string, Entity>();\n  for (const entity of resolved.values()) {\n    entityMap.set(entity.entityId, entity);\n  }\n\n  return {\n    entities: Array.from(entityMap.values()),\n    relationships,\n    provenance,\n  };\n}\n\n/**\n * Convenience: parse a \"X is my <role> at Y\" statement into 2 entities +\n * 3 edges. This is one canonical pattern; richer NL parsing lives in the\n * planner. Returns the structured `ExtractedEdge[]` ready for\n * `applyExtractedEdges`.\n *\n * Example: managerOfAtCompany(\"Pat\", \"Acme\") →\n *   - self → Pat: managed_by\n *   - self → Acme: works_at\n *   - Pat → Acme: works_at\n */\nexport function managerOfAtCompany(\n  managerName: string,\n  companyName: string,\n  options: {\n    confidence?: number;\n    managerRole?: string;\n    selfRole?: string;\n  } = {},\n): ExtractedEdge[] {\n  const confidence = options.confidence ?? 0.85;\n  return [\n    {\n      fromRef: { id: SELF_ENTITY_ID },\n      toRef: { name: managerName, type: \"person\" },\n      type: \"managed_by\",\n      ...(options.managerRole\n        ? { metadata: { role: options.managerRole } }\n        : {}),\n      confidence,\n    },\n    {\n      fromRef: { id: SELF_ENTITY_ID },\n      toRef: { name: companyName, type: \"organization\" },\n      type: \"works_at\",\n      ...(options.selfRole ? { metadata: { role: options.selfRole } } : {}),\n      confidence,\n    },\n    {\n      fromRef: { name: managerName, type: \"person\" },\n      toRef: { name: companyName, type: \"organization\" },\n      type: \"works_at\",\n      ...(options.managerRole\n        ? { metadata: { role: options.managerRole } }\n        : {}),\n      confidence,\n    },\n  ];\n}\n"],"mappings":"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","names":[]}

package/dist/lifeops/relationships/index.d.ts

@@ -0,0 +1,4 @@
+export { applyExtractedEdges, type ExtractedEdge, type ExtractedEntityRef, type ExtractionResult, managerOfAtCompany, } from "./extraction.js";
+export { RelationshipStore } from "./store.js";
+export { BUILT_IN_RELATIONSHIP_TYPES, type BuiltInRelationshipType, defaultRelationshipTypeRegistry, type Relationship, type RelationshipFilter, type RelationshipSentiment, type RelationshipSource, type RelationshipState, type RelationshipStatus, RelationshipTypeRegistry, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lifeops/relationships/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lifeops/relationships/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EACL,2BAA2B,EAC3B,KAAK,uBAAuB,EAC5B,+BAA+B,EAC/B,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,wBAAwB,GACzB,MAAM,YAAY,CAAC"}

package/dist/lifeops/relationships/index.js

@@ -0,0 +1,19 @@
+import {
+  applyExtractedEdges,
+  managerOfAtCompany
+} from "./extraction.js";
+import { RelationshipStore } from "./store.js";
+import {
+  BUILT_IN_RELATIONSHIP_TYPES,
+  defaultRelationshipTypeRegistry,
+  RelationshipTypeRegistry
+} from "./types.js";
+export {
+  BUILT_IN_RELATIONSHIP_TYPES,
+  RelationshipStore,
+  RelationshipTypeRegistry,
+  applyExtractedEdges,
+  defaultRelationshipTypeRegistry,
+  managerOfAtCompany
+};
+//# sourceMappingURL=index.js.map

package/dist/lifeops/relationships/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/relationships/index.ts"],"sourcesContent":["export {\n  applyExtractedEdges,\n  type ExtractedEdge,\n  type ExtractedEntityRef,\n  type ExtractionResult,\n  managerOfAtCompany,\n} from \"./extraction.js\";\nexport { RelationshipStore } from \"./store.js\";\nexport {\n  BUILT_IN_RELATIONSHIP_TYPES,\n  type BuiltInRelationshipType,\n  defaultRelationshipTypeRegistry,\n  type Relationship,\n  type RelationshipFilter,\n  type RelationshipSentiment,\n  type RelationshipSource,\n  type RelationshipState,\n  type RelationshipStatus,\n  RelationshipTypeRegistry,\n} from \"./types.js\";\n"],"mappings":"AAAA;AAAA,EACE;AAAA,EAIA;AAAA,OACK;AACP,SAAS,yBAAyB;AAClC;AAAA,EACE;AAAA,EAEA;AAAA,EAOA;AAAA,OACK;","names":[]}

package/dist/lifeops/relationships/mapping.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Bidirectional mapping between the flat `LifeOpsRelationship` contact DTO and
+ * the runtime knowledge graph (`EntityStore` person nodes + a single SELF→
+ * contact `RelationshipStore` edge).
+ *
+ * The runtime graph is the **single source of truth** for contacts — there is
+ * no separate `life_relationships` table. These helpers preserve the legacy
+ * `LifeOpsRelationship` shape that the ENTITY action, scheduling, and check-in
+ * consume, projected from / into the graph.
+ */
+import type { Entity, EntityAttribute, EntityIdentity, LifeOpsRelationship, Relationship } from "@elizaos/shared";
+/** Tag marking a person entity that the owner explicitly added as a contact. */
+export declare const LIFEOPS_CONTACT_TAG = "lifeops:contact";
+/** Deterministic id for the single SELF→contact edge of a contact entity. */
+export declare function contactEdgeId(entityId: string): string;
+/** Drop system-owned tags so the DTO only exposes user tags. */
+export declare function userTags(tags: string[]): string[];
+/** Most recent contact timestamp across entity + edge interaction state. */
+export declare function lastContactedAtFromEntity(entity: Entity, edge: Relationship | null): string | null;
+/** Project a graph person entity (+ its contact edge) into the flat DTO. */
+export declare function lifeOpsRelationshipFromEntity(agentId: string, entity: Entity, edge: Relationship | null): LifeOpsRelationship;
+interface ContactFields {
+    primaryChannel: string;
+    primaryHandle: string;
+    email: string | null;
+    phone: string | null;
+    notes: string;
+}
+/** Entity attributes that round-trip the flat contact projection. */
+export declare function contactAttributes(input: ContactFields, updatedAt: string): Record<string, EntityAttribute>;
+/** Verified identities for the primary channel plus email / phone. */
+export declare function contactIdentities(input: ContactFields, addedAt: string): EntityIdentity[];
+export {};
+//# sourceMappingURL=mapping.d.ts.map

package/dist/lifeops/relationships/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../../src/lifeops/relationships/mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,MAAM,EACN,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,YAAY,EACb,MAAM,iBAAiB,CAAC;AAEzB,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAWrD,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,gEAAgE;AAChE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEjD;AAOD,4EAA4E;AAC5E,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,GAAG,IAAI,GACxB,MAAM,GAAG,IAAI,CAQf;AAED,4EAA4E;AAC5E,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,GAAG,IAAI,GACxB,mBAAmB,CAsBrB;AAED,UAAU,aAAa;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAejC;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,GACd,cAAc,EAAE,CAqBlB"}

package/dist/lifeops/relationships/mapping.js

@@ -0,0 +1,87 @@
+const LIFEOPS_CONTACT_TAG = "lifeops:contact";
+const SYSTEM_PREFIX = "lifeops:";
+const ATTR_PRIMARY_CHANNEL = "lifeops:primaryChannel";
+const ATTR_PRIMARY_HANDLE = "lifeops:primaryHandle";
+const ATTR_EMAIL = "lifeops:email";
+const ATTR_PHONE = "lifeops:phone";
+const ATTR_NOTES = "lifeops:notes";
+function contactEdgeId(entityId) {
+  return `lifeops-contact-${entityId}`;
+}
+function userTags(tags) {
+  return tags.filter((tag) => !tag.startsWith(SYSTEM_PREFIX));
+}
+function attrString(entity, key) {
+  const value = entity.attributes?.[key]?.value;
+  return typeof value === "string" && value.length > 0 ? value : null;
+}
+function lastContactedAtFromEntity(entity, edge) {
+  return entity.state.lastObservedAt ?? entity.state.lastInboundAt ?? entity.state.lastOutboundAt ?? edge?.state.lastInteractionAt ?? null;
+}
+function lifeOpsRelationshipFromEntity(agentId, entity, edge) {
+  const primaryIdentity = entity.identities[0];
+  return {
+    id: entity.entityId,
+    agentId,
+    name: entity.preferredName,
+    primaryChannel: attrString(entity, ATTR_PRIMARY_CHANNEL) ?? primaryIdentity?.platform ?? "",
+    primaryHandle: attrString(entity, ATTR_PRIMARY_HANDLE) ?? primaryIdentity?.handle ?? "",
+    email: attrString(entity, ATTR_EMAIL),
+    phone: attrString(entity, ATTR_PHONE),
+    notes: attrString(entity, ATTR_NOTES) ?? "",
+    tags: userTags(entity.tags),
+    relationshipType: edge?.type ?? "contact",
+    lastContactedAt: lastContactedAtFromEntity(entity, edge),
+    metadata: { ...edge?.metadata ?? {} },
+    createdAt: entity.createdAt,
+    updatedAt: entity.updatedAt
+  };
+}
+function contactAttributes(input, updatedAt) {
+  const make = (value) => ({
+    value,
+    confidence: 1,
+    evidence: [],
+    updatedAt
+  });
+  const attributes = {
+    [ATTR_PRIMARY_CHANNEL]: make(input.primaryChannel),
+    [ATTR_PRIMARY_HANDLE]: make(input.primaryHandle)
+  };
+  if (input.email) attributes[ATTR_EMAIL] = make(input.email);
+  if (input.phone) attributes[ATTR_PHONE] = make(input.phone);
+  if (input.notes) attributes[ATTR_NOTES] = make(input.notes);
+  return attributes;
+}
+function contactIdentities(input, addedAt) {
+  const seen = /* @__PURE__ */ new Set();
+  const identities = [];
+  const push = (platform, handle) => {
+    const key = `${platform}\0${handle}`;
+    if (!platform || !handle || seen.has(key)) return;
+    seen.add(key);
+    identities.push({
+      platform,
+      handle,
+      verified: true,
+      confidence: 1,
+      addedAt,
+      addedVia: "import",
+      evidence: []
+    });
+  };
+  push(input.primaryChannel, input.primaryHandle);
+  if (input.email) push("email", input.email);
+  if (input.phone) push("phone", input.phone);
+  return identities;
+}
+export {
+  LIFEOPS_CONTACT_TAG,
+  contactAttributes,
+  contactEdgeId,
+  contactIdentities,
+  lastContactedAtFromEntity,
+  lifeOpsRelationshipFromEntity,
+  userTags
+};
+//# sourceMappingURL=mapping.js.map

package/dist/lifeops/relationships/mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/relationships/mapping.ts"],"sourcesContent":["/**\n * Bidirectional mapping between the flat `LifeOpsRelationship` contact DTO and\n * the runtime knowledge graph (`EntityStore` person nodes + a single SELF→\n * contact `RelationshipStore` edge).\n *\n * The runtime graph is the **single source of truth** for contacts — there is\n * no separate `life_relationships` table. These helpers preserve the legacy\n * `LifeOpsRelationship` shape that the ENTITY action, scheduling, and check-in\n * consume, projected from / into the graph.\n */\n\nimport type {\n  Entity,\n  EntityAttribute,\n  EntityIdentity,\n  LifeOpsRelationship,\n  Relationship,\n} from \"@elizaos/shared\";\n\n/** Tag marking a person entity that the owner explicitly added as a contact. */\nexport const LIFEOPS_CONTACT_TAG = \"lifeops:contact\";\n\n/** System tag/attribute prefix; stripped from the user-facing `tags` array. */\nconst SYSTEM_PREFIX = \"lifeops:\";\n\nconst ATTR_PRIMARY_CHANNEL = \"lifeops:primaryChannel\";\nconst ATTR_PRIMARY_HANDLE = \"lifeops:primaryHandle\";\nconst ATTR_EMAIL = \"lifeops:email\";\nconst ATTR_PHONE = \"lifeops:phone\";\nconst ATTR_NOTES = \"lifeops:notes\";\n\n/** Deterministic id for the single SELF→contact edge of a contact entity. */\nexport function contactEdgeId(entityId: string): string {\n  return `lifeops-contact-${entityId}`;\n}\n\n/** Drop system-owned tags so the DTO only exposes user tags. */\nexport function userTags(tags: string[]): string[] {\n  return tags.filter((tag) => !tag.startsWith(SYSTEM_PREFIX));\n}\n\nfunction attrString(entity: Entity, key: string): string | null {\n  const value = entity.attributes?.[key]?.value;\n  return typeof value === \"string\" && value.length > 0 ? value : null;\n}\n\n/** Most recent contact timestamp across entity + edge interaction state. */\nexport function lastContactedAtFromEntity(\n  entity: Entity,\n  edge: Relationship | null,\n): string | null {\n  return (\n    entity.state.lastObservedAt ??\n    entity.state.lastInboundAt ??\n    entity.state.lastOutboundAt ??\n    edge?.state.lastInteractionAt ??\n    null\n  );\n}\n\n/** Project a graph person entity (+ its contact edge) into the flat DTO. */\nexport function lifeOpsRelationshipFromEntity(\n  agentId: string,\n  entity: Entity,\n  edge: Relationship | null,\n): LifeOpsRelationship {\n  const primaryIdentity = entity.identities[0];\n  return {\n    id: entity.entityId,\n    agentId,\n    name: entity.preferredName,\n    primaryChannel:\n      attrString(entity, ATTR_PRIMARY_CHANNEL) ??\n      primaryIdentity?.platform ??\n      \"\",\n    primaryHandle:\n      attrString(entity, ATTR_PRIMARY_HANDLE) ?? primaryIdentity?.handle ?? \"\",\n    email: attrString(entity, ATTR_EMAIL),\n    phone: attrString(entity, ATTR_PHONE),\n    notes: attrString(entity, ATTR_NOTES) ?? \"\",\n    tags: userTags(entity.tags),\n    relationshipType: edge?.type ?? \"contact\",\n    lastContactedAt: lastContactedAtFromEntity(entity, edge),\n    metadata: { ...(edge?.metadata ?? {}) },\n    createdAt: entity.createdAt,\n    updatedAt: entity.updatedAt,\n  };\n}\n\ninterface ContactFields {\n  primaryChannel: string;\n  primaryHandle: string;\n  email: string | null;\n  phone: string | null;\n  notes: string;\n}\n\n/** Entity attributes that round-trip the flat contact projection. */\nexport function contactAttributes(\n  input: ContactFields,\n  updatedAt: string,\n): Record<string, EntityAttribute> {\n  const make = (value: string): EntityAttribute => ({\n    value,\n    confidence: 1,\n    evidence: [],\n    updatedAt,\n  });\n  const attributes: Record<string, EntityAttribute> = {\n    [ATTR_PRIMARY_CHANNEL]: make(input.primaryChannel),\n    [ATTR_PRIMARY_HANDLE]: make(input.primaryHandle),\n  };\n  if (input.email) attributes[ATTR_EMAIL] = make(input.email);\n  if (input.phone) attributes[ATTR_PHONE] = make(input.phone);\n  if (input.notes) attributes[ATTR_NOTES] = make(input.notes);\n  return attributes;\n}\n\n/** Verified identities for the primary channel plus email / phone. */\nexport function contactIdentities(\n  input: ContactFields,\n  addedAt: string,\n): EntityIdentity[] {\n  const seen = new Set<string>();\n  const identities: EntityIdentity[] = [];\n  const push = (platform: string, handle: string) => {\n    const key = `${platform}\\x00${handle}`;\n    if (!platform || !handle || seen.has(key)) return;\n    seen.add(key);\n    identities.push({\n      platform,\n      handle,\n      verified: true,\n      confidence: 1,\n      addedAt,\n      addedVia: \"import\",\n      evidence: [],\n    });\n  };\n  push(input.primaryChannel, input.primaryHandle);\n  if (input.email) push(\"email\", input.email);\n  if (input.phone) push(\"phone\", input.phone);\n  return identities;\n}\n"],"mappings":"AAoBO,MAAM,sBAAsB;AAGnC,MAAM,gBAAgB;AAEtB,MAAM,uBAAuB;AAC7B,MAAM,sBAAsB;AAC5B,MAAM,aAAa;AACnB,MAAM,aAAa;AACnB,MAAM,aAAa;AAGZ,SAAS,cAAc,UAA0B;AACtD,SAAO,mBAAmB,QAAQ;AACpC;AAGO,SAAS,SAAS,MAA0B;AACjD,SAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,IAAI,WAAW,aAAa,CAAC;AAC5D;AAEA,SAAS,WAAW,QAAgB,KAA4B;AAC9D,QAAM,QAAQ,OAAO,aAAa,GAAG,GAAG;AACxC,SAAO,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ;AACjE;AAGO,SAAS,0BACd,QACA,MACe;AACf,SACE,OAAO,MAAM,kBACb,OAAO,MAAM,iBACb,OAAO,MAAM,kBACb,MAAM,MAAM,qBACZ;AAEJ;AAGO,SAAS,8BACd,SACA,QACA,MACqB;AACrB,QAAM,kBAAkB,OAAO,WAAW,CAAC;AAC3C,SAAO;AAAA,IACL,IAAI,OAAO;AAAA,IACX;AAAA,IACA,MAAM,OAAO;AAAA,IACb,gBACE,WAAW,QAAQ,oBAAoB,KACvC,iBAAiB,YACjB;AAAA,IACF,eACE,WAAW,QAAQ,mBAAmB,KAAK,iBAAiB,UAAU;AAAA,IACxE,OAAO,WAAW,QAAQ,UAAU;AAAA,IACpC,OAAO,WAAW,QAAQ,UAAU;AAAA,IACpC,OAAO,WAAW,QAAQ,UAAU,KAAK;AAAA,IACzC,MAAM,SAAS,OAAO,IAAI;AAAA,IAC1B,kBAAkB,MAAM,QAAQ;AAAA,IAChC,iBAAiB,0BAA0B,QAAQ,IAAI;AAAA,IACvD,UAAU,EAAE,GAAI,MAAM,YAAY,CAAC,EAAG;AAAA,IACtC,WAAW,OAAO;AAAA,IAClB,WAAW,OAAO;AAAA,EACpB;AACF;AAWO,SAAS,kBACd,OACA,WACiC;AACjC,QAAM,OAAO,CAAC,WAAoC;AAAA,IAChD;AAAA,IACA,YAAY;AAAA,IACZ,UAAU,CAAC;AAAA,IACX;AAAA,EACF;AACA,QAAM,aAA8C;AAAA,IAClD,CAAC,oBAAoB,GAAG,KAAK,MAAM,cAAc;AAAA,IACjD,CAAC,mBAAmB,GAAG,KAAK,MAAM,aAAa;AAAA,EACjD;AACA,MAAI,MAAM,MAAO,YAAW,UAAU,IAAI,KAAK,MAAM,KAAK;AAC1D,MAAI,MAAM,MAAO,YAAW,UAAU,IAAI,KAAK,MAAM,KAAK;AAC1D,MAAI,MAAM,MAAO,YAAW,UAAU,IAAI,KAAK,MAAM,KAAK;AAC1D,SAAO;AACT;AAGO,SAAS,kBACd,OACA,SACkB;AAClB,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,aAA+B,CAAC;AACtC,QAAM,OAAO,CAAC,UAAkB,WAAmB;AACjD,UAAM,MAAM,GAAG,QAAQ,KAAO,MAAM;AACpC,QAAI,CAAC,YAAY,CAAC,UAAU,KAAK,IAAI,GAAG,EAAG;AAC3C,SAAK,IAAI,GAAG;AACZ,eAAW,KAAK;AAAA,MACd;AAAA,MACA;AAAA,MACA,UAAU;AAAA,MACV,YAAY;AAAA,MACZ;AAAA,MACA,UAAU;AAAA,MACV,UAAU,CAAC;AAAA,IACb,CAAC;AAAA,EACH;AACA,OAAK,MAAM,gBAAgB,MAAM,aAAa;AAC9C,MAAI,MAAM,MAAO,MAAK,SAAS,MAAM,KAAK;AAC1C,MAAI,MAAM,MAAO,MAAK,SAAS,MAAM,KAAK;AAC1C,SAAO;AACT;","names":[]}

package/dist/lifeops/relationships/store.d.ts

@@ -0,0 +1,12 @@
+/**
+ * RelationshipStore re-export shim.
+ *
+ * The DB-backed `RelationshipStore` is now a runtime primitive owned by
+ * `@elizaos/agent` and surfaced through `KnowledgeGraphService`. This module
+ * re-exports it so the rest of LifeOps keeps importing from `./store.js`.
+ * New code should resolve the store via the runtime service:
+ *
+ *   resolveKnowledgeGraphService(runtime)?.getRelationshipStore(agentId)
+ */
+export { RelationshipStore } from "@elizaos/agent";
+//# sourceMappingURL=store.d.ts.map

package/dist/lifeops/relationships/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/lifeops/relationships/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/lifeops/relationships/store.js

@@ -0,0 +1,5 @@
+import { RelationshipStore } from "@elizaos/agent";
+export {
+  RelationshipStore
+};
+//# sourceMappingURL=store.js.map

package/dist/lifeops/relationships/store.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/relationships/store.ts"],"sourcesContent":["/**\n * RelationshipStore re-export shim.\n *\n * The DB-backed `RelationshipStore` is now a runtime primitive owned by\n * `@elizaos/agent` and surfaced through `KnowledgeGraphService`. This module\n * re-exports it so the rest of LifeOps keeps importing from `./store.js`.\n * New code should resolve the store via the runtime service:\n *\n *   resolveKnowledgeGraphService(runtime)?.getRelationshipStore(agentId)\n */\n\nexport { RelationshipStore } from \"@elizaos/agent\";\n"],"mappings":"AAWA,SAAS,yBAAyB;","names":[]}

package/dist/lifeops/relationships/types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Relationship types for the LifeOps knowledge graph.
+ *
+ * Canonical home is `@elizaos/shared` (`knowledge-graph/relationship-types.ts`).
+ * This module re-exports the runtime-level primitives so the DB-backed
+ * `RelationshipStore` and the rest of LifeOps keep importing from `./types.js`.
+ */
+export { BUILT_IN_RELATIONSHIP_TYPES, type BuiltInRelationshipType, defaultRelationshipTypeRegistry, type Relationship, type RelationshipFilter, type RelationshipSentiment, type RelationshipSource, type RelationshipState, type RelationshipStatus, RelationshipTypeRegistry, } from "@elizaos/shared";
+//# sourceMappingURL=types.d.ts.map

package/dist/lifeops/relationships/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lifeops/relationships/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,2BAA2B,EAC3B,KAAK,uBAAuB,EAC5B,+BAA+B,EAC/B,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC"}

package/dist/lifeops/relationships/types.js

@@ -0,0 +1,11 @@
+import {
+  BUILT_IN_RELATIONSHIP_TYPES,
+  defaultRelationshipTypeRegistry,
+  RelationshipTypeRegistry
+} from "@elizaos/shared";
+export {
+  BUILT_IN_RELATIONSHIP_TYPES,
+  RelationshipTypeRegistry,
+  defaultRelationshipTypeRegistry
+};
+//# sourceMappingURL=types.js.map

package/dist/lifeops/relationships/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/relationships/types.ts"],"sourcesContent":["/**\n * Relationship types for the LifeOps knowledge graph.\n *\n * Canonical home is `@elizaos/shared` (`knowledge-graph/relationship-types.ts`).\n * This module re-exports the runtime-level primitives so the DB-backed\n * `RelationshipStore` and the rest of LifeOps keep importing from `./types.js`.\n */\n\nexport {\n  BUILT_IN_RELATIONSHIP_TYPES,\n  type BuiltInRelationshipType,\n  defaultRelationshipTypeRegistry,\n  type Relationship,\n  type RelationshipFilter,\n  type RelationshipSentiment,\n  type RelationshipSource,\n  type RelationshipState,\n  type RelationshipStatus,\n  RelationshipTypeRegistry,\n} from \"@elizaos/shared\";\n"],"mappings":"AAQA;AAAA,EACE;AAAA,EAEA;AAAA,EAOA;AAAA,OACK;","names":[]}

package/dist/lifeops/relative-schedule-resolver.d.ts

@@ -0,0 +1,13 @@
+import type { LifeOpsWorkflowSchedule } from "@elizaos/shared";
+import type { LifeOpsScheduleMergedStateRecord } from "./repository.js";
+type RelativeScheduleKind = Extract<LifeOpsWorkflowSchedule, {
+    kind: "relative_to_wake" | "relative_to_bedtime" | "during_morning" | "during_night";
+}>;
+export declare function resolveNextRelativeScheduleInstant(args: {
+    schedule: RelativeScheduleKind;
+    state: LifeOpsScheduleMergedStateRecord | null;
+    cursorIso?: string | null;
+    nowMs: number;
+}): string | null;
+export {};
+//# sourceMappingURL=relative-schedule-resolver.d.ts.map

package/dist/lifeops/relative-schedule-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative-schedule-resolver.d.ts","sourceRoot":"","sources":["../../src/lifeops/relative-schedule-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,uBAAuB,EACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,iBAAiB,CAAC;AAmExE,KAAK,oBAAoB,GAAG,OAAO,CACjC,uBAAuB,EACvB;IACE,IAAI,EACA,kBAAkB,GAClB,qBAAqB,GACrB,gBAAgB,GAChB,cAAc,CAAC;CACpB,CACF,CAAC;AA2BF,wBAAgB,kCAAkC,CAAC,IAAI,EAAE;IACvD,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,KAAK,EAAE,gCAAgC,GAAG,IAAI,CAAC;IAC/C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,GAAG,IAAI,CA+DhB"}

package/dist/lifeops/relative-schedule-resolver.js

@@ -0,0 +1,107 @@
+import { buildUtcDateFromLocalParts, getZonedDateParts } from "./time.js";
+import { parseIsoMs } from "./time-util.js";
+const REGULARITY_RANK = {
+  insufficient_data: 0,
+  very_irregular: 1,
+  irregular: 2,
+  regular: 3,
+  very_regular: 4
+};
+function zonedWeekday(ms, timezone) {
+  return new Date(
+    new Date(ms).toLocaleString("en-US", { timeZone: timezone })
+  ).getDay();
+}
+function regularitySatisfied(actual, required) {
+  if (!required) {
+    return true;
+  }
+  return REGULARITY_RANK[actual] >= REGULARITY_RANK[required];
+}
+function weekdayMatches(targetMs, timezone, allowedWeekdays) {
+  if (!allowedWeekdays || allowedWeekdays.length === 0) {
+    return true;
+  }
+  return allowedWeekdays.includes(zonedWeekday(targetMs, timezone));
+}
+function nextProjectedLocalInstant(args) {
+  const parts = getZonedDateParts(new Date(args.cursorMs), args.timezone);
+  const totalMinutes = Math.round(args.localHour * 60);
+  const minuteOfDay = (totalMinutes % (24 * 60) + 24 * 60) % (24 * 60);
+  for (let dayOffset = 0; dayOffset < 14; dayOffset += 1) {
+    const candidate = buildUtcDateFromLocalParts(args.timezone, {
+      year: parts.year,
+      month: parts.month,
+      day: parts.day + dayOffset,
+      hour: Math.floor(minuteOfDay / 60),
+      minute: minuteOfDay % 60,
+      second: 0
+    }).getTime();
+    if (candidate <= args.cursorMs) {
+      continue;
+    }
+    if (weekdayMatches(candidate, args.timezone, args.allowedWeekdays)) {
+      return candidate;
+    }
+  }
+  return null;
+}
+function isAnchorKind(schedule) {
+  return schedule.kind === "relative_to_wake" || schedule.kind === "during_morning";
+}
+function offsetMinutesFor(schedule) {
+  if (schedule.kind === "relative_to_wake" || schedule.kind === "relative_to_bedtime") {
+    return schedule.offsetMinutes;
+  }
+  if (schedule.kind === "during_morning") {
+    return 0;
+  }
+  return -(schedule.windowMinutesBeforeSleepTarget ?? 120);
+}
+function resolveNextRelativeScheduleInstant(args) {
+  const cursorMs = args.cursorIso ? Date.parse(args.cursorIso) : args.nowMs;
+  const state = args.state;
+  if (!state) {
+    return null;
+  }
+  if (!regularitySatisfied(
+    state.regularity.regularityClass,
+    args.schedule.requireRegularityAtLeast
+  )) {
+    return null;
+  }
+  const anchorIso = isAnchorKind(args.schedule) ? state.wakeAt : state.relativeTime.bedtimeTargetAt;
+  const anchorMs = parseIsoMs(anchorIso);
+  const offsetMinutes = offsetMinutesFor(args.schedule);
+  if (args.schedule.kind === "relative_to_wake" && typeof args.schedule.stabilityWindowMinutes === "number" && state.circadianState !== "awake") {
+    return null;
+  }
+  if (anchorMs !== null) {
+    const targetMs = anchorMs + offsetMinutes * 6e4;
+    if (targetMs > cursorMs && weekdayMatches(targetMs, state.timezone, args.schedule.onDays)) {
+      return new Date(targetMs).toISOString();
+    }
+  }
+  const baseline = state.baseline;
+  if (baseline === null) {
+    return null;
+  }
+  const projectedHour = isAnchorKind(args.schedule) ? baseline.medianWakeLocalHour : baseline.medianBedtimeLocalHour;
+  if (!Number.isFinite(projectedHour)) {
+    return null;
+  }
+  const projectedAnchorMs = nextProjectedLocalInstant({
+    timezone: state.timezone,
+    cursorMs,
+    localHour: projectedHour,
+    allowedWeekdays: args.schedule.onDays
+  });
+  if (projectedAnchorMs === null) {
+    return null;
+  }
+  return new Date(projectedAnchorMs + offsetMinutes * 6e4).toISOString();
+}
+export {
+  resolveNextRelativeScheduleInstant
+};
+//# sourceMappingURL=relative-schedule-resolver.js.map

package/dist/lifeops/relative-schedule-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lifeops/relative-schedule-resolver.ts"],"sourcesContent":["import type {\n  LifeOpsRegularityClass,\n  LifeOpsWorkflowSchedule,\n} from \"@elizaos/shared\";\nimport type { LifeOpsScheduleMergedStateRecord } from \"./repository.js\";\nimport { buildUtcDateFromLocalParts, getZonedDateParts } from \"./time.js\";\nimport { parseIsoMs } from \"./time-util.js\";\n\nconst REGULARITY_RANK: Record<LifeOpsRegularityClass, number> = {\n  insufficient_data: 0,\n  very_irregular: 1,\n  irregular: 2,\n  regular: 3,\n  very_regular: 4,\n};\n\nfunction zonedWeekday(ms: number, timezone: string): number {\n  return new Date(\n    new Date(ms).toLocaleString(\"en-US\", { timeZone: timezone }),\n  ).getDay();\n}\n\nfunction regularitySatisfied(\n  actual: LifeOpsRegularityClass,\n  required: LifeOpsRegularityClass | undefined,\n): boolean {\n  if (!required) {\n    return true;\n  }\n  return REGULARITY_RANK[actual] >= REGULARITY_RANK[required];\n}\n\nfunction weekdayMatches(\n  targetMs: number,\n  timezone: string,\n  allowedWeekdays: number[] | undefined,\n): boolean {\n  if (!allowedWeekdays || allowedWeekdays.length === 0) {\n    return true;\n  }\n  return allowedWeekdays.includes(zonedWeekday(targetMs, timezone));\n}\n\nfunction nextProjectedLocalInstant(args: {\n  timezone: string;\n  cursorMs: number;\n  localHour: number;\n  allowedWeekdays?: number[];\n}): number | null {\n  const parts = getZonedDateParts(new Date(args.cursorMs), args.timezone);\n  const totalMinutes = Math.round(args.localHour * 60);\n  const minuteOfDay = ((totalMinutes % (24 * 60)) + 24 * 60) % (24 * 60);\n  for (let dayOffset = 0; dayOffset < 14; dayOffset += 1) {\n    const candidate = buildUtcDateFromLocalParts(args.timezone, {\n      year: parts.year,\n      month: parts.month,\n      day: parts.day + dayOffset,\n      hour: Math.floor(minuteOfDay / 60),\n      minute: minuteOfDay % 60,\n      second: 0,\n    }).getTime();\n    if (candidate <= args.cursorMs) {\n      continue;\n    }\n    if (weekdayMatches(candidate, args.timezone, args.allowedWeekdays)) {\n      return candidate;\n    }\n  }\n  return null;\n}\n\ntype RelativeScheduleKind = Extract<\n  LifeOpsWorkflowSchedule,\n  {\n    kind:\n      | \"relative_to_wake\"\n      | \"relative_to_bedtime\"\n      | \"during_morning\"\n      | \"during_night\";\n  }\n>;\n\nfunction isAnchorKind(\n  schedule: RelativeScheduleKind,\n): schedule is Extract<\n  LifeOpsWorkflowSchedule,\n  { kind: \"relative_to_wake\" | \"during_morning\" }\n> {\n  return (\n    schedule.kind === \"relative_to_wake\" || schedule.kind === \"during_morning\"\n  );\n}\n\nfunction offsetMinutesFor(schedule: RelativeScheduleKind): number {\n  if (\n    schedule.kind === \"relative_to_wake\" ||\n    schedule.kind === \"relative_to_bedtime\"\n  ) {\n    return schedule.offsetMinutes;\n  }\n  if (schedule.kind === \"during_morning\") {\n    return 0;\n  }\n  // during_night: fires at (bedtimeTarget - windowMinutesBeforeSleepTarget).\n  return -(schedule.windowMinutesBeforeSleepTarget ?? 120);\n}\n\nexport function resolveNextRelativeScheduleInstant(args: {\n  schedule: RelativeScheduleKind;\n  state: LifeOpsScheduleMergedStateRecord | null;\n  cursorIso?: string | null;\n  nowMs: number;\n}): string | null {\n  const cursorMs = args.cursorIso ? Date.parse(args.cursorIso) : args.nowMs;\n  const state = args.state;\n  if (!state) {\n    return null;\n  }\n  if (\n    !regularitySatisfied(\n      state.regularity.regularityClass,\n      args.schedule.requireRegularityAtLeast,\n    )\n  ) {\n    return null;\n  }\n\n  const anchorIso = isAnchorKind(args.schedule)\n    ? state.wakeAt\n    : state.relativeTime.bedtimeTargetAt;\n  const anchorMs = parseIsoMs(anchorIso);\n  const offsetMinutes = offsetMinutesFor(args.schedule);\n\n  // relative_to_wake with stabilityWindowMinutes requires `wake.confirmed`,\n  // which is signalled by the merged-state circadianState having advanced\n  // past `waking` (i.e. `awake`). When the stability condition is not met,\n  // defer to the event-workflow path — return null rather than project.\n  if (\n    args.schedule.kind === \"relative_to_wake\" &&\n    typeof args.schedule.stabilityWindowMinutes === \"number\" &&\n    state.circadianState !== \"awake\"\n  ) {\n    return null;\n  }\n\n  if (anchorMs !== null) {\n    const targetMs = anchorMs + offsetMinutes * 60_000;\n    if (\n      targetMs > cursorMs &&\n      weekdayMatches(targetMs, state.timezone, args.schedule.onDays)\n    ) {\n      return new Date(targetMs).toISOString();\n    }\n  }\n\n  const baseline = state.baseline;\n  if (baseline === null) {\n    return null;\n  }\n  const projectedHour = isAnchorKind(args.schedule)\n    ? baseline.medianWakeLocalHour\n    : baseline.medianBedtimeLocalHour;\n  if (!Number.isFinite(projectedHour)) {\n    return null;\n  }\n  const projectedAnchorMs = nextProjectedLocalInstant({\n    timezone: state.timezone,\n    cursorMs,\n    localHour: projectedHour,\n    allowedWeekdays: args.schedule.onDays,\n  });\n  if (projectedAnchorMs === null) {\n    return null;\n  }\n  return new Date(projectedAnchorMs + offsetMinutes * 60_000).toISOString();\n}\n"],"mappings":"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","names":[]}

package/dist/lifeops/relative-time.d.ts

@@ -0,0 +1,15 @@
+import type { LifeOpsDayBoundary, LifeOpsRelativeTime, LifeOpsScheduleInsight } from "@elizaos/shared";
+type RelativeTimeScheduleFields = Pick<LifeOpsScheduleInsight, "circadianState" | "stateConfidence" | "uncertaintyReason" | "awakeProbability" | "regularity" | "baseline" | "sleepConfidence" | "currentSleepStartedAt" | "lastSleepStartedAt" | "lastSleepEndedAt" | "wakeAt" | "firstActiveAt">;
+export declare function resolveLifeOpsRelativeTime(args: {
+    nowMs: number;
+    timezone: string;
+    schedule: RelativeTimeScheduleFields;
+    dayBoundary?: Pick<LifeOpsDayBoundary, "startOfDayAt" | "endOfDayAt">;
+}): LifeOpsRelativeTime;
+export declare function refreshLifeOpsRelativeTime<T extends RelativeTimeScheduleFields & {
+    timezone: string;
+}>(state: T, now: Date): T & {
+    relativeTime: LifeOpsRelativeTime;
+};
+export {};
+//# sourceMappingURL=relative-time.d.ts.map

package/dist/lifeops/relative-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative-time.d.ts","sourceRoot":"","sources":["../../src/lifeops/relative-time.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,kBAAkB,EAElB,mBAAmB,EAEnB,sBAAsB,EAEvB,MAAM,iBAAiB,CAAC;AASzB,KAAK,0BAA0B,GAAG,IAAI,CACpC,sBAAsB,EACpB,gBAAgB,GAChB,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,YAAY,GACZ,UAAU,GACV,iBAAiB,GACjB,uBAAuB,GACvB,oBAAoB,GACpB,kBAAkB,GAClB,QAAQ,GACR,eAAe,CAClB,CAAC;AAoJF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,0BAA0B,CAAC;IACrC,WAAW,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC;CACvE,GAAG,mBAAmB,CAgItB;AAED,wBAAgB,0BAA0B,CACxC,CAAC,SAAS,0BAA0B,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC3D,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,GAAG,CAAC,GAAG;IAAE,YAAY,EAAE,mBAAmB,CAAA;CAAE,CAShE"}