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

package/dist/actions/entity.d.ts

@@ -0,0 +1,72 @@
+/**
+ * `KNOWLEDGE_GRAPH` umbrella action — direct CRUD over the runtime
+ * knowledge graph.
+ *
+ * This is the relationships-plugin "extras" surface. The graph stores
+ * themselves live in the runtime: `@elizaos/agent`'s
+ * {@link KnowledgeGraphService} owns the per-agent `EntityStore` /
+ * `RelationshipStore`. This action resolves that service and dispatches
+ * graph operations onto it. No DB access, no merge engine, no LLM planning
+ * lives here — those are runtime / PA concerns respectively.
+ *
+ * Op-based dispatch:
+ *   - `create`             create a person/org/place/project/concept node
+ *   - `read`               fetch a single entity by id
+ *   - `list`               list known entities (optionally filtered by kind)
+ *   - `log_interaction`    record an inbound/outbound interaction on an entity
+ *   - `set_identity`       observe a verified (platform, handle) identity
+ *   - `set_relationship`   upsert a typed edge between two entities
+ *   - `merge`              fold duplicate entities into a target
+ *
+ * Owner-only (`roleGate.minRole: OWNER` + the {@link hasOwnerAccess} gate).
+ *
+ * NOTE on naming: this action is `KNOWLEDGE_GRAPH`, NOT `ENTITY`.
+ * `@elizaos/plugin-personal-assistant` registers the `ENTITY` action (a rich
+ * orchestration over the legacy Rolodex contact model with an LLM planner +
+ * voice-grounded replies). That stays in PA; this action is the thin runtime
+ * graph-CRUD surface that powers the relationships viewer. Registering it
+ * under a distinct name keeps exactly one `ENTITY` action at runtime.
+ */
+import type { Action } from "@elizaos/core";
+import { type EntityOp } from "../types.js";
+/**
+ * Parameter shape accepted by the action. The planner provides these via
+ * `options.parameters`; every field is optional and validated per-op.
+ */
+export interface EntityActionParameters {
+    /** Canonical op name. Planner may also provide `action` / `subaction`. */
+    op?: EntityOp;
+    subaction?: EntityOp;
+    action?: EntityOp;
+    /** Entity kind for `create` / `list` filter (person / organization / …). */
+    kind?: string;
+    /** Display name for `create`. */
+    name?: string;
+    /** Target entity id for `read` / `log_interaction` / `merge` target. */
+    entityId?: string;
+    /** Identity platform for `set_identity` (e.g. `discord`, `email`). */
+    platform?: string;
+    /** Handle on `platform` for `set_identity`. */
+    handle?: string;
+    /** Display name shown for an observed identity. */
+    displayName?: string;
+    /** Edge target id for `set_relationship`. */
+    toEntityId?: string;
+    /** Edge source id for `set_relationship`. Defaults to `self`. */
+    fromEntityId?: string;
+    /** Edge type label for `set_relationship` (e.g. `manages`). */
+    relationshipType?: string;
+    /** Source entity ids consumed when calling `merge`. */
+    sourceEntityIds?: string[];
+    /** Free-form evidence string for provenance trail. */
+    evidence?: string;
+    /** Interaction direction for `log_interaction`. Defaults to `outbound`. */
+    direction?: "inbound" | "outbound";
+    /** Interaction summary text for `log_interaction`. */
+    summary?: string;
+    /** Limit for `list`. */
+    limit?: number;
+}
+export declare const entityAction: Action;
+export default entityAction;
+//# sourceMappingURL=entity.d.ts.map

package/dist/actions/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/actions/entity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,eAAe,CAAC;AAKvB,OAAO,EAEL,KAAK,QAAQ,EAId,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IACnC,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqCD,eAAO,MAAM,YAAY,EAAE,MA2T1B,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/actions/entity.js

@@ -0,0 +1,312 @@
+import { hasOwnerAccess, resolveKnowledgeGraphService } from "@elizaos/agent";
+import { logger } from "@elizaos/core";
+import { SELF_ENTITY_ID } from "@elizaos/shared";
+import {
+  ENTITY_OPS,
+  RELATIONSHIPS_ACTION_NAME,
+  RELATIONSHIPS_CONTEXTS,
+  RELATIONSHIPS_LOG_PREFIX
+} from "../types.js";
+function getParams(options) {
+  const params = options?.parameters;
+  return params ?? {};
+}
+function resolveOp(params) {
+  const candidate = params.op ?? params.subaction ?? params.action;
+  if (typeof candidate !== "string") return null;
+  return ENTITY_OPS.includes(candidate) ? candidate : null;
+}
+function trimmed(value) {
+  if (typeof value !== "string") return null;
+  const t = value.trim();
+  return t.length > 0 ? t : null;
+}
+function entitySummary(entity) {
+  return {
+    entityId: entity.entityId,
+    type: entity.type,
+    preferredName: entity.preferredName
+  };
+}
+const ENTITY_KINDS_DEFAULT = "person";
+const entityAction = {
+  name: RELATIONSHIPS_ACTION_NAME,
+  similes: ["ENTITY_CRUD", "GRAPH_ENTITY", "KNOWLEDGE_GRAPH_CRUD"],
+  description: "Direct CRUD over the runtime knowledge graph (entities + typed edges): create | read | list | log_interaction | set_identity | set_relationship | merge. Backs the relationships viewer. Contact orchestration with planning -> ENTITY (personal-assistant).",
+  descriptionCompressed: "KNOWLEDGE_GRAPH create|read|list|log_interaction|set_identity|set_relationship|merge",
+  tags: [
+    "domain:relationships",
+    "capability:read",
+    "capability:write",
+    "capability:update",
+    "capability:delete",
+    "surface:internal"
+  ],
+  contexts: [...RELATIONSHIPS_CONTEXTS],
+  contextGate: { anyOf: [...RELATIONSHIPS_CONTEXTS] },
+  roleGate: { minRole: "OWNER" },
+  validate: async (runtime, message, _state) => {
+    if (!resolveKnowledgeGraphService(runtime)) return false;
+    return hasOwnerAccess(runtime, message);
+  },
+  handler: async (runtime, message, _state, options, callback) => {
+    if (!await hasOwnerAccess(runtime, message)) {
+      const text = "The knowledge graph is restricted to the owner.";
+      await callback?.({
+        text,
+        source: "action",
+        action: RELATIONSHIPS_ACTION_NAME
+      });
+      return { success: false, text, data: { error: "PERMISSION_DENIED" } };
+    }
+    const service = resolveKnowledgeGraphService(runtime);
+    if (!service) {
+      const text = "The knowledge graph service is not available.";
+      await callback?.({
+        text,
+        source: "action",
+        action: RELATIONSHIPS_ACTION_NAME
+      });
+      return { success: false, text, data: { error: "SERVICE_UNAVAILABLE" } };
+    }
+    const params = getParams(options);
+    const op = resolveOp(params);
+    if (!op) {
+      const text = "Tell me which knowledge-graph op: create, read, list, log_interaction, set_identity, set_relationship, or merge.";
+      await callback?.({
+        text,
+        source: "action",
+        action: RELATIONSHIPS_ACTION_NAME
+      });
+      return { success: false, text, data: { error: "MISSING_OP" } };
+    }
+    const entityStore = service.getEntityStore();
+    const relationshipStore = service.getRelationshipStore();
+    const reply = async (result) => {
+      await callback?.({
+        text: result.text,
+        source: "action",
+        action: RELATIONSHIPS_ACTION_NAME
+      });
+      return result;
+    };
+    logger.info(
+      `${RELATIONSHIPS_LOG_PREFIX} ${RELATIONSHIPS_ACTION_NAME} op=${op}`
+    );
+    switch (op) {
+      case "create": {
+        const name = trimmed(params.name);
+        if (!name) {
+          return reply({
+            success: false,
+            text: "I need a display name to create an entity.",
+            data: { op, error: "MISSING_FIELDS" }
+          });
+        }
+        const kind = trimmed(params.kind) ?? ENTITY_KINDS_DEFAULT;
+        const entity = await entityStore.upsert({
+          type: kind,
+          preferredName: name,
+          identities: [],
+          tags: [],
+          visibility: "owner_agent_admin",
+          state: {}
+        });
+        return reply({
+          success: true,
+          text: `Created ${kind} "${entity.preferredName}" (${entity.entityId}).`,
+          data: { op, entity: entitySummary(entity) }
+        });
+      }
+      case "read": {
+        const entityId = trimmed(params.entityId);
+        if (!entityId) {
+          return reply({
+            success: false,
+            text: "I need an entityId to read.",
+            data: { op, error: "MISSING_FIELDS" }
+          });
+        }
+        const entity = await entityStore.get(entityId);
+        if (!entity) {
+          return reply({
+            success: false,
+            text: `No entity found with id ${entityId}.`,
+            data: { op, error: "NOT_FOUND", entityId }
+          });
+        }
+        return reply({
+          success: true,
+          text: `${entity.preferredName} (${entity.type}) \u2014 ${entity.identities.length} identit${entity.identities.length === 1 ? "y" : "ies"}.`,
+          data: { op, entity }
+        });
+      }
+      case "list": {
+        const kind = trimmed(params.kind);
+        const limit = typeof params.limit === "number" && params.limit > 0 ? Math.floor(params.limit) : 50;
+        const entities = await entityStore.list({
+          ...kind ? { type: kind } : {},
+          limit
+        });
+        return reply({
+          success: true,
+          text: entities.length === 0 ? "No entities in the graph yet." : `${entities.length} entit${entities.length === 1 ? "y" : "ies"} in the graph.`,
+          data: { op, entities: entities.map(entitySummary) }
+        });
+      }
+      case "log_interaction": {
+        const entityId = trimmed(params.entityId);
+        if (!entityId) {
+          return reply({
+            success: false,
+            text: "I need an entityId to log an interaction.",
+            data: { op, error: "MISSING_FIELDS" }
+          });
+        }
+        const entity = await entityStore.get(entityId);
+        if (!entity) {
+          return reply({
+            success: false,
+            text: `No entity found with id ${entityId}.`,
+            data: { op, error: "NOT_FOUND", entityId }
+          });
+        }
+        const platform = trimmed(params.platform) ?? entity.state.lastInteractionPlatform ?? "unknown";
+        const direction = params.direction === "inbound" ? "inbound" : "outbound";
+        await entityStore.recordInteraction(entityId, {
+          platform,
+          direction,
+          summary: trimmed(params.summary) ?? "",
+          occurredAt: (/* @__PURE__ */ new Date()).toISOString()
+        });
+        return reply({
+          success: true,
+          text: `Logged ${direction} interaction with ${entity.preferredName} on ${platform}.`,
+          data: { op, entityId, platform, direction }
+        });
+      }
+      case "set_identity": {
+        const platform = trimmed(params.platform);
+        const handle = trimmed(params.handle);
+        if (!platform || !handle) {
+          return reply({
+            success: false,
+            text: "I need both the platform and the handle to record an identity.",
+            data: { op, error: "MISSING_FIELDS" }
+          });
+        }
+        const evidence = trimmed(params.evidence) ?? "user_chat";
+        const displayName = trimmed(params.displayName);
+        const observation = await entityStore.observeIdentity({
+          platform,
+          handle,
+          ...displayName ? { displayName } : {},
+          evidence: [evidence],
+          confidence: 1
+        });
+        const verifiedIdentities = observation.entity.identities.map(
+          (identity) => identity.platform === platform && identity.handle === handle ? { ...identity, verified: true } : identity
+        );
+        const merged = await entityStore.upsert({
+          ...observation.entity,
+          identities: verifiedIdentities
+        });
+        return reply({
+          success: true,
+          text: `Recorded identity ${platform}:${handle} on ${merged.preferredName}.`,
+          data: {
+            op,
+            entity: entitySummary(merged),
+            mergedFrom: observation.mergedFrom ?? null,
+            conflict: observation.conflict ?? false
+          }
+        });
+      }
+      case "set_relationship": {
+        const toEntityId = trimmed(params.toEntityId);
+        const relationshipType = trimmed(params.relationshipType);
+        if (!toEntityId || !relationshipType) {
+          return reply({
+            success: false,
+            text: "I need the target entity id and the relationship type (e.g. manages, colleague_of, works_at).",
+            data: { op, error: "MISSING_FIELDS" }
+          });
+        }
+        const fromEntityId = trimmed(params.fromEntityId) ?? SELF_ENTITY_ID;
+        const evidence = trimmed(params.evidence) ?? "user_chat";
+        const edge = await relationshipStore.upsert({
+          fromEntityId,
+          toEntityId,
+          type: relationshipType,
+          metadata: {},
+          state: {},
+          evidence: [evidence],
+          confidence: 1,
+          source: "user_chat"
+        });
+        return reply({
+          success: true,
+          text: `Recorded ${fromEntityId} -[${relationshipType}]-> ${toEntityId}.`,
+          data: { op, relationship: edge }
+        });
+      }
+      case "merge": {
+        const targetEntityId = trimmed(params.entityId);
+        const sourceEntityIds = (params.sourceEntityIds ?? []).filter(
+          (id) => typeof id === "string" && id.trim().length > 0
+        );
+        if (!targetEntityId || sourceEntityIds.length === 0) {
+          return reply({
+            success: false,
+            text: "I need a target entityId and at least one sourceEntityId to merge duplicates.",
+            data: { op, error: "MISSING_FIELDS" }
+          });
+        }
+        const merged = await entityStore.merge(targetEntityId, sourceEntityIds);
+        return reply({
+          success: true,
+          text: `Merged ${sourceEntityIds.length} entit${sourceEntityIds.length === 1 ? "y" : "ies"} into ${merged.preferredName}.`,
+          data: {
+            op,
+            entity: entitySummary(merged),
+            sourceEntityIds
+          }
+        });
+      }
+    }
+  },
+  examples: [
+    [
+      {
+        name: "{{name1}}",
+        content: { text: "Add Alice as a person to my graph." }
+      },
+      {
+        name: "{{agentName}}",
+        content: {
+          text: 'Created person "Alice".',
+          action: RELATIONSHIPS_ACTION_NAME
+        }
+      }
+    ],
+    [
+      {
+        name: "{{name1}}",
+        content: { text: "Pat is my manager." }
+      },
+      {
+        name: "{{agentName}}",
+        content: {
+          text: "Recorded self -[manages]-> Pat.",
+          action: RELATIONSHIPS_ACTION_NAME
+        }
+      }
+    ]
+  ]
+};
+var entity_default = entityAction;
+export {
+  entity_default as default,
+  entityAction
+};
+//# sourceMappingURL=entity.js.map

package/dist/actions/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/entity.ts"],"sourcesContent":["/**\n * `KNOWLEDGE_GRAPH` umbrella action — direct CRUD over the runtime\n * knowledge graph.\n *\n * This is the relationships-plugin \"extras\" surface. The graph stores\n * themselves live in the runtime: `@elizaos/agent`'s\n * {@link KnowledgeGraphService} owns the per-agent `EntityStore` /\n * `RelationshipStore`. This action resolves that service and dispatches\n * graph operations onto it. No DB access, no merge engine, no LLM planning\n * lives here — those are runtime / PA concerns respectively.\n *\n * Op-based dispatch:\n *   - `create`             create a person/org/place/project/concept node\n *   - `read`               fetch a single entity by id\n *   - `list`               list known entities (optionally filtered by kind)\n *   - `log_interaction`    record an inbound/outbound interaction on an entity\n *   - `set_identity`       observe a verified (platform, handle) identity\n *   - `set_relationship`   upsert a typed edge between two entities\n *   - `merge`              fold duplicate entities into a target\n *\n * Owner-only (`roleGate.minRole: OWNER` + the {@link hasOwnerAccess} gate).\n *\n * NOTE on naming: this action is `KNOWLEDGE_GRAPH`, NOT `ENTITY`.\n * `@elizaos/plugin-personal-assistant` registers the `ENTITY` action (a rich\n * orchestration over the legacy Rolodex contact model with an LLM planner +\n * voice-grounded replies). That stays in PA; this action is the thin runtime\n * graph-CRUD surface that powers the relationships viewer. Registering it\n * under a distinct name keeps exactly one `ENTITY` action at runtime.\n */\n\nimport { hasOwnerAccess, resolveKnowledgeGraphService } from \"@elizaos/agent\";\nimport type {\n  Action,\n  ActionResult,\n  HandlerCallback,\n  HandlerOptions,\n  IAgentRuntime,\n  Memory,\n  State,\n} from \"@elizaos/core\";\nimport { logger } from \"@elizaos/core\";\nimport type { Entity, EntityIdentity } from \"@elizaos/shared\";\nimport { SELF_ENTITY_ID } from \"@elizaos/shared\";\n\nimport {\n  ENTITY_OPS,\n  type EntityOp,\n  RELATIONSHIPS_ACTION_NAME,\n  RELATIONSHIPS_CONTEXTS,\n  RELATIONSHIPS_LOG_PREFIX,\n} from \"../types.js\";\n\n/**\n * Parameter shape accepted by the action. The planner provides these via\n * `options.parameters`; every field is optional and validated per-op.\n */\nexport interface EntityActionParameters {\n  /** Canonical op name. Planner may also provide `action` / `subaction`. */\n  op?: EntityOp;\n  subaction?: EntityOp;\n  action?: EntityOp;\n  /** Entity kind for `create` / `list` filter (person / organization / …). */\n  kind?: string;\n  /** Display name for `create`. */\n  name?: string;\n  /** Target entity id for `read` / `log_interaction` / `merge` target. */\n  entityId?: string;\n  /** Identity platform for `set_identity` (e.g. `discord`, `email`). */\n  platform?: string;\n  /** Handle on `platform` for `set_identity`. */\n  handle?: string;\n  /** Display name shown for an observed identity. */\n  displayName?: string;\n  /** Edge target id for `set_relationship`. */\n  toEntityId?: string;\n  /** Edge source id for `set_relationship`. Defaults to `self`. */\n  fromEntityId?: string;\n  /** Edge type label for `set_relationship` (e.g. `manages`). */\n  relationshipType?: string;\n  /** Source entity ids consumed when calling `merge`. */\n  sourceEntityIds?: string[];\n  /** Free-form evidence string for provenance trail. */\n  evidence?: string;\n  /** Interaction direction for `log_interaction`. Defaults to `outbound`. */\n  direction?: \"inbound\" | \"outbound\";\n  /** Interaction summary text for `log_interaction`. */\n  summary?: string;\n  /** Limit for `list`. */\n  limit?: number;\n}\n\nfunction getParams(\n  options: HandlerOptions | undefined,\n): EntityActionParameters {\n  const params = options?.parameters as EntityActionParameters | undefined;\n  return params ?? {};\n}\n\nfunction resolveOp(params: EntityActionParameters): EntityOp | null {\n  const candidate = params.op ?? params.subaction ?? params.action;\n  if (typeof candidate !== \"string\") return null;\n  return (ENTITY_OPS as readonly string[]).includes(candidate)\n    ? (candidate as EntityOp)\n    : null;\n}\n\nfunction trimmed(value: string | undefined): string | null {\n  if (typeof value !== \"string\") return null;\n  const t = value.trim();\n  return t.length > 0 ? t : null;\n}\n\nfunction entitySummary(entity: Entity): {\n  entityId: string;\n  type: string;\n  preferredName: string;\n} {\n  return {\n    entityId: entity.entityId,\n    type: entity.type,\n    preferredName: entity.preferredName,\n  };\n}\n\nconst ENTITY_KINDS_DEFAULT = \"person\";\n\nexport const entityAction: Action = {\n  name: RELATIONSHIPS_ACTION_NAME,\n  similes: [\"ENTITY_CRUD\", \"GRAPH_ENTITY\", \"KNOWLEDGE_GRAPH_CRUD\"],\n  description:\n    \"Direct CRUD over the runtime knowledge graph (entities + typed edges): create | read | list | log_interaction | set_identity | set_relationship | merge. Backs the relationships viewer. Contact orchestration with planning -> ENTITY (personal-assistant).\",\n  descriptionCompressed:\n    \"KNOWLEDGE_GRAPH create|read|list|log_interaction|set_identity|set_relationship|merge\",\n  tags: [\n    \"domain:relationships\",\n    \"capability:read\",\n    \"capability:write\",\n    \"capability:update\",\n    \"capability:delete\",\n    \"surface:internal\",\n  ],\n  contexts: [...RELATIONSHIPS_CONTEXTS],\n  contextGate: { anyOf: [...RELATIONSHIPS_CONTEXTS] },\n  roleGate: { minRole: \"OWNER\" },\n  validate: async (\n    runtime: IAgentRuntime,\n    message: Memory,\n    _state?: State,\n  ): Promise<boolean> => {\n    if (!resolveKnowledgeGraphService(runtime)) return false;\n    return hasOwnerAccess(runtime, message);\n  },\n  handler: async (\n    runtime: IAgentRuntime,\n    message: Memory,\n    _state: State | undefined,\n    options: HandlerOptions | undefined,\n    callback: HandlerCallback | undefined,\n  ): Promise<ActionResult> => {\n    if (!(await hasOwnerAccess(runtime, message))) {\n      const text = \"The knowledge graph is restricted to the owner.\";\n      await callback?.({\n        text,\n        source: \"action\",\n        action: RELATIONSHIPS_ACTION_NAME,\n      });\n      return { success: false, text, data: { error: \"PERMISSION_DENIED\" } };\n    }\n\n    const service = resolveKnowledgeGraphService(runtime);\n    if (!service) {\n      const text = \"The knowledge graph service is not available.\";\n      await callback?.({\n        text,\n        source: \"action\",\n        action: RELATIONSHIPS_ACTION_NAME,\n      });\n      return { success: false, text, data: { error: \"SERVICE_UNAVAILABLE\" } };\n    }\n\n    const params = getParams(options);\n    const op = resolveOp(params);\n    if (!op) {\n      const text =\n        \"Tell me which knowledge-graph op: create, read, list, log_interaction, set_identity, set_relationship, or merge.\";\n      await callback?.({\n        text,\n        source: \"action\",\n        action: RELATIONSHIPS_ACTION_NAME,\n      });\n      return { success: false, text, data: { error: \"MISSING_OP\" } };\n    }\n\n    const entityStore = service.getEntityStore();\n    const relationshipStore = service.getRelationshipStore();\n\n    const reply = async (\n      result: ActionResult & { text: string },\n    ): Promise<ActionResult> => {\n      await callback?.({\n        text: result.text,\n        source: \"action\",\n        action: RELATIONSHIPS_ACTION_NAME,\n      });\n      return result;\n    };\n\n    logger.info(\n      `${RELATIONSHIPS_LOG_PREFIX} ${RELATIONSHIPS_ACTION_NAME} op=${op}`,\n    );\n\n    switch (op) {\n      case \"create\": {\n        const name = trimmed(params.name);\n        if (!name) {\n          return reply({\n            success: false,\n            text: \"I need a display name to create an entity.\",\n            data: { op, error: \"MISSING_FIELDS\" },\n          });\n        }\n        const kind = trimmed(params.kind) ?? ENTITY_KINDS_DEFAULT;\n        const entity = await entityStore.upsert({\n          type: kind,\n          preferredName: name,\n          identities: [],\n          tags: [],\n          visibility: \"owner_agent_admin\",\n          state: {},\n        });\n        return reply({\n          success: true,\n          text: `Created ${kind} \"${entity.preferredName}\" (${entity.entityId}).`,\n          data: { op, entity: entitySummary(entity) },\n        });\n      }\n\n      case \"read\": {\n        const entityId = trimmed(params.entityId);\n        if (!entityId) {\n          return reply({\n            success: false,\n            text: \"I need an entityId to read.\",\n            data: { op, error: \"MISSING_FIELDS\" },\n          });\n        }\n        const entity = await entityStore.get(entityId);\n        if (!entity) {\n          return reply({\n            success: false,\n            text: `No entity found with id ${entityId}.`,\n            data: { op, error: \"NOT_FOUND\", entityId },\n          });\n        }\n        return reply({\n          success: true,\n          text: `${entity.preferredName} (${entity.type}) — ${entity.identities.length} identit${entity.identities.length === 1 ? \"y\" : \"ies\"}.`,\n          data: { op, entity },\n        });\n      }\n\n      case \"list\": {\n        const kind = trimmed(params.kind);\n        const limit =\n          typeof params.limit === \"number\" && params.limit > 0\n            ? Math.floor(params.limit)\n            : 50;\n        const entities = await entityStore.list({\n          ...(kind ? { type: kind } : {}),\n          limit,\n        });\n        return reply({\n          success: true,\n          text:\n            entities.length === 0\n              ? \"No entities in the graph yet.\"\n              : `${entities.length} entit${entities.length === 1 ? \"y\" : \"ies\"} in the graph.`,\n          data: { op, entities: entities.map(entitySummary) },\n        });\n      }\n\n      case \"log_interaction\": {\n        const entityId = trimmed(params.entityId);\n        if (!entityId) {\n          return reply({\n            success: false,\n            text: \"I need an entityId to log an interaction.\",\n            data: { op, error: \"MISSING_FIELDS\" },\n          });\n        }\n        const entity = await entityStore.get(entityId);\n        if (!entity) {\n          return reply({\n            success: false,\n            text: `No entity found with id ${entityId}.`,\n            data: { op, error: \"NOT_FOUND\", entityId },\n          });\n        }\n        const platform =\n          trimmed(params.platform) ??\n          entity.state.lastInteractionPlatform ??\n          \"unknown\";\n        const direction =\n          params.direction === \"inbound\" ? \"inbound\" : \"outbound\";\n        await entityStore.recordInteraction(entityId, {\n          platform,\n          direction,\n          summary: trimmed(params.summary) ?? \"\",\n          occurredAt: new Date().toISOString(),\n        });\n        return reply({\n          success: true,\n          text: `Logged ${direction} interaction with ${entity.preferredName} on ${platform}.`,\n          data: { op, entityId, platform, direction },\n        });\n      }\n\n      case \"set_identity\": {\n        const platform = trimmed(params.platform);\n        const handle = trimmed(params.handle);\n        if (!platform || !handle) {\n          return reply({\n            success: false,\n            text: \"I need both the platform and the handle to record an identity.\",\n            data: { op, error: \"MISSING_FIELDS\" },\n          });\n        }\n        const evidence = trimmed(params.evidence) ?? \"user_chat\";\n        const displayName = trimmed(params.displayName);\n        const observation = await entityStore.observeIdentity({\n          platform,\n          handle,\n          ...(displayName ? { displayName } : {}),\n          evidence: [evidence],\n          confidence: 1,\n        });\n        // User-asserted identities are verified — mark this (platform, handle).\n        const verifiedIdentities: EntityIdentity[] =\n          observation.entity.identities.map((identity) =>\n            identity.platform === platform && identity.handle === handle\n              ? { ...identity, verified: true }\n              : identity,\n          );\n        const merged = await entityStore.upsert({\n          ...observation.entity,\n          identities: verifiedIdentities,\n        });\n        return reply({\n          success: true,\n          text: `Recorded identity ${platform}:${handle} on ${merged.preferredName}.`,\n          data: {\n            op,\n            entity: entitySummary(merged),\n            mergedFrom: observation.mergedFrom ?? null,\n            conflict: observation.conflict ?? false,\n          },\n        });\n      }\n\n      case \"set_relationship\": {\n        const toEntityId = trimmed(params.toEntityId);\n        const relationshipType = trimmed(params.relationshipType);\n        if (!toEntityId || !relationshipType) {\n          return reply({\n            success: false,\n            text: \"I need the target entity id and the relationship type (e.g. manages, colleague_of, works_at).\",\n            data: { op, error: \"MISSING_FIELDS\" },\n          });\n        }\n        const fromEntityId = trimmed(params.fromEntityId) ?? SELF_ENTITY_ID;\n        const evidence = trimmed(params.evidence) ?? \"user_chat\";\n        const edge = await relationshipStore.upsert({\n          fromEntityId,\n          toEntityId,\n          type: relationshipType,\n          metadata: {},\n          state: {},\n          evidence: [evidence],\n          confidence: 1,\n          source: \"user_chat\",\n        });\n        return reply({\n          success: true,\n          text: `Recorded ${fromEntityId} -[${relationshipType}]-> ${toEntityId}.`,\n          data: { op, relationship: edge },\n        });\n      }\n\n      case \"merge\": {\n        const targetEntityId = trimmed(params.entityId);\n        const sourceEntityIds = (params.sourceEntityIds ?? []).filter(\n          (id): id is string => typeof id === \"string\" && id.trim().length > 0,\n        );\n        if (!targetEntityId || sourceEntityIds.length === 0) {\n          return reply({\n            success: false,\n            text: \"I need a target entityId and at least one sourceEntityId to merge duplicates.\",\n            data: { op, error: \"MISSING_FIELDS\" },\n          });\n        }\n        const merged = await entityStore.merge(targetEntityId, sourceEntityIds);\n        return reply({\n          success: true,\n          text: `Merged ${sourceEntityIds.length} entit${sourceEntityIds.length === 1 ? \"y\" : \"ies\"} into ${merged.preferredName}.`,\n          data: {\n            op,\n            entity: entitySummary(merged),\n            sourceEntityIds,\n          },\n        });\n      }\n    }\n  },\n  examples: [\n    [\n      {\n        name: \"{{name1}}\",\n        content: { text: \"Add Alice as a person to my graph.\" },\n      },\n      {\n        name: \"{{agentName}}\",\n        content: {\n          text: 'Created person \"Alice\".',\n          action: RELATIONSHIPS_ACTION_NAME,\n        },\n      },\n    ],\n    [\n      {\n        name: \"{{name1}}\",\n        content: { text: \"Pat is my manager.\" },\n      },\n      {\n        name: \"{{agentName}}\",\n        content: {\n          text: \"Recorded self -[manages]-> Pat.\",\n          action: RELATIONSHIPS_ACTION_NAME,\n        },\n      },\n    ],\n  ],\n};\n\nexport default entityAction;\n"],"mappings":"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","names":[]}

package/dist/components/relationships/RelationshipsSpatialView.d.ts

@@ -0,0 +1,72 @@
+/**
+ * RelationshipsSpatialView — the entity / relationship knowledge-graph viewer
+ * authored once with the spatial vocabulary, so it renders correctly wherever it
+ * is displayed:
+ *
+ *   - GUI / XR — mounted in `<SpatialSurface>` (DOM; XR scales up).
+ *   - TUI      — rendered to real terminal lines by the agent terminal, via
+ *                `registerSpatialTerminalView` (see `register-terminal-view.tsx`).
+ *
+ * It is purely presentational (a snapshot + an action callback in, primitives
+ * out) and imports only the cross-modality primitives, so it is safe to render
+ * in the Node agent process where the terminal lives (no browser/client import).
+ *
+ * The two graph payloads (entities + their outbound edges) are joined and
+ * projected to {@link EntityNode}s in the data wrapper ({@link ./RelationshipsView.tsx});
+ * this component never fetches or computes the graph — it displays the snapshot
+ * and dispatches actions. The entity-kind filter is the one piece of interactive
+ * state it owns locally (via {@link useSpatialState}); filtering the already-built
+ * node list is presentation-only and works on every surface.
+ */
+/** A typed edge shown under its source entity, already projected for display. */
+export interface RelationshipEdge {
+    id: string;
+    /** Resolved target display name (or the raw id when unresolved). */
+    toName: string;
+    /** Pre-formatted meta line: `type · every Nd · last <date>`. */
+    meta: string;
+}
+/** An entity node: identity + kind + its outbound edges. */
+export interface EntityNode {
+    id: string;
+    /** Raw entity kind (e.g. "person", "organization"). */
+    kind: string;
+    /** Human label for the kind (e.g. "People", "Organizations"). */
+    kindLabel: string;
+    name: string;
+    /** Pre-joined identity claims line (`discord:pat#1 · x:@pat`), or empty. */
+    identityLine: string;
+    edges: RelationshipEdge[];
+}
+/** A selectable kind filter offered above the graph. */
+export interface KindFilter {
+    /** Raw kind value used to match nodes. */
+    kind: string;
+    /** Human label shown on the chip. */
+    label: string;
+}
+/** Which render state the graph is in. */
+export type RelationshipsViewState = "loading" | "error" | "empty" | "ready";
+export interface RelationshipsSnapshot {
+    /** The graph state machine. */
+    state: RelationshipsViewState;
+    /** The entity nodes (only meaningful when state === "ready"). */
+    nodes: EntityNode[];
+    /** The kind filters offered above the graph. */
+    filters: KindFilter[];
+    /** Error message when state === "error". */
+    error?: string;
+}
+export declare const EMPTY_RELATIONSHIPS: RelationshipsSnapshot;
+export interface RelationshipsSpatialViewProps {
+    snapshot: RelationshipsSnapshot;
+    /**
+     * Dispatch by action id:
+     *   - `retry`            — reload after an error,
+     *   - `add`              — route an add-a-person request through chat,
+     *   - `open:<entityId>`  — focus an entity node.
+     */
+    onAction?: (action: string) => void;
+}
+export declare function RelationshipsSpatialView({ snapshot, onAction, }: RelationshipsSpatialViewProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=RelationshipsSpatialView.d.ts.map

package/dist/components/relationships/RelationshipsSpatialView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RelationshipsSpatialView.d.ts","sourceRoot":"","sources":["../../../src/components/relationships/RelationshipsSpatialView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAYH,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0CAA0C;AAC1C,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE7E,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,KAAK,EAAE,sBAAsB,CAAC;IAC9B,iEAAiE;IACjE,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,gDAAgD;IAChD,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,mBAAmB,EAAE,qBAIjC,CAAC;AAEF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,qBAAqB,CAAC;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,QAAQ,GACT,EAAE,6BAA6B,2CAkB/B"}

package/dist/components/relationships/RelationshipsSpatialView.js

@@ -0,0 +1,120 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import {
+  Button,
+  Card,
+  HStack,
+  List,
+  Text,
+  useSpatialState,
+  VStack
+} from "@elizaos/ui/spatial";
+const EMPTY_RELATIONSHIPS = {
+  state: "loading",
+  nodes: [],
+  filters: []
+};
+function RelationshipsSpatialView({
+  snapshot,
+  onAction
+}) {
+  const dispatch = (action) => () => onAction?.(action);
+  return /* @__PURE__ */ jsx(Card, { gap: 1, padding: 1, children: snapshot.state === "loading" ? /* @__PURE__ */ jsx(Text, { tone: "muted", align: "center", style: "caption", children: "Loading relationships" }) : snapshot.state === "error" ? /* @__PURE__ */ jsx(RelationshipsErrorBody, { snapshot, dispatch }) : snapshot.state === "empty" ? /* @__PURE__ */ jsx(RelationshipsEmptyBody, { dispatch }) : /* @__PURE__ */ jsx(RelationshipsReadyBody, { snapshot, onAction }) });
+}
+function RelationshipsErrorBody({
+  snapshot,
+  dispatch
+}) {
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(Text, { bold: true, children: "Could not load relationships" }),
+    /* @__PURE__ */ jsx(Text, { tone: "danger", style: "caption", children: snapshot.error ?? "Could not load relationships." }),
+    /* @__PURE__ */ jsx(HStack, { gap: 1, children: /* @__PURE__ */ jsx(Button, { agent: "retry", onPress: dispatch("retry"), children: "Retry" }) })
+  ] });
+}
+function RelationshipsEmptyBody({
+  dispatch
+}) {
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(Text, { bold: true, children: "None" }),
+    /* @__PURE__ */ jsx(HStack, { gap: 1, children: /* @__PURE__ */ jsx(Button, { agent: "add", onPress: dispatch("add"), children: "Add someone" }) })
+  ] });
+}
+function RelationshipsReadyBody({
+  snapshot,
+  onAction
+}) {
+  const [activeKind, setActiveKind] = useSpatialState("");
+  const visible = activeKind === "" ? snapshot.nodes : snapshot.nodes.filter((node) => node.kind === activeKind);
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    snapshot.filters.length > 0 ? /* @__PURE__ */ jsx(
+      KindFilters,
+      {
+        filters: snapshot.filters,
+        active: activeKind,
+        onSelect: setActiveKind
+      }
+    ) : null,
+    /* @__PURE__ */ jsxs(Text, { style: "caption", tone: "muted", children: [
+      "Graph (",
+      visible.length,
+      ")"
+    ] }),
+    visible.length === 0 ? /* @__PURE__ */ jsx(Text, { tone: "muted", style: "caption", children: "None" }) : /* @__PURE__ */ jsx(List, { gap: 1, children: visible.map((node) => /* @__PURE__ */ jsx(EntityNodeBlock, { node, onAction }, node.id)) })
+  ] });
+}
+function KindFilters({
+  filters,
+  active,
+  onSelect
+}) {
+  return /* @__PURE__ */ jsxs(HStack, { gap: 1, wrap: true, align: "center", children: [
+    /* @__PURE__ */ jsx(
+      Button,
+      {
+        agent: "relationships-kind-all",
+        variant: active === "" ? "solid" : "ghost",
+        onPress: () => onSelect(""),
+        children: "All"
+      }
+    ),
+    filters.map((filter) => /* @__PURE__ */ jsx(
+      Button,
+      {
+        agent: `relationships-kind-${filter.kind}`,
+        variant: active === filter.kind ? "solid" : "ghost",
+        onPress: () => onSelect(active === filter.kind ? "" : filter.kind),
+        children: filter.label
+      },
+      filter.kind
+    ))
+  ] });
+}
+function EntityNodeBlock({
+  node,
+  onAction
+}) {
+  return /* @__PURE__ */ jsxs(VStack, { gap: 0, agent: `rel-${node.id}`, children: [
+    /* @__PURE__ */ jsxs(HStack, { gap: 1, align: "center", children: [
+      /* @__PURE__ */ jsx(VStack, { gap: 0, grow: 1, children: /* @__PURE__ */ jsx(Text, { bold: true, wrap: false, children: node.name }) }),
+      /* @__PURE__ */ jsx(Text, { style: "caption", tone: "primary", wrap: false, children: node.kindLabel }),
+      /* @__PURE__ */ jsx(
+        Button,
+        {
+          agent: `open-${node.id}`,
+          onPress: () => onAction?.(`open:${node.id}`),
+          children: "\u203A"
+        }
+      )
+    ] }),
+    node.identityLine ? /* @__PURE__ */ jsx(Text, { style: "caption", tone: "muted", wrap: false, children: node.identityLine }) : null,
+    node.edges.length > 0 ? node.edges.map((edge) => /* @__PURE__ */ jsxs(HStack, { gap: 1, align: "center", children: [
+      /* @__PURE__ */ jsx(Text, { tone: "muted", wrap: false, children: "\u203A" }),
+      /* @__PURE__ */ jsx(VStack, { gap: 0, grow: 1, children: /* @__PURE__ */ jsx(Text, { wrap: false, children: edge.toName }) }),
+      /* @__PURE__ */ jsx(Text, { style: "caption", tone: "muted", wrap: false, children: edge.meta })
+    ] }, edge.id)) : null
+  ] });
+}
+export {
+  EMPTY_RELATIONSHIPS,
+  RelationshipsSpatialView
+};
+//# sourceMappingURL=RelationshipsSpatialView.js.map

package/dist/components/relationships/RelationshipsSpatialView.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/components/relationships/RelationshipsSpatialView.tsx"],"sourcesContent":["/**\n * RelationshipsSpatialView — the entity / relationship knowledge-graph viewer\n * authored once with the spatial vocabulary, so it renders correctly wherever it\n * is displayed:\n *\n *   - GUI / XR — mounted in `<SpatialSurface>` (DOM; XR scales up).\n *   - TUI      — rendered to real terminal lines by the agent terminal, via\n *                `registerSpatialTerminalView` (see `register-terminal-view.tsx`).\n *\n * It is purely presentational (a snapshot + an action callback in, primitives\n * out) and imports only the cross-modality primitives, so it is safe to render\n * in the Node agent process where the terminal lives (no browser/client import).\n *\n * The two graph payloads (entities + their outbound edges) are joined and\n * projected to {@link EntityNode}s in the data wrapper ({@link ./RelationshipsView.tsx});\n * this component never fetches or computes the graph — it displays the snapshot\n * and dispatches actions. The entity-kind filter is the one piece of interactive\n * state it owns locally (via {@link useSpatialState}); filtering the already-built\n * node list is presentation-only and works on every surface.\n */\n\nimport {\n  Button,\n  Card,\n  HStack,\n  List,\n  Text,\n  useSpatialState,\n  VStack,\n} from \"@elizaos/ui/spatial\";\n\n/** A typed edge shown under its source entity, already projected for display. */\nexport interface RelationshipEdge {\n  id: string;\n  /** Resolved target display name (or the raw id when unresolved). */\n  toName: string;\n  /** Pre-formatted meta line: `type · every Nd · last <date>`. */\n  meta: string;\n}\n\n/** An entity node: identity + kind + its outbound edges. */\nexport interface EntityNode {\n  id: string;\n  /** Raw entity kind (e.g. \"person\", \"organization\"). */\n  kind: string;\n  /** Human label for the kind (e.g. \"People\", \"Organizations\"). */\n  kindLabel: string;\n  name: string;\n  /** Pre-joined identity claims line (`discord:pat#1 · x:@pat`), or empty. */\n  identityLine: string;\n  edges: RelationshipEdge[];\n}\n\n/** A selectable kind filter offered above the graph. */\nexport interface KindFilter {\n  /** Raw kind value used to match nodes. */\n  kind: string;\n  /** Human label shown on the chip. */\n  label: string;\n}\n\n/** Which render state the graph is in. */\nexport type RelationshipsViewState = \"loading\" | \"error\" | \"empty\" | \"ready\";\n\nexport interface RelationshipsSnapshot {\n  /** The graph state machine. */\n  state: RelationshipsViewState;\n  /** The entity nodes (only meaningful when state === \"ready\"). */\n  nodes: EntityNode[];\n  /** The kind filters offered above the graph. */\n  filters: KindFilter[];\n  /** Error message when state === \"error\". */\n  error?: string;\n}\n\nexport const EMPTY_RELATIONSHIPS: RelationshipsSnapshot = {\n  state: \"loading\",\n  nodes: [],\n  filters: [],\n};\n\nexport interface RelationshipsSpatialViewProps {\n  snapshot: RelationshipsSnapshot;\n  /**\n   * Dispatch by action id:\n   *   - `retry`            — reload after an error,\n   *   - `add`              — route an add-a-person request through chat,\n   *   - `open:<entityId>`  — focus an entity node.\n   */\n  onAction?: (action: string) => void;\n}\n\nexport function RelationshipsSpatialView({\n  snapshot,\n  onAction,\n}: RelationshipsSpatialViewProps) {\n  const dispatch = (action: string) => () => onAction?.(action);\n\n  return (\n    <Card gap={1} padding={1}>\n      {snapshot.state === \"loading\" ? (\n        <Text tone=\"muted\" align=\"center\" style=\"caption\">\n          Loading relationships\n        </Text>\n      ) : snapshot.state === \"error\" ? (\n        <RelationshipsErrorBody snapshot={snapshot} dispatch={dispatch} />\n      ) : snapshot.state === \"empty\" ? (\n        <RelationshipsEmptyBody dispatch={dispatch} />\n      ) : (\n        <RelationshipsReadyBody snapshot={snapshot} onAction={onAction} />\n      )}\n    </Card>\n  );\n}\n\nfunction RelationshipsErrorBody({\n  snapshot,\n  dispatch,\n}: {\n  snapshot: RelationshipsSnapshot;\n  dispatch: (action: string) => () => void;\n}) {\n  return (\n    <>\n      <Text bold>Could not load relationships</Text>\n      <Text tone=\"danger\" style=\"caption\">\n        {snapshot.error ?? \"Could not load relationships.\"}\n      </Text>\n      <HStack gap={1}>\n        <Button agent=\"retry\" onPress={dispatch(\"retry\")}>\n          Retry\n        </Button>\n      </HStack>\n    </>\n  );\n}\n\nfunction RelationshipsEmptyBody({\n  dispatch,\n}: {\n  dispatch: (action: string) => () => void;\n}) {\n  return (\n    <>\n      <Text bold>None</Text>\n      <HStack gap={1}>\n        <Button agent=\"add\" onPress={dispatch(\"add\")}>\n          Add someone\n        </Button>\n      </HStack>\n    </>\n  );\n}\n\nfunction RelationshipsReadyBody({\n  snapshot,\n  onAction,\n}: {\n  snapshot: RelationshipsSnapshot;\n  onAction?: (action: string) => void;\n}) {\n  // The active kind filter is the one piece of interactive local state. Empty\n  // string = \"all kinds\". A single selection keeps the chips and the rendered\n  // cards in agreement on every surface.\n  const [activeKind, setActiveKind] = useSpatialState<string>(\"\");\n\n  const visible =\n    activeKind === \"\"\n      ? snapshot.nodes\n      : snapshot.nodes.filter((node) => node.kind === activeKind);\n\n  return (\n    <>\n      {snapshot.filters.length > 0 ? (\n        <KindFilters\n          filters={snapshot.filters}\n          active={activeKind}\n          onSelect={setActiveKind}\n        />\n      ) : null}\n      <Text style=\"caption\" tone=\"muted\">\n        Graph ({visible.length})\n      </Text>\n      {visible.length === 0 ? (\n        <Text tone=\"muted\" style=\"caption\">\n          None\n        </Text>\n      ) : (\n        <List gap={1}>\n          {visible.map((node) => (\n            <EntityNodeBlock key={node.id} node={node} onAction={onAction} />\n          ))}\n        </List>\n      )}\n    </>\n  );\n}\n\nfunction KindFilters({\n  filters,\n  active,\n  onSelect,\n}: {\n  filters: KindFilter[];\n  active: string;\n  onSelect: (kind: string) => void;\n}) {\n  return (\n    <HStack gap={1} wrap align=\"center\">\n      <Button\n        agent=\"relationships-kind-all\"\n        variant={active === \"\" ? \"solid\" : \"ghost\"}\n        onPress={() => onSelect(\"\")}\n      >\n        All\n      </Button>\n      {filters.map((filter) => (\n        <Button\n          key={filter.kind}\n          agent={`relationships-kind-${filter.kind}`}\n          variant={active === filter.kind ? \"solid\" : \"ghost\"}\n          onPress={() => onSelect(active === filter.kind ? \"\" : filter.kind)}\n        >\n          {filter.label}\n        </Button>\n      ))}\n    </HStack>\n  );\n}\n\nfunction EntityNodeBlock({\n  node,\n  onAction,\n}: {\n  node: EntityNode;\n  onAction?: (action: string) => void;\n}) {\n  return (\n    <VStack gap={0} agent={`rel-${node.id}`}>\n      <HStack gap={1} align=\"center\">\n        <VStack gap={0} grow={1}>\n          <Text bold wrap={false}>\n            {node.name}\n          </Text>\n        </VStack>\n        <Text style=\"caption\" tone=\"primary\" wrap={false}>\n          {node.kindLabel}\n        </Text>\n        <Button\n          agent={`open-${node.id}`}\n          onPress={() => onAction?.(`open:${node.id}`)}\n        >\n          ›\n        </Button>\n      </HStack>\n      {node.identityLine ? (\n        <Text style=\"caption\" tone=\"muted\" wrap={false}>\n          {node.identityLine}\n        </Text>\n      ) : null}\n      {node.edges.length > 0\n        ? node.edges.map((edge) => (\n            <HStack key={edge.id} gap={1} align=\"center\">\n              <Text tone=\"muted\" wrap={false}>\n                ›\n              </Text>\n              <VStack gap={0} grow={1}>\n                <Text wrap={false}>{edge.toName}</Text>\n              </VStack>\n              <Text style=\"caption\" tone=\"muted\" wrap={false}>\n                {edge.meta}\n              </Text>\n            </HStack>\n          ))\n        : null}\n    </VStack>\n  );\n}\n"],"mappings":"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","names":[]}