@elizaos/shared 2.0.0-beta.1 → 2.0.3-beta.3

package/knowledge-graph/entity-types.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Entity types for the knowledge graph (canonical, runtime-level).
+ *
+ * An Entity is a node — a person, organization, place, project, or concept —
+ * with per-connector identities and open-keyed extracted attributes. The user
+ * is the special `self` Entity.
+ *
+ * Canonical home: `@elizaos/shared`. The DB-backed `EntityStore` lives in
+ * `@elizaos/plugin-personal-assistant`; the `LifeOpsEntity` wire contract in
+ * `@elizaos/shared/contracts/personal-assistant` re-exports these shapes.
+ */
+/**
+ * Built-in entity types. The registry accepts any string, but these are the
+ * shapes the runtime understands without registration. Open string with
+ * registered metadata via {@link EntityTypeRegistry}.
+ */
+export declare const BUILT_IN_ENTITY_TYPES: readonly ["person", "organization", "place", "project", "concept"];
+export type BuiltInEntityType = (typeof BUILT_IN_ENTITY_TYPES)[number];
+/**
+ * The identifier of the `self` Entity. Bootstrapped on first store init.
+ * All ego-network edges originate from `self`.
+ */
+export declare const SELF_ENTITY_ID = "self";
+export type EntityIdentityAddedVia = "user_chat" | "merge" | "platform_observation" | "extraction" | "import";
+export type EntityVisibility = "owner_only" | "agent_and_admin" | "owner_agent_admin";
+/**
+ * Per-connector identity claim. An Entity carries N of these — one per
+ * platform handle the runtime has observed or imported. Identity merge
+ * collapses two entities when (platform, handle) match and confidence
+ * thresholds align.
+ */
+export interface EntityIdentity {
+    platform: string;
+    handle: string;
+    displayName?: string;
+    /** Operator-confirmed (true) vs auto-merged / observed (false). */
+    verified: boolean;
+    /** 0..1 confidence in this identity claim. */
+    confidence: number;
+    addedAt: string;
+    addedVia: EntityIdentityAddedVia;
+    /** Observation ids contributing evidence for this identity. */
+    evidence: string[];
+}
+/**
+ * Open-keyed extracted attribute (location, employer, role, birthday, ...).
+ * The runtime does not branch on attribute keys; the only structural
+ * commitment is "value + provenance + freshness".
+ */
+export interface EntityAttribute {
+    value: unknown;
+    /** 0..1 confidence in the current value. */
+    confidence: number;
+    evidence: string[];
+    updatedAt: string;
+}
+/**
+ * Per-Entity interaction state (last-observed-at, last-inbound-at, etc.).
+ * Distinct from {@link RelationshipState} — Entity state is "what platform
+ * carried the most recent interaction"; Relationship state is "what was the
+ * last interaction on this specific edge".
+ */
+export interface EntityState {
+    lastObservedAt?: string;
+    lastInboundAt?: string;
+    lastOutboundAt?: string;
+    lastInteractionPlatform?: string;
+}
+/**
+ * The canonical Entity shape. Stored in `app_lifeops.life_entities` and
+ * paired with rows in `life_entity_identities` and `life_entity_attributes`.
+ */
+export interface Entity {
+    entityId: string;
+    type: string;
+    preferredName: string;
+    fullName?: string;
+    identities: EntityIdentity[];
+    attributes?: Record<string, EntityAttribute>;
+    state: EntityState;
+    tags: string[];
+    visibility: EntityVisibility;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Filter for `EntityStore.list`. All fields are optional and AND-combined.
+ */
+export interface EntityFilter {
+    type?: string;
+    tag?: string;
+    /** Substring match against `preferredName` and `fullName`, case-insensitive. */
+    nameContains?: string;
+    /** Match entities that have an identity on this platform. */
+    hasPlatform?: string;
+    limit?: number;
+}
+/**
+ * Result of `EntityStore.resolve`: a single entity candidate with the
+ * confidence that the query refers to this entity. `safeToSend` is `true`
+ * when the entity has at least one verified identity on a sendable platform
+ * — this is what the planner reads before dispatching outbound messages.
+ */
+export interface EntityResolveCandidate {
+    entity: Entity;
+    confidence: number;
+    evidence: string[];
+    safeToSend: boolean;
+}
+/**
+ * Open-string registry of entity types. Built-ins always validate; new types
+ * are registered with optional metadata (display label, default visibility).
+ *
+ * Registration is idempotent (re-registering the same key with the same
+ * metadata is a no-op). Conflicting metadata throws.
+ */
+export declare class EntityTypeRegistry {
+    private readonly registered;
+    constructor();
+    register(type: string, metadata?: {
+        label?: string;
+        defaultVisibility?: EntityVisibility;
+    }): void;
+    has(type: string): boolean;
+    list(): string[];
+    metadataFor(type: string): {
+        label: string;
+        defaultVisibility: EntityVisibility;
+    } | null;
+}
+/**
+ * Shared default registry instance. Tests construct their own.
+ */
+export declare const defaultEntityTypeRegistry: EntityTypeRegistry;
+//# sourceMappingURL=entity-types.d.ts.map

package/knowledge-graph/entity-types.d.ts.map

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

package/knowledge-graph/entity-types.js

@@ -0,0 +1,75 @@
+/**
+ * Entity types for the knowledge graph (canonical, runtime-level).
+ *
+ * An Entity is a node — a person, organization, place, project, or concept —
+ * with per-connector identities and open-keyed extracted attributes. The user
+ * is the special `self` Entity.
+ *
+ * Canonical home: `@elizaos/shared`. The DB-backed `EntityStore` lives in
+ * `@elizaos/plugin-personal-assistant`; the `LifeOpsEntity` wire contract in
+ * `@elizaos/shared/contracts/personal-assistant` re-exports these shapes.
+ */
+/**
+ * Built-in entity types. The registry accepts any string, but these are the
+ * shapes the runtime understands without registration. Open string with
+ * registered metadata via {@link EntityTypeRegistry}.
+ */
+export const BUILT_IN_ENTITY_TYPES = [
+    "person",
+    "organization",
+    "place",
+    "project",
+    "concept",
+];
+/**
+ * The identifier of the `self` Entity. Bootstrapped on first store init.
+ * All ego-network edges originate from `self`.
+ */
+export const SELF_ENTITY_ID = "self";
+/**
+ * Open-string registry of entity types. Built-ins always validate; new types
+ * are registered with optional metadata (display label, default visibility).
+ *
+ * Registration is idempotent (re-registering the same key with the same
+ * metadata is a no-op). Conflicting metadata throws.
+ */
+export class EntityTypeRegistry {
+    registered = new Map();
+    constructor() {
+        for (const type of BUILT_IN_ENTITY_TYPES) {
+            this.registered.set(type, {
+                label: type,
+                defaultVisibility: "owner_agent_admin",
+            });
+        }
+    }
+    register(type, metadata = {}) {
+        const next = {
+            label: metadata.label ?? type,
+            defaultVisibility: metadata.defaultVisibility ?? "owner_agent_admin",
+        };
+        const existing = this.registered.get(type);
+        if (existing) {
+            if (existing.label !== next.label ||
+                existing.defaultVisibility !== next.defaultVisibility) {
+                throw new Error(`[EntityTypeRegistry] type "${type}" already registered with different metadata`);
+            }
+            return;
+        }
+        this.registered.set(type, next);
+    }
+    has(type) {
+        return this.registered.has(type);
+    }
+    list() {
+        return Array.from(this.registered.keys()).sort();
+    }
+    metadataFor(type) {
+        return this.registered.get(type) ?? null;
+    }
+}
+/**
+ * Shared default registry instance. Tests construct their own.
+ */
+export const defaultEntityTypeRegistry = new EntityTypeRegistry();
+//# sourceMappingURL=entity-types.js.map

package/knowledge-graph/entity-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-types.js","sourceRoot":"","sources":["../../src/knowledge-graph/entity-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ;IACR,cAAc;IACd,OAAO;IACP,SAAS;IACT,SAAS;CACD,CAAC;AAIX;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AAwGrC;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IACZ,UAAU,GAAG,IAAI,GAAG,EAGlC,CAAC;IAEJ;QACE,KAAK,MAAM,IAAI,IAAI,qBAAqB,EAAE,CAAC;YACzC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE;gBACxB,KAAK,EAAE,IAAI;gBACX,iBAAiB,EAAE,mBAAmB;aACvC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,QAAQ,CACN,IAAY,EACZ,WAAqE,EAAE;QAEvE,MAAM,IAAI,GAAG;YACX,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,IAAI;YAC7B,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,IAAI,mBAAmB;SACrE,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,QAAQ,EAAE,CAAC;YACb,IACE,QAAQ,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK;gBAC7B,QAAQ,CAAC,iBAAiB,KAAK,IAAI,CAAC,iBAAiB,EACrD,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,8BAA8B,IAAI,8CAA8C,CACjF,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,CAAC;IAED,WAAW,CACT,IAAY;QAEZ,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IAC3C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,kBAAkB,EAAE,CAAC"}

package/knowledge-graph/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Knowledge-graph primitives (canonical, runtime-level).
+ *
+ * Pure types + the identity-merge engine for the Entity/Relationship graph.
+ * Dependency-free: no DB, no `@elizaos/core`, no plugin imports. The DB-backed
+ * `EntityStore` / `RelationshipStore` live in
+ * `@elizaos/plugin-personal-assistant`; the wire contracts in
+ * `@elizaos/shared/contracts/personal-assistant` re-export these shapes.
+ */
+export * from "./entity-types.js";
+export * from "./merge.js";
+export * from "./relationship-types.js";
+//# sourceMappingURL=index.d.ts.map

package/knowledge-graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/knowledge-graph/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC"}

package/knowledge-graph/index.js

@@ -0,0 +1,13 @@
+/**
+ * Knowledge-graph primitives (canonical, runtime-level).
+ *
+ * Pure types + the identity-merge engine for the Entity/Relationship graph.
+ * Dependency-free: no DB, no `@elizaos/core`, no plugin imports. The DB-backed
+ * `EntityStore` / `RelationshipStore` live in
+ * `@elizaos/plugin-personal-assistant`; the wire contracts in
+ * `@elizaos/shared/contracts/personal-assistant` re-export these shapes.
+ */
+export * from "./entity-types.js";
+export * from "./merge.js";
+export * from "./relationship-types.js";
+//# sourceMappingURL=index.js.map

package/knowledge-graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/knowledge-graph/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC"}

package/knowledge-graph/merge.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Identity-merge engine for the knowledge graph (canonical, runtime-level).
+ *
+ * Pure functions: given a set of Entity records and a new identity
+ * observation, decide which existing entities (if any) are the same and
+ * how to fold the new identity in. Preserves provenance — every collapsed
+ * identity keeps its evidence trail, no observation is silently discarded.
+ *
+ * The DB-backed `EntityStore` (in `@elizaos/plugin-personal-assistant`) calls
+ * into this from both `observeIdentity` (auto-merge on (platform, handle)
+ * match) and explicit `merge(target, sources)`.
+ */
+import type { Entity, EntityIdentity } from "./entity-types.js";
+/**
+ * Threshold at which `observeIdentity` will auto-merge a new observation
+ * into an existing entity without surfacing an approval task. Below this,
+ * the observation is recorded but the merge becomes a proposal that the
+ * scheduled-task layer surfaces for user confirmation.
+ */
+export declare const AUTO_MERGE_CONFIDENCE_THRESHOLD = 0.85;
+/** Confidence at which a new identity claim outright overrides an existing
+ * lower-confidence claim with the same (platform, handle). */
+export declare const OVERRIDE_CONFIDENCE_DELTA = 0.15;
+export interface IdentityMatchInput {
+    platform: string;
+    handle: string;
+    confidence: number;
+    /** Operator-confirmed (true) overrides auto-observed (false) on ties. */
+    verified?: boolean;
+}
+/**
+ * Find the entities whose identities collide on `(platform, handle)`.
+ * Multiple matches indicate a conflict (the same handle is claimed by
+ * different entities) — the caller surfaces this for approval.
+ */
+export declare function findIdentityMatches(entities: Entity[], match: IdentityMatchInput): Entity[];
+/**
+ * Decide the outcome of an `observeIdentity` call:
+ *  - "create": no match; create a new entity with this identity.
+ *  - "merge": exactly one match; fold the new identity in.
+ *  - "conflict": multiple matches OR the match is below the auto-merge
+ *    threshold; surface for user approval.
+ */
+export type IdentityObserveOutcome = {
+    kind: "create";
+} | {
+    kind: "merge";
+    targetEntityId: string;
+} | {
+    kind: "conflict";
+    candidateEntityIds: string[];
+    reason: string;
+};
+export declare function decideIdentityOutcome(args: {
+    candidates: Entity[];
+    newConfidence: number;
+}): IdentityObserveOutcome;
+/**
+ * Fold a new identity into an existing entity's identities array. If the
+ * (platform, handle) already exists, evidence is concatenated (deduped) and
+ * the higher-confidence claim wins. Otherwise, the new identity is
+ * appended.
+ */
+export declare function foldIdentity(existing: EntityIdentity[], next: EntityIdentity): EntityIdentity[];
+/**
+ * Explicit merge: take a target entity and fold N source entities into it,
+ * preserving every identity, attribute, and tag. Returns the merged entity
+ * (caller persists it and removes the sources). Provenance is preserved
+ * verbatim — no identity is dropped, only deduplicated by (platform, handle).
+ */
+export declare function mergeEntities(args: {
+    target: Entity;
+    sources: Entity[];
+    now: string;
+}): Entity;
+//# sourceMappingURL=merge.d.ts.map

package/knowledge-graph/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/knowledge-graph/merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAEpD;8DAC8D;AAC9D,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,EAAE,kBAAkB,GACxB,MAAM,EAAE,CAUV;AAED;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,sBAAsB,CA0BzB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,cAAc,EAAE,EAC1B,IAAI,EAAE,cAAc,GACnB,cAAc,EAAE,CAmDlB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,MAAM,CAiET"}

package/knowledge-graph/merge.js

@@ -0,0 +1,175 @@
+/**
+ * Identity-merge engine for the knowledge graph (canonical, runtime-level).
+ *
+ * Pure functions: given a set of Entity records and a new identity
+ * observation, decide which existing entities (if any) are the same and
+ * how to fold the new identity in. Preserves provenance — every collapsed
+ * identity keeps its evidence trail, no observation is silently discarded.
+ *
+ * The DB-backed `EntityStore` (in `@elizaos/plugin-personal-assistant`) calls
+ * into this from both `observeIdentity` (auto-merge on (platform, handle)
+ * match) and explicit `merge(target, sources)`.
+ */
+/**
+ * Threshold at which `observeIdentity` will auto-merge a new observation
+ * into an existing entity without surfacing an approval task. Below this,
+ * the observation is recorded but the merge becomes a proposal that the
+ * scheduled-task layer surfaces for user confirmation.
+ */
+export const AUTO_MERGE_CONFIDENCE_THRESHOLD = 0.85;
+/** Confidence at which a new identity claim outright overrides an existing
+ * lower-confidence claim with the same (platform, handle). */
+export const OVERRIDE_CONFIDENCE_DELTA = 0.15;
+/**
+ * Find the entities whose identities collide on `(platform, handle)`.
+ * Multiple matches indicate a conflict (the same handle is claimed by
+ * different entities) — the caller surfaces this for approval.
+ */
+export function findIdentityMatches(entities, match) {
+    const platformKey = match.platform.toLowerCase();
+    const handleKey = match.handle.toLowerCase();
+    return entities.filter((entity) => entity.identities.some((identity) => identity.platform.toLowerCase() === platformKey &&
+        identity.handle.toLowerCase() === handleKey));
+}
+export function decideIdentityOutcome(args) {
+    if (args.candidates.length === 0) {
+        return { kind: "create" };
+    }
+    if (args.candidates.length === 1) {
+        const target = args.candidates[0];
+        if (!target) {
+            return { kind: "create" };
+        }
+        if (args.newConfidence >= AUTO_MERGE_CONFIDENCE_THRESHOLD) {
+            return { kind: "merge", targetEntityId: target.entityId };
+        }
+        // Below threshold — store the observation but flag for approval.
+        return {
+            kind: "conflict",
+            candidateEntityIds: [target.entityId],
+            reason: "low_confidence_observation",
+        };
+    }
+    return {
+        kind: "conflict",
+        candidateEntityIds: args.candidates.map((entity) => entity.entityId),
+        reason: "multiple_candidate_entities",
+    };
+}
+/**
+ * Fold a new identity into an existing entity's identities array. If the
+ * (platform, handle) already exists, evidence is concatenated (deduped) and
+ * the higher-confidence claim wins. Otherwise, the new identity is
+ * appended.
+ */
+export function foldIdentity(existing, next) {
+    const platformKey = next.platform.toLowerCase();
+    const handleKey = next.handle.toLowerCase();
+    const matchIndex = existing.findIndex((identity) => identity.platform.toLowerCase() === platformKey &&
+        identity.handle.toLowerCase() === handleKey);
+    if (matchIndex < 0) {
+        return [...existing, next];
+    }
+    const match = existing[matchIndex];
+    if (!match) {
+        return [...existing, next];
+    }
+    const mergedEvidence = Array.from(new Set([...match.evidence, ...next.evidence]));
+    // Conflict resolution per W1-E spec:
+    //   - highest-confidence claim wins
+    //   - on confidence ties, verified: true wins over verified: false
+    //   - if still ambiguous, keep the existing (older) claim's metadata
+    //     and merely strengthen evidence + bump confidence to the higher of
+    //     the two; the merger surfaces the ambiguity through the conflict
+    //     path before reaching this point.
+    let chosen = match;
+    if (next.confidence > match.confidence) {
+        chosen = next;
+    }
+    else if (next.confidence === match.confidence &&
+        next.verified &&
+        !match.verified) {
+        chosen = next;
+    }
+    const merged = {
+        ...chosen,
+        confidence: Math.max(match.confidence, next.confidence),
+        verified: match.verified || next.verified,
+        evidence: mergedEvidence,
+        addedAt: match.addedAt,
+        addedVia: chosen.addedVia,
+        ...(chosen.displayName ? { displayName: chosen.displayName } : {}),
+    };
+    const result = [...existing];
+    result[matchIndex] = merged;
+    return result;
+}
+/**
+ * Explicit merge: take a target entity and fold N source entities into it,
+ * preserving every identity, attribute, and tag. Returns the merged entity
+ * (caller persists it and removes the sources). Provenance is preserved
+ * verbatim — no identity is dropped, only deduplicated by (platform, handle).
+ */
+export function mergeEntities(args) {
+    let identities = [...args.target.identities];
+    const tags = new Set(args.target.tags);
+    const attributes = { ...(args.target.attributes ?? {}) };
+    const seenLastObserved = [args.target.state.lastObservedAt ?? ""];
+    const seenLastInbound = [args.target.state.lastInboundAt ?? ""];
+    const seenLastOutbound = [args.target.state.lastOutboundAt ?? ""];
+    for (const source of args.sources) {
+        for (const identity of source.identities) {
+            identities = foldIdentity(identities, identity);
+        }
+        for (const tag of source.tags) {
+            tags.add(tag);
+        }
+        for (const [key, attr] of Object.entries(source.attributes ?? {})) {
+            const existing = attributes[key];
+            if (!existing || attr.confidence > existing.confidence) {
+                attributes[key] = attr;
+            }
+            else if (attr.confidence === existing.confidence) {
+                attributes[key] = {
+                    ...existing,
+                    evidence: Array.from(new Set([...existing.evidence, ...attr.evidence])),
+                };
+            }
+        }
+        if (source.state.lastObservedAt) {
+            seenLastObserved.push(source.state.lastObservedAt);
+        }
+        if (source.state.lastInboundAt) {
+            seenLastInbound.push(source.state.lastInboundAt);
+        }
+        if (source.state.lastOutboundAt) {
+            seenLastOutbound.push(source.state.lastOutboundAt);
+        }
+    }
+    const pickLatest = (values) => {
+        const filtered = values.filter((v) => v.length > 0);
+        if (filtered.length === 0)
+            return undefined;
+        return filtered.reduce((acc, cur) => (cur > acc ? cur : acc));
+    };
+    return {
+        ...args.target,
+        identities,
+        tags: Array.from(tags).sort(),
+        attributes: Object.keys(attributes).length > 0 ? attributes : args.target.attributes,
+        state: {
+            ...args.target.state,
+            ...(pickLatest(seenLastObserved)
+                ? { lastObservedAt: pickLatest(seenLastObserved) }
+                : {}),
+            ...(pickLatest(seenLastInbound)
+                ? { lastInboundAt: pickLatest(seenLastInbound) }
+                : {}),
+            ...(pickLatest(seenLastOutbound)
+                ? { lastOutboundAt: pickLatest(seenLastOutbound) }
+                : {}),
+        },
+        updatedAt: args.now,
+    };
+}
+//# sourceMappingURL=merge.js.map

package/knowledge-graph/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../src/knowledge-graph/merge.ts"],"names":[],"mappings":"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"}

package/knowledge-graph/relationship-types.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Relationship types for the knowledge graph (canonical, runtime-level).
+ *
+ * A Relationship is a typed edge between two Entities, carrying its own
+ * metadata (cadence, role, sentiment) and state (last-interaction, count,
+ * sentiment trend). Each edge has its own provenance trail.
+ *
+ * Canonical home: `@elizaos/shared`. The DB-backed `RelationshipStore` lives in
+ * `@elizaos/plugin-personal-assistant`; the `LifeOpsGraphRelationship` wire
+ * contract in `@elizaos/shared/contracts/personal-assistant` re-exports these
+ * shapes.
+ */
+/**
+ * Built-in relationship types. The registry accepts any string, but these
+ * are the shapes the planner / followup-watcher / extraction know about
+ * without registration.
+ */
+export declare const BUILT_IN_RELATIONSHIP_TYPES: readonly ["follows", "colleague_of", "partner_of", "manages", "managed_by", "lives_at", "works_at", "knows", "owns"];
+export type BuiltInRelationshipType = (typeof BUILT_IN_RELATIONSHIP_TYPES)[number];
+export type RelationshipSource = "user_chat" | "platform_observation" | "extraction" | "import" | "system";
+export type RelationshipSentiment = "positive" | "neutral" | "negative";
+export type RelationshipStatus = "active" | "retired";
+/**
+ * Per-edge interaction state. Distinct from `Entity.state` — this is the
+ * cadence + last-interaction tied to a specific (from, to, type) triple.
+ * The cadence override (`metadata.cadenceDays`) lives on the edge so that
+ * "Pat as colleague" and "Pat as friend" can have separate follow-up
+ * cadences against the same person.
+ */
+export interface RelationshipState {
+    lastObservedAt?: string;
+    lastInteractionAt?: string;
+    interactionCount?: number;
+    sentimentTrend?: RelationshipSentiment;
+}
+/**
+ * The canonical Relationship shape. A typed edge from `fromEntityId` to
+ * `toEntityId`; the user is `entityId === "self"` for ego-network edges.
+ */
+export interface Relationship {
+    relationshipId: string;
+    fromEntityId: string;
+    toEntityId: string;
+    type: string;
+    /**
+     * Per-type metadata. Examples:
+     *   - `{ cadenceDays: 14 }` for `follows`
+     *   - `{ role: "engineer" }` for `works_at`
+     *   - `{ sinceDate: "2020-01-01" }` for `partner_of`
+     */
+    metadata?: Record<string, unknown>;
+    state: RelationshipState;
+    evidence: string[];
+    /** 0..1 confidence in the edge. */
+    confidence: number;
+    source: RelationshipSource;
+    /**
+     * Soft-delete state. Retired edges remain queryable for audit but are
+     * filtered out of `list()` by default and never strengthened by new
+     * observations — new evidence on a retired edge is logged but does NOT
+     * flip it back to active.
+     */
+    status: RelationshipStatus;
+    retiredAt?: string;
+    retiredReason?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Filter for `RelationshipStore.list`. All fields optional, AND-combined.
+ */
+export interface RelationshipFilter {
+    fromEntityId?: string;
+    toEntityId?: string;
+    type?: string | string[];
+    metadataMatch?: Record<string, unknown>;
+    /**
+     * Returns edges where `metadata.cadenceDays` exists AND
+     * `state.lastInteractionAt < (asOf - cadenceDays)`. Read by the
+     * followup-starter watcher (W1-D).
+     */
+    cadenceOverdueAsOf?: string;
+    /** Include retired edges. Default false. */
+    includeRetired?: boolean;
+    limit?: number;
+}
+/**
+ * Open-string registry for relationship types. Built-ins always validate;
+ * new types may register typed metadata schemas via {@link metadataKeys}.
+ * The runtime does not branch on type — the registry is informational.
+ */
+export declare class RelationshipTypeRegistry {
+    private readonly registered;
+    constructor();
+    register(type: string, metadata?: {
+        label?: string;
+        metadataKeys?: string[];
+        symmetric?: boolean;
+    }): void;
+    has(type: string): boolean;
+    isSymmetric(type: string): boolean;
+    list(): string[];
+}
+export declare const defaultRelationshipTypeRegistry: RelationshipTypeRegistry;
+//# sourceMappingURL=relationship-types.d.ts.map

package/knowledge-graph/relationship-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-types.d.ts","sourceRoot":"","sources":["../../src/knowledge-graph/relationship-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,sHAU9B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,sBAAsB,GACtB,YAAY,GACZ,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAExE,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,EAAE,iBAAiB,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,kBAAkB,CAAC;IAC3B;;;;;OAKG;IACH,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4CAA4C;IAC5C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAGvB;;IAmDJ,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,SAAS,CAAC,EAAE,OAAO,CAAC;KAChB,GACL,IAAI;IA2BP,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC,IAAI,IAAI,MAAM,EAAE;CAGjB;AAED,eAAO,MAAM,+BAA+B,0BAAiC,CAAC"}