@elizaos/plugin-relationships 2.0.3-beta.5 → 2.0.3-beta.7

package/dist/index.js

@@ -0,0 +1,36 @@
+import { entityAction } from "./actions/entity.js";
+import {
+  EMPTY_RELATIONSHIPS,
+  RelationshipsSpatialView
+} from "./components/relationships/RelationshipsSpatialView.js";
+import { RelationshipsView } from "./components/relationships/RelationshipsView.js";
+import {
+  entitiesTable,
+  relationshipsSchema,
+  relationshipsTable
+} from "./db/schema.js";
+import { relationshipsPlugin } from "./plugin.js";
+import { entityGraphProvider } from "./providers/entity-graph.js";
+import {
+  registerRelationshipsTerminalView,
+  setRelationshipsTerminalSnapshot
+} from "./register-terminal-view.js";
+export * from "./types.js";
+import { relationshipsPlugin as relationshipsPlugin2 } from "./plugin.js";
+var index_default = relationshipsPlugin2;
+import "./register.js";
+export {
+  EMPTY_RELATIONSHIPS,
+  RelationshipsSpatialView,
+  RelationshipsView,
+  index_default as default,
+  entitiesTable,
+  entityAction,
+  entityGraphProvider,
+  registerRelationshipsTerminalView,
+  relationshipsPlugin,
+  relationshipsSchema,
+  relationshipsTable,
+  setRelationshipsTerminalSnapshot
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type { EntityActionParameters } from \"./actions/entity.js\";\nexport { entityAction } from \"./actions/entity.js\";\nexport {\n  EMPTY_RELATIONSHIPS,\n  type EntityNode,\n  type KindFilter,\n  type RelationshipEdge,\n  type RelationshipsSnapshot,\n  RelationshipsSpatialView,\n  type RelationshipsViewState,\n} from \"./components/relationships/RelationshipsSpatialView.js\";\nexport { RelationshipsView } from \"./components/relationships/RelationshipsView.js\";\nexport {\n  type EntityInsert,\n  type EntityRow,\n  entitiesTable,\n  type RelationshipInsert,\n  type RelationshipRow,\n  relationshipsSchema,\n  relationshipsTable,\n} from \"./db/schema.js\";\nexport { relationshipsPlugin } from \"./plugin.js\";\nexport { entityGraphProvider } from \"./providers/entity-graph.js\";\nexport {\n  registerRelationshipsTerminalView,\n  setRelationshipsTerminalSnapshot,\n} from \"./register-terminal-view.js\";\nexport * from \"./types.js\";\n\nimport { relationshipsPlugin } from \"./plugin.js\";\n\nexport default relationshipsPlugin;\n\n// Side-effect: in a terminal host (Node agent, no DOM) this registers the\n// relationships terminal view. DOM-guarded so the terminal engine stays out of\n// browser bundles.\nimport \"./register.js\";\n"],"mappings":"AACA,SAAS,oBAAoB;AAC7B;AAAA,EACE;AAAA,EAKA;AAAA,OAEK;AACP,SAAS,yBAAyB;AAClC;AAAA,EAGE;AAAA,EAGA;AAAA,EACA;AAAA,OACK;AACP,SAAS,2BAA2B;AACpC,SAAS,2BAA2B;AACpC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,cAAc;AAEd,SAAS,uBAAAA,4BAA2B;AAEpC,IAAO,gBAAQA;AAKf,OAAO;","names":["relationshipsPlugin"]}

package/dist/plugin.d.ts

@@ -0,0 +1,23 @@
+import type { Plugin } from "@elizaos/core";
+/**
+ * `@elizaos/plugin-relationships`
+ *
+ * The relationships viewer + "extras" over the runtime knowledge graph. The
+ * graph itself (`EntityStore` / `RelationshipStore`) is owned by the runtime:
+ * `@elizaos/agent`'s `KnowledgeGraphService`. This plugin consumes it via
+ * `resolveKnowledgeGraphService(runtime)` and adds:
+ *   - the `KNOWLEDGE_GRAPH` graph-CRUD action,
+ *   - the `ENTITY_GRAPH` planner-context provider,
+ *   - the `/relationships` viewer.
+ *
+ * It does NOT register an `ENTITY` action — `@elizaos/plugin-personal-assistant`
+ * owns that (rich Rolodex orchestration with an LLM planner). Keeping a
+ * distinct action name avoids a duplicate `ENTITY` registration when both
+ * plugins load together.
+ *
+ * Hard-depends on `@elizaos/plugin-sql` — the runtime registers migrations
+ * from `schema` (this module's drizzle pgSchema('app_relationships')).
+ */
+export declare const relationshipsPlugin: Plugin;
+export default relationshipsPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAM5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAyBjC,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,33 @@
+import { entityAction } from "./actions/entity.js";
+import * as dbSchema from "./db/index.js";
+import { entityGraphProvider } from "./providers/entity-graph.js";
+const relationshipsPlugin = {
+  name: "relationships",
+  description: "Relationships viewer + extras over the runtime knowledge graph. Provides the KNOWLEDGE_GRAPH graph-CRUD action (create/read/list/log_interaction/set_identity/set_relationship/merge over the runtime EntityStore/RelationshipStore), the ENTITY_GRAPH planner-context provider, the /relationships viewer, and a drizzle pgSchema('app_relationships'). The graph stores are owned by @elizaos/agent's KnowledgeGraphService; contact orchestration stays in @elizaos/plugin-personal-assistant.",
+  dependencies: ["@elizaos/plugin-sql"],
+  actions: [entityAction],
+  providers: [entityGraphProvider],
+  services: [],
+  schema: dbSchema,
+  views: [
+    {
+      id: "relationships",
+      label: "Relationships",
+      description: "Entity and relationship knowledge-graph viewer: people, organizations, identities, and the typed edges between them.",
+      icon: "Users",
+      path: "/relationships",
+      modalities: ["gui", "xr", "tui"],
+      bundlePath: "dist/views/bundle.js",
+      componentExport: "RelationshipsView",
+      tags: ["relationships", "entities", "people", "contacts", "graph"],
+      visibleInManager: true,
+      desktopTabEnabled: true
+    }
+  ]
+};
+var plugin_default = relationshipsPlugin;
+export {
+  plugin_default as default,
+  relationshipsPlugin
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["import type { Plugin } from \"@elizaos/core\";\n\nimport { entityAction } from \"./actions/entity.js\";\nimport * as dbSchema from \"./db/index.js\";\nimport { entityGraphProvider } from \"./providers/entity-graph.js\";\n\n/**\n * `@elizaos/plugin-relationships`\n *\n * The relationships viewer + \"extras\" over the runtime knowledge graph. The\n * graph itself (`EntityStore` / `RelationshipStore`) is owned by the runtime:\n * `@elizaos/agent`'s `KnowledgeGraphService`. This plugin consumes it via\n * `resolveKnowledgeGraphService(runtime)` and adds:\n *   - the `KNOWLEDGE_GRAPH` graph-CRUD action,\n *   - the `ENTITY_GRAPH` planner-context provider,\n *   - the `/relationships` viewer.\n *\n * It does NOT register an `ENTITY` action — `@elizaos/plugin-personal-assistant`\n * owns that (rich Rolodex orchestration with an LLM planner). Keeping a\n * distinct action name avoids a duplicate `ENTITY` registration when both\n * plugins load together.\n *\n * Hard-depends on `@elizaos/plugin-sql` — the runtime registers migrations\n * from `schema` (this module's drizzle pgSchema('app_relationships')).\n */\nexport const relationshipsPlugin: Plugin = {\n  name: \"relationships\",\n  description:\n    \"Relationships viewer + extras over the runtime knowledge graph. Provides the KNOWLEDGE_GRAPH graph-CRUD action (create/read/list/log_interaction/set_identity/set_relationship/merge over the runtime EntityStore/RelationshipStore), the ENTITY_GRAPH planner-context provider, the /relationships viewer, and a drizzle pgSchema('app_relationships'). The graph stores are owned by @elizaos/agent's KnowledgeGraphService; contact orchestration stays in @elizaos/plugin-personal-assistant.\",\n  dependencies: [\"@elizaos/plugin-sql\"],\n  actions: [entityAction],\n  providers: [entityGraphProvider],\n  services: [],\n  schema: dbSchema,\n  views: [\n    {\n      id: \"relationships\",\n      label: \"Relationships\",\n      description:\n        \"Entity and relationship knowledge-graph viewer: people, organizations, identities, and the typed edges between them.\",\n      icon: \"Users\",\n      path: \"/relationships\",\n      modalities: [\"gui\", \"xr\", \"tui\"],\n      bundlePath: \"dist/views/bundle.js\",\n      componentExport: \"RelationshipsView\",\n      tags: [\"relationships\", \"entities\", \"people\", \"contacts\", \"graph\"],\n      visibleInManager: true,\n      desktopTabEnabled: true,\n    },\n  ],\n};\n\nexport default relationshipsPlugin;\n"],"mappings":"AAEA,SAAS,oBAAoB;AAC7B,YAAY,cAAc;AAC1B,SAAS,2BAA2B;AAqB7B,MAAM,sBAA8B;AAAA,EACzC,MAAM;AAAA,EACN,aACE;AAAA,EACF,cAAc,CAAC,qBAAqB;AAAA,EACpC,SAAS,CAAC,YAAY;AAAA,EACtB,WAAW,CAAC,mBAAmB;AAAA,EAC/B,UAAU,CAAC;AAAA,EACX,QAAQ;AAAA,EACR,OAAO;AAAA,IACL;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,aACE;AAAA,MACF,MAAM;AAAA,MACN,MAAM;AAAA,MACN,YAAY,CAAC,OAAO,MAAM,KAAK;AAAA,MAC/B,YAAY;AAAA,MACZ,iBAAiB;AAAA,MACjB,MAAM,CAAC,iBAAiB,YAAY,UAAU,YAAY,OAAO;AAAA,MACjE,kBAAkB;AAAA,MAClB,mBAAmB;AAAA,IACrB;AAAA,EACF;AACF;AAEA,IAAO,iBAAQ;","names":[]}

package/dist/providers/entity-graph.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `ENTITY_GRAPH` provider.
+ *
+ * Injects a compact projection of the owner's runtime knowledge graph
+ * (recently-updated people/organizations and the `self` ego-network edges)
+ * into the planner each turn, so the planner can reason about who is being
+ * discussed without re-querying the graph from inside an action handler.
+ *
+ * Reads the runtime-owned graph via `@elizaos/agent`'s
+ * {@link KnowledgeGraphService} (`getEntityStore` / `getRelationshipStore`).
+ * It does NOT construct DB stores itself.
+ *
+ * Distinct from the runtime `rolodex` provider (which projects the legacy
+ * `relationships` graph-snapshot service at position 7); this provider
+ * projects the new knowledge-graph stores at position -4.
+ */
+import type { Provider } from "@elizaos/core";
+export declare const entityGraphProvider: Provider;
+export default entityGraphProvider;
+//# sourceMappingURL=entity-graph.d.ts.map

package/dist/providers/entity-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-graph.d.ts","sourceRoot":"","sources":["../../src/providers/entity-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAGV,QAAQ,EAGT,MAAM,eAAe,CAAC;AAsBvB,eAAO,MAAM,mBAAmB,EAAE,QAuFjC,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/providers/entity-graph.js

@@ -0,0 +1,83 @@
+import { resolveKnowledgeGraphService } from "@elizaos/agent";
+import { logger } from "@elizaos/core";
+import { SELF_ENTITY_ID } from "@elizaos/shared";
+import { RELATIONSHIPS_CONTEXTS, RELATIONSHIPS_LOG_PREFIX } from "../types.js";
+const MAX_ENTITIES = 8;
+const MAX_EDGES = 8;
+const entityGraphProvider = {
+  name: "ENTITY_GRAPH",
+  description: "Projection of the owner's known entities and ego-network edges from the runtime knowledge graph, for planner context.",
+  position: -4,
+  contexts: [...RELATIONSHIPS_CONTEXTS],
+  contextGate: { anyOf: [...RELATIONSHIPS_CONTEXTS] },
+  get: async (runtime, _message, _state) => {
+    const service = resolveKnowledgeGraphService(runtime);
+    if (!service) {
+      return { text: "", data: { entities: [], relationships: [] } };
+    }
+    try {
+      const entityStore = service.getEntityStore();
+      const relationshipStore = service.getRelationshipStore();
+      const [entities, edges] = await Promise.all([
+        entityStore.list({ limit: MAX_ENTITIES }),
+        relationshipStore.list({
+          fromEntityId: SELF_ENTITY_ID,
+          limit: MAX_EDGES
+        })
+      ]);
+      const entityProjections = entities.filter((entity) => entity.entityId !== SELF_ENTITY_ID).map((entity) => ({
+        entityId: entity.entityId,
+        type: entity.type,
+        preferredName: entity.preferredName,
+        platforms: Array.from(
+          new Set(entity.identities.map((identity) => identity.platform))
+        )
+      }));
+      const edgeProjections = edges.map((edge) => ({
+        fromEntityId: edge.fromEntityId,
+        toEntityId: edge.toEntityId,
+        type: edge.type
+      }));
+      if (entityProjections.length === 0 && edgeProjections.length === 0) {
+        return { text: "", data: { entities: [], relationships: [] } };
+      }
+      const nameById = new Map(
+        entities.map((entity) => [entity.entityId, entity.preferredName])
+      );
+      const lines = [];
+      if (entityProjections.length > 0) {
+        lines.push("Known entities:");
+        for (const entity of entityProjections) {
+          const platforms = entity.platforms.length > 0 ? ` [${entity.platforms.join(", ")}]` : "";
+          lines.push(`- ${entity.preferredName} (${entity.type})${platforms}`);
+        }
+      }
+      if (edgeProjections.length > 0) {
+        lines.push("Your relationships:");
+        for (const edge of edgeProjections) {
+          const toName = nameById.get(edge.toEntityId) ?? edge.toEntityId;
+          lines.push(`- you -[${edge.type}]-> ${toName}`);
+        }
+      }
+      return {
+        text: lines.join("\n"),
+        data: {
+          entities: entityProjections,
+          relationships: edgeProjections
+        }
+      };
+    } catch (error) {
+      logger.error(
+        `${RELATIONSHIPS_LOG_PREFIX} ENTITY_GRAPH projection failed:`,
+        error instanceof Error ? error.message : String(error)
+      );
+      return { text: "", data: { entities: [], relationships: [] } };
+    }
+  }
+};
+var entity_graph_default = entityGraphProvider;
+export {
+  entity_graph_default as default,
+  entityGraphProvider
+};
+//# sourceMappingURL=entity-graph.js.map

package/dist/providers/entity-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/entity-graph.ts"],"sourcesContent":["/**\n * `ENTITY_GRAPH` provider.\n *\n * Injects a compact projection of the owner's runtime knowledge graph\n * (recently-updated people/organizations and the `self` ego-network edges)\n * into the planner each turn, so the planner can reason about who is being\n * discussed without re-querying the graph from inside an action handler.\n *\n * Reads the runtime-owned graph via `@elizaos/agent`'s\n * {@link KnowledgeGraphService} (`getEntityStore` / `getRelationshipStore`).\n * It does NOT construct DB stores itself.\n *\n * Distinct from the runtime `rolodex` provider (which projects the legacy\n * `relationships` graph-snapshot service at position 7); this provider\n * projects the new knowledge-graph stores at position -4.\n */\n\nimport { resolveKnowledgeGraphService } from \"@elizaos/agent\";\nimport type {\n  IAgentRuntime,\n  Memory,\n  Provider,\n  ProviderResult,\n  State,\n} from \"@elizaos/core\";\nimport { logger } from \"@elizaos/core\";\nimport { SELF_ENTITY_ID } from \"@elizaos/shared\";\n\nimport { RELATIONSHIPS_CONTEXTS, RELATIONSHIPS_LOG_PREFIX } from \"../types.js\";\n\nconst MAX_ENTITIES = 8;\nconst MAX_EDGES = 8;\n\ninterface EntityProjection {\n  entityId: string;\n  type: string;\n  preferredName: string;\n  platforms: string[];\n}\n\ninterface EdgeProjection {\n  fromEntityId: string;\n  toEntityId: string;\n  type: string;\n}\n\nexport const entityGraphProvider: Provider = {\n  name: \"ENTITY_GRAPH\",\n  description:\n    \"Projection of the owner's known entities and ego-network edges from the runtime knowledge graph, for planner context.\",\n  position: -4,\n  contexts: [...RELATIONSHIPS_CONTEXTS],\n  contextGate: { anyOf: [...RELATIONSHIPS_CONTEXTS] },\n  get: async (\n    runtime: IAgentRuntime,\n    _message: Memory,\n    _state?: State,\n  ): Promise<ProviderResult> => {\n    const service = resolveKnowledgeGraphService(runtime);\n    if (!service) {\n      return { text: \"\", data: { entities: [], relationships: [] } };\n    }\n\n    try {\n      const entityStore = service.getEntityStore();\n      const relationshipStore = service.getRelationshipStore();\n\n      const [entities, edges] = await Promise.all([\n        entityStore.list({ limit: MAX_ENTITIES }),\n        relationshipStore.list({\n          fromEntityId: SELF_ENTITY_ID,\n          limit: MAX_EDGES,\n        }),\n      ]);\n\n      const entityProjections: EntityProjection[] = entities\n        .filter((entity) => entity.entityId !== SELF_ENTITY_ID)\n        .map((entity) => ({\n          entityId: entity.entityId,\n          type: entity.type,\n          preferredName: entity.preferredName,\n          platforms: Array.from(\n            new Set(entity.identities.map((identity) => identity.platform)),\n          ),\n        }));\n\n      const edgeProjections: EdgeProjection[] = edges.map((edge) => ({\n        fromEntityId: edge.fromEntityId,\n        toEntityId: edge.toEntityId,\n        type: edge.type,\n      }));\n\n      if (entityProjections.length === 0 && edgeProjections.length === 0) {\n        return { text: \"\", data: { entities: [], relationships: [] } };\n      }\n\n      const nameById = new Map(\n        entities.map((entity) => [entity.entityId, entity.preferredName]),\n      );\n      const lines: string[] = [];\n      if (entityProjections.length > 0) {\n        lines.push(\"Known entities:\");\n        for (const entity of entityProjections) {\n          const platforms =\n            entity.platforms.length > 0\n              ? ` [${entity.platforms.join(\", \")}]`\n              : \"\";\n          lines.push(`- ${entity.preferredName} (${entity.type})${platforms}`);\n        }\n      }\n      if (edgeProjections.length > 0) {\n        lines.push(\"Your relationships:\");\n        for (const edge of edgeProjections) {\n          const toName = nameById.get(edge.toEntityId) ?? edge.toEntityId;\n          lines.push(`- you -[${edge.type}]-> ${toName}`);\n        }\n      }\n\n      return {\n        text: lines.join(\"\\n\"),\n        data: {\n          entities: entityProjections,\n          relationships: edgeProjections,\n        },\n      };\n    } catch (error) {\n      logger.error(\n        `${RELATIONSHIPS_LOG_PREFIX} ENTITY_GRAPH projection failed:`,\n        error instanceof Error ? error.message : String(error),\n      );\n      return { text: \"\", data: { entities: [], relationships: [] } };\n    }\n  },\n};\n\nexport default entityGraphProvider;\n"],"mappings":"AAiBA,SAAS,oCAAoC;AAQ7C,SAAS,cAAc;AACvB,SAAS,sBAAsB;AAE/B,SAAS,wBAAwB,gCAAgC;AAEjE,MAAM,eAAe;AACrB,MAAM,YAAY;AAeX,MAAM,sBAAgC;AAAA,EAC3C,MAAM;AAAA,EACN,aACE;AAAA,EACF,UAAU;AAAA,EACV,UAAU,CAAC,GAAG,sBAAsB;AAAA,EACpC,aAAa,EAAE,OAAO,CAAC,GAAG,sBAAsB,EAAE;AAAA,EAClD,KAAK,OACH,SACA,UACA,WAC4B;AAC5B,UAAM,UAAU,6BAA6B,OAAO;AACpD,QAAI,CAAC,SAAS;AACZ,aAAO,EAAE,MAAM,IAAI,MAAM,EAAE,UAAU,CAAC,GAAG,eAAe,CAAC,EAAE,EAAE;AAAA,IAC/D;AAEA,QAAI;AACF,YAAM,cAAc,QAAQ,eAAe;AAC3C,YAAM,oBAAoB,QAAQ,qBAAqB;AAEvD,YAAM,CAAC,UAAU,KAAK,IAAI,MAAM,QAAQ,IAAI;AAAA,QAC1C,YAAY,KAAK,EAAE,OAAO,aAAa,CAAC;AAAA,QACxC,kBAAkB,KAAK;AAAA,UACrB,cAAc;AAAA,UACd,OAAO;AAAA,QACT,CAAC;AAAA,MACH,CAAC;AAED,YAAM,oBAAwC,SAC3C,OAAO,CAAC,WAAW,OAAO,aAAa,cAAc,EACrD,IAAI,CAAC,YAAY;AAAA,QAChB,UAAU,OAAO;AAAA,QACjB,MAAM,OAAO;AAAA,QACb,eAAe,OAAO;AAAA,QACtB,WAAW,MAAM;AAAA,UACf,IAAI,IAAI,OAAO,WAAW,IAAI,CAAC,aAAa,SAAS,QAAQ,CAAC;AAAA,QAChE;AAAA,MACF,EAAE;AAEJ,YAAM,kBAAoC,MAAM,IAAI,CAAC,UAAU;AAAA,QAC7D,cAAc,KAAK;AAAA,QACnB,YAAY,KAAK;AAAA,QACjB,MAAM,KAAK;AAAA,MACb,EAAE;AAEF,UAAI,kBAAkB,WAAW,KAAK,gBAAgB,WAAW,GAAG;AAClE,eAAO,EAAE,MAAM,IAAI,MAAM,EAAE,UAAU,CAAC,GAAG,eAAe,CAAC,EAAE,EAAE;AAAA,MAC/D;AAEA,YAAM,WAAW,IAAI;AAAA,QACnB,SAAS,IAAI,CAAC,WAAW,CAAC,OAAO,UAAU,OAAO,aAAa,CAAC;AAAA,MAClE;AACA,YAAM,QAAkB,CAAC;AACzB,UAAI,kBAAkB,SAAS,GAAG;AAChC,cAAM,KAAK,iBAAiB;AAC5B,mBAAW,UAAU,mBAAmB;AACtC,gBAAM,YACJ,OAAO,UAAU,SAAS,IACtB,KAAK,OAAO,UAAU,KAAK,IAAI,CAAC,MAChC;AACN,gBAAM,KAAK,KAAK,OAAO,aAAa,KAAK,OAAO,IAAI,IAAI,SAAS,EAAE;AAAA,QACrE;AAAA,MACF;AACA,UAAI,gBAAgB,SAAS,GAAG;AAC9B,cAAM,KAAK,qBAAqB;AAChC,mBAAW,QAAQ,iBAAiB;AAClC,gBAAM,SAAS,SAAS,IAAI,KAAK,UAAU,KAAK,KAAK;AACrD,gBAAM,KAAK,WAAW,KAAK,IAAI,OAAO,MAAM,EAAE;AAAA,QAChD;AAAA,MACF;AAEA,aAAO;AAAA,QACL,MAAM,MAAM,KAAK,IAAI;AAAA,QACrB,MAAM;AAAA,UACJ,UAAU;AAAA,UACV,eAAe;AAAA,QACjB;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,aAAO;AAAA,QACL,GAAG,wBAAwB;AAAA,QAC3B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MACvD;AACA,aAAO,EAAE,MAAM,IAAI,MAAM,EAAE,UAAU,CAAC,GAAG,eAAe,CAAC,EAAE,EAAE;AAAA,IAC/D;AAAA,EACF;AACF;AAEA,IAAO,uBAAQ;","names":[]}

package/dist/register-terminal-view.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Register the relationships view for terminal rendering.
+ *
+ * The agent terminal mounts plugin views by id from the `@elizaos/tui` terminal
+ * registry. This makes the relationships `tui` modality render for real in the
+ * terminal (the unified {@link RelationshipsSpatialView}) rather than only
+ * navigating a GUI shell. A module-level snapshot lets a host push live graph
+ * data; absent a push it defaults to the loading state.
+ */
+import { type RelationshipsSnapshot } from "./components/relationships/RelationshipsSpatialView.tsx";
+/** Update the snapshot the registered terminal view renders from. */
+export declare function setRelationshipsTerminalSnapshot(next: RelationshipsSnapshot): void;
+/** Register the relationships terminal view; returns an unregister function. */
+export declare function registerRelationshipsTerminalView(): () => void;
+//# sourceMappingURL=register-terminal-view.d.ts.map

package/dist/register-terminal-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-terminal-view.d.ts","sourceRoot":"","sources":["../src/register-terminal-view.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAEL,KAAK,qBAAqB,EAE3B,MAAM,yDAAyD,CAAC;AAIjE,qEAAqE;AACrE,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,qBAAqB,GAC1B,IAAI,CAEN;AAED,gFAAgF;AAChF,wBAAgB,iCAAiC,IAAI,MAAM,IAAI,CAI9D"}

package/dist/register-terminal-view.js

@@ -0,0 +1,21 @@
+import { registerSpatialTerminalView } from "@elizaos/ui/spatial/tui";
+import { createElement } from "react";
+import {
+  EMPTY_RELATIONSHIPS,
+  RelationshipsSpatialView
+} from "./components/relationships/RelationshipsSpatialView.js";
+let current = EMPTY_RELATIONSHIPS;
+function setRelationshipsTerminalSnapshot(next) {
+  current = next;
+}
+function registerRelationshipsTerminalView() {
+  return registerSpatialTerminalView(
+    "relationships",
+    () => createElement(RelationshipsSpatialView, { snapshot: current })
+  );
+}
+export {
+  registerRelationshipsTerminalView,
+  setRelationshipsTerminalSnapshot
+};
+//# sourceMappingURL=register-terminal-view.js.map

package/dist/register-terminal-view.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/register-terminal-view.tsx"],"sourcesContent":["/**\n * Register the relationships view for terminal rendering.\n *\n * The agent terminal mounts plugin views by id from the `@elizaos/tui` terminal\n * registry. This makes the relationships `tui` modality render for real in the\n * terminal (the unified {@link RelationshipsSpatialView}) rather than only\n * navigating a GUI shell. A module-level snapshot lets a host push live graph\n * data; absent a push it defaults to the loading state.\n */\n\nimport { registerSpatialTerminalView } from \"@elizaos/ui/spatial/tui\";\nimport { createElement } from \"react\";\nimport {\n  EMPTY_RELATIONSHIPS,\n  type RelationshipsSnapshot,\n  RelationshipsSpatialView,\n} from \"./components/relationships/RelationshipsSpatialView.js\";\n\nlet current: RelationshipsSnapshot = EMPTY_RELATIONSHIPS;\n\n/** Update the snapshot the registered terminal view renders from. */\nexport function setRelationshipsTerminalSnapshot(\n  next: RelationshipsSnapshot,\n): void {\n  current = next;\n}\n\n/** Register the relationships terminal view; returns an unregister function. */\nexport function registerRelationshipsTerminalView(): () => void {\n  return registerSpatialTerminalView(\"relationships\", () =>\n    createElement(RelationshipsSpatialView, { snapshot: current }),\n  );\n}\n"],"mappings":"AAUA,SAAS,mCAAmC;AAC5C,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,EAEA;AAAA,OACK;AAEP,IAAI,UAAiC;AAG9B,SAAS,iCACd,MACM;AACN,YAAU;AACZ;AAGO,SAAS,oCAAgD;AAC9D,SAAO;AAAA,IAA4B;AAAA,IAAiB,MAClD,cAAc,0BAA0B,EAAE,UAAU,QAAQ,CAAC;AAAA,EAC/D;AACF;","names":[]}

package/dist/register.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Side-effect entry point — registers the Relationships view for terminal
+ * rendering.
+ *
+ * In a terminal host (the Node agent, no DOM), register the relationships view
+ * so it renders inline in the terminal. Lazy + DOM-guarded so the terminal
+ * engine stays out of browser/mobile bundles. Web, iOS, desktop, and Android
+ * leave this a no-op (a DOM is present), so the same import is safe everywhere.
+ */
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/register.js

@@ -0,0 +1,5 @@
+if (typeof window === "undefined") {
+  void import("./register-terminal-view.js").then((m) => m.registerRelationshipsTerminalView()).catch(() => {
+  });
+}
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/register.ts"],"sourcesContent":["/**\n * Side-effect entry point — registers the Relationships view for terminal\n * rendering.\n *\n * In a terminal host (the Node agent, no DOM), register the relationships view\n * so it renders inline in the terminal. Lazy + DOM-guarded so the terminal\n * engine stays out of browser/mobile bundles. Web, iOS, desktop, and Android\n * leave this a no-op (a DOM is present), so the same import is safe everywhere.\n */\n\nif (typeof window === \"undefined\") {\n  void import(\"./register-terminal-view.js\")\n    .then((m) => m.registerRelationshipsTerminalView())\n    .catch(() => {\n      // Terminal rendering is best-effort; never block plugin load.\n    });\n}\n"],"mappings":"AAUA,IAAI,OAAO,WAAW,aAAa;AACjC,OAAK,OAAO,6BAA6B,EACtC,KAAK,CAAC,MAAM,EAAE,kCAAkC,CAAC,EACjD,MAAM,MAAM;AAAA,EAEb,CAAC;AACL;","names":[]}

package/dist/types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Public TS types for `@elizaos/plugin-relationships`.
+ *
+ * These mirror the canonical LifeOps shapes in
+ * `plugins/plugin-personal-assistant/src/lifeops/entities/types.ts` and
+ * `plugins/plugin-personal-assistant/src/lifeops/relationships/types.ts`. The richer
+ * lifeops shapes (identities array, attributes map, retired status, sentiment
+ * trend, type registries) will be ported here in a follow-up pass; for now we
+ * expose the minimal Entity / Relationship surface that matches the DB schema
+ * in `db/schema.ts`.
+ */
+export declare const RELATIONSHIPS_LOG_PREFIX = "[Relationships]";
+export declare const RELATIONSHIPS_SERVICE_TYPE = "relationships";
+/**
+ * Action name for the relationships graph-CRUD umbrella.
+ *
+ * NOT `ENTITY`. `@elizaos/plugin-personal-assistant` already registers an
+ * `ENTITY` action: a rich orchestration over the legacy Rolodex contact model
+ * (`LifeOpsService.listRelationships/upsertRelationship/logInteraction`) with
+ * an LLM planner and voice-grounded replies. That action stays in PA. This
+ * action is the thin "extras" surface — direct CRUD over the runtime
+ * {@link KNOWLEDGE_GRAPH_SERVICE} graph that powers the relationships viewer —
+ * so it is registered under a distinct name to avoid a duplicate `ENTITY`
+ * registration when both plugins load together.
+ */
+export declare const RELATIONSHIPS_ACTION_NAME = "KNOWLEDGE_GRAPH";
+export declare const RELATIONSHIPS_CONTEXTS: readonly ["people", "contacts", "relationships"];
+export type RelationshipsContext = (typeof RELATIONSHIPS_CONTEXTS)[number];
+/**
+ * Built-in entity kinds. The store accepts any string, but these are what the
+ * runtime understands without registration. Mirrors
+ * `BUILT_IN_ENTITY_TYPES` in lifeops.
+ */
+export declare const BUILT_IN_ENTITY_KINDS: readonly ["person", "organization", "place", "project", "concept"];
+export type BuiltInEntityKind = (typeof BUILT_IN_ENTITY_KINDS)[number];
+/**
+ * Identifier of the `self` Entity — the agent's owner. All ego-network edges
+ * originate from `self`. Bootstrapped on first store init.
+ */
+export declare const SELF_ENTITY_ID = "self";
+/**
+ * Canonical entity-kind / op tuple accepted by the `ENTITY` action.
+ *
+ * Mirrors the `Subaction` union in
+ * `plugins/plugin-personal-assistant/src/actions/entity.ts`.
+ */
+export declare const ENTITY_OPS: readonly ["create", "read", "list", "log_interaction", "set_identity", "set_relationship", "merge"];
+export type EntityOp = (typeof ENTITY_OPS)[number];
+/**
+ * Minimal Entity shape. The full LifeOps `Entity` (see
+ * `lifeops/entities/types.ts`) carries `identities[]`, `attributes`, `state`,
+ * `tags`, and `visibility`. Those land in a follow-up port.
+ */
+export interface Entity {
+    id: string;
+    kind: string;
+    displayName: string;
+    attrs: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Minimal Relationship shape. The full LifeOps `Relationship` (see
+ * `lifeops/relationships/types.ts`) carries `type`, `metadata`, `state`,
+ * `evidence[]`, `confidence`, `source`, and `status` (active / retired).
+ */
+export interface Relationship {
+    id: string;
+    fromEntityId: string;
+    toEntityId: string;
+    kind: string;
+    attrs: Record<string, unknown>;
+    lastObservedAt: Date | null;
+}
+/**
+ * Filter shape for listing entities. AND-combined.
+ */
+export interface EntityFilter {
+    kind?: string;
+    nameContains?: string;
+    limit?: number;
+}
+/**
+ * Filter shape for listing relationships. AND-combined.
+ */
+export interface RelationshipFilter {
+    fromEntityId?: string;
+    toEntityId?: string;
+    kind?: string | string[];
+    limit?: number;
+}
+/**
+ * The entity-kind filter set the view offers. Mirrors
+ * {@link BUILT_IN_ENTITY_KINDS} with an `all` sentinel for "no filter".
+ */
+export declare const ENTITY_KIND_FILTERS: readonly ["person", "organization", "place", "project", "concept"];
+export type EntityKindFilter = (typeof ENTITY_KIND_FILTERS)[number];
+/** Human labels for the built-in entity kinds shown in the view. */
+export declare const ENTITY_KIND_LABELS: Record<string, string>;
+/**
+ * A single identity claim shown under an entity (platform + handle). Flattened
+ * from the wire `EntityIdentity`.
+ */
+export interface EntityIdentityItem {
+    platform: string;
+    handle: string;
+    verified: boolean;
+}
+/**
+ * A typed edge shown under its source entity. Flattened from the wire
+ * `Relationship`: the edge's type label, the resolved target display name, and
+ * the optional cadence / last-contact metadata the view surfaces.
+ */
+export interface RelationshipEdgeItem {
+    id: string;
+    type: string;
+    /** Display name of the target entity, or the raw id when unresolved. */
+    toName: string;
+    /** Cadence in days from `metadata.cadenceDays`, when present. */
+    cadenceDays: number | null;
+    /** ISO timestamp of the last interaction/observation on this edge. */
+    lastContact: string | null;
+}
+/**
+ * An entity node as the view renders it: identity + kind + its outbound edges.
+ */
+export interface EntityNodeItem {
+    id: string;
+    kind: string;
+    name: string;
+    identities: EntityIdentityItem[];
+    edges: RelationshipEdgeItem[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,wBAAwB,oBAAoB,CAAC;AAC1D,eAAO,MAAM,0BAA0B,kBAAkB,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAE3D,eAAO,MAAM,sBAAsB,kDAIzB,CAAC;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,oEAMxB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,cAAc,SAAS,CAAC;AAErC;;;;;GAKG;AACH,eAAO,MAAM,UAAU,qGAQb,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;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,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAYD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,oEAMtB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMrD,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sEAAsE;IACtE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B"}

package/dist/types.js

@@ -0,0 +1,51 @@
+const RELATIONSHIPS_LOG_PREFIX = "[Relationships]";
+const RELATIONSHIPS_SERVICE_TYPE = "relationships";
+const RELATIONSHIPS_ACTION_NAME = "KNOWLEDGE_GRAPH";
+const RELATIONSHIPS_CONTEXTS = [
+  "people",
+  "contacts",
+  "relationships"
+];
+const BUILT_IN_ENTITY_KINDS = [
+  "person",
+  "organization",
+  "place",
+  "project",
+  "concept"
+];
+const SELF_ENTITY_ID = "self";
+const ENTITY_OPS = [
+  "create",
+  "read",
+  "list",
+  "log_interaction",
+  "set_identity",
+  "set_relationship",
+  "merge"
+];
+const ENTITY_KIND_FILTERS = [
+  "person",
+  "organization",
+  "place",
+  "project",
+  "concept"
+];
+const ENTITY_KIND_LABELS = {
+  person: "People",
+  organization: "Organizations",
+  place: "Places",
+  project: "Projects",
+  concept: "Concepts"
+};
+export {
+  BUILT_IN_ENTITY_KINDS,
+  ENTITY_KIND_FILTERS,
+  ENTITY_KIND_LABELS,
+  ENTITY_OPS,
+  RELATIONSHIPS_ACTION_NAME,
+  RELATIONSHIPS_CONTEXTS,
+  RELATIONSHIPS_LOG_PREFIX,
+  RELATIONSHIPS_SERVICE_TYPE,
+  SELF_ENTITY_ID
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * Public TS types for `@elizaos/plugin-relationships`.\n *\n * These mirror the canonical LifeOps shapes in\n * `plugins/plugin-personal-assistant/src/lifeops/entities/types.ts` and\n * `plugins/plugin-personal-assistant/src/lifeops/relationships/types.ts`. The richer\n * lifeops shapes (identities array, attributes map, retired status, sentiment\n * trend, type registries) will be ported here in a follow-up pass; for now we\n * expose the minimal Entity / Relationship surface that matches the DB schema\n * in `db/schema.ts`.\n */\n\nexport const RELATIONSHIPS_LOG_PREFIX = \"[Relationships]\";\nexport const RELATIONSHIPS_SERVICE_TYPE = \"relationships\";\n\n/**\n * Action name for the relationships graph-CRUD umbrella.\n *\n * NOT `ENTITY`. `@elizaos/plugin-personal-assistant` already registers an\n * `ENTITY` action: a rich orchestration over the legacy Rolodex contact model\n * (`LifeOpsService.listRelationships/upsertRelationship/logInteraction`) with\n * an LLM planner and voice-grounded replies. That action stays in PA. This\n * action is the thin \"extras\" surface — direct CRUD over the runtime\n * {@link KNOWLEDGE_GRAPH_SERVICE} graph that powers the relationships viewer —\n * so it is registered under a distinct name to avoid a duplicate `ENTITY`\n * registration when both plugins load together.\n */\nexport const RELATIONSHIPS_ACTION_NAME = \"KNOWLEDGE_GRAPH\";\n\nexport const RELATIONSHIPS_CONTEXTS = [\n  \"people\",\n  \"contacts\",\n  \"relationships\",\n] as const;\nexport type RelationshipsContext = (typeof RELATIONSHIPS_CONTEXTS)[number];\n\n/**\n * Built-in entity kinds. The store accepts any string, but these are what the\n * runtime understands without registration. Mirrors\n * `BUILT_IN_ENTITY_TYPES` in lifeops.\n */\nexport const BUILT_IN_ENTITY_KINDS = [\n  \"person\",\n  \"organization\",\n  \"place\",\n  \"project\",\n  \"concept\",\n] as const;\nexport type BuiltInEntityKind = (typeof BUILT_IN_ENTITY_KINDS)[number];\n\n/**\n * Identifier of the `self` Entity — the agent's owner. All ego-network edges\n * originate from `self`. Bootstrapped on first store init.\n */\nexport const SELF_ENTITY_ID = \"self\";\n\n/**\n * Canonical entity-kind / op tuple accepted by the `ENTITY` action.\n *\n * Mirrors the `Subaction` union in\n * `plugins/plugin-personal-assistant/src/actions/entity.ts`.\n */\nexport const ENTITY_OPS = [\n  \"create\",\n  \"read\",\n  \"list\",\n  \"log_interaction\",\n  \"set_identity\",\n  \"set_relationship\",\n  \"merge\",\n] as const;\nexport type EntityOp = (typeof ENTITY_OPS)[number];\n\n/**\n * Minimal Entity shape. The full LifeOps `Entity` (see\n * `lifeops/entities/types.ts`) carries `identities[]`, `attributes`, `state`,\n * `tags`, and `visibility`. Those land in a follow-up port.\n */\nexport interface Entity {\n  id: string;\n  kind: string;\n  displayName: string;\n  attrs: Record<string, unknown>;\n  createdAt: Date;\n  updatedAt: Date;\n}\n\n/**\n * Minimal Relationship shape. The full LifeOps `Relationship` (see\n * `lifeops/relationships/types.ts`) carries `type`, `metadata`, `state`,\n * `evidence[]`, `confidence`, `source`, and `status` (active / retired).\n */\nexport interface Relationship {\n  id: string;\n  fromEntityId: string;\n  toEntityId: string;\n  kind: string;\n  attrs: Record<string, unknown>;\n  lastObservedAt: Date | null;\n}\n\n/**\n * Filter shape for listing entities. AND-combined.\n */\nexport interface EntityFilter {\n  kind?: string;\n  nameContains?: string;\n  limit?: number;\n}\n\n/**\n * Filter shape for listing relationships. AND-combined.\n */\nexport interface RelationshipFilter {\n  fromEntityId?: string;\n  toEntityId?: string;\n  kind?: string | string[];\n  limit?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Display DTOs for the RelationshipsView.\n//\n// These are the flattened, display-only shapes the view renders after mapping\n// the wire payloads served by the PA REST routes (GET /api/lifeops/entities and\n// GET /api/lifeops/relationships). They live here — NOT imported from\n// @elizaos/plugin-personal-assistant — so the view's contract stays\n// self-contained and aligned by shape.\n// ---------------------------------------------------------------------------\n\n/**\n * The entity-kind filter set the view offers. Mirrors\n * {@link BUILT_IN_ENTITY_KINDS} with an `all` sentinel for \"no filter\".\n */\nexport const ENTITY_KIND_FILTERS = [\n  \"person\",\n  \"organization\",\n  \"place\",\n  \"project\",\n  \"concept\",\n] as const;\nexport type EntityKindFilter = (typeof ENTITY_KIND_FILTERS)[number];\n\n/** Human labels for the built-in entity kinds shown in the view. */\nexport const ENTITY_KIND_LABELS: Record<string, string> = {\n  person: \"People\",\n  organization: \"Organizations\",\n  place: \"Places\",\n  project: \"Projects\",\n  concept: \"Concepts\",\n};\n\n/**\n * A single identity claim shown under an entity (platform + handle). Flattened\n * from the wire `EntityIdentity`.\n */\nexport interface EntityIdentityItem {\n  platform: string;\n  handle: string;\n  verified: boolean;\n}\n\n/**\n * A typed edge shown under its source entity. Flattened from the wire\n * `Relationship`: the edge's type label, the resolved target display name, and\n * the optional cadence / last-contact metadata the view surfaces.\n */\nexport interface RelationshipEdgeItem {\n  id: string;\n  type: string;\n  /** Display name of the target entity, or the raw id when unresolved. */\n  toName: string;\n  /** Cadence in days from `metadata.cadenceDays`, when present. */\n  cadenceDays: number | null;\n  /** ISO timestamp of the last interaction/observation on this edge. */\n  lastContact: string | null;\n}\n\n/**\n * An entity node as the view renders it: identity + kind + its outbound edges.\n */\nexport interface EntityNodeItem {\n  id: string;\n  kind: string;\n  name: string;\n  identities: EntityIdentityItem[];\n  edges: RelationshipEdgeItem[];\n}\n"],"mappings":"AAYO,MAAM,2BAA2B;AACjC,MAAM,6BAA6B;AAcnC,MAAM,4BAA4B;AAElC,MAAM,yBAAyB;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AACF;AAQO,MAAM,wBAAwB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAOO,MAAM,iBAAiB;AAQvB,MAAM,aAAa;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAgEO,MAAM,sBAAsB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIO,MAAM,qBAA6C;AAAA,EACxD,QAAQ;AAAA,EACR,cAAc;AAAA,EACd,OAAO;AAAA,EACP,SAAS;AAAA,EACT,SAAS;AACX;","names":[]}