jiayan-xu/dsh-memoria-extra

dsh-memoria-extra

dsh-memoria-extra provides six advanced memoria tools for dsh. It is a companion to @dsh-external/dsh-memoria and connects to the same memoria service and configuration source.

Tools

• memoria_context: Build a session context block from a memory profile and optional top-k recall results. Supports profile inclusion, static and dynamic limits, and an as_of timestamp.
• memoria_recent_decisions: Retrieve recent decision records, with a default limit of 10.
• memoria_health: Request a read-only health report covering service, index, quota, and related status through the admin identity.
• memoria_allowed_ns: Return the namespaces authorized for the current caller.
• memoria_graph: Retrieve a weighted sample of the memory relation graph together with summary totals. The sample defaults to 200 nodes and is capped at 5,000; output includes at most 50 nodes and 50 edges.
• memoria_entity_search: Search entities by name, aliases, summary, memory context, and optional entity type.

Configuration

The plugin reads the memoria section from ~/.dsh/settings.yaml when tools are invoked, allowing settings changes to be picked up without recreating the plugin. Supported fields are:

memoria:
  baseURL: http://127.0.0.1:9003
  agentId: dsh-main
  apiKeyEnv: MEMORIA_AGENT_KEY
  namespace: agent/xujiayan

These values are the built-in defaults when the corresponding settings are absent.

Normal requests send X-Agent-Id using agentId and obtain X-Agent-Key from the environment variable named by apiKeyEnv. memoria_health instead uses the admin identity and MEMORIA_ADMIN_KEY. If that environment variable is absent, the plugin also looks for a MEMORIA_ADMIN_KEY entry in ~/agent-core/.env.

Most operations use JSON-RPC at <baseURL>/mcp. memoria_graph uses GET <baseURL>/graph.

The dsh bundle registers @jhp830901/dsh-memoria-extra with the ID dsh-memoria-extra.