Skip to content
Kumiko

ai-agent-user-data

Enterprise Part of the commercial Kumiko Enterprise offering — not in the open framework.

GDPR (Art. 20 export / Art. 17 erasure) coverage for ai-agent’s ai-agent-turn, ai-agent-conversation and ai-agent-permission entities. The conversation header (list title, derived from the first prompt) is exported per owner; delete hard-purges it, anonymize nulls ownerId, which makes the encrypted title unreadable. Mounts the EXT_USER_DATA export + delete hooks so a user’s agent prompts, clarify answers, and tool results are included in the data export; delete hard-purges the user’s own turns, anonymize severs the author link but keeps the row (a blockDelete retention hold requires the data to physically survive). Also exports the user’s own ai-agent-permission rules (scope “user”) and deletes them under both strategies — a permission rule is a stored preference with no retention interest, and ownerUserId sits in the unique index so it can’t be severed the way the turn’s author link is; tenant-scoped rules are untouched. Kept separate from ai-agent so consumers without the user-data-rights pipeline don’t pull a hard dependency — requires ai-agent, user-data-rights.

Build it yourself

Section titled “Build it yourself”

This Enterprise implementation is optional. If you need a narrower or domain-specific version, you can build an app-owned feature, handler, or job with Kumiko’s public extension points.

Use this package when you want the maintained implementation, its existing contracts, and the surrounding operational behavior. A custom implementation is not drop-in compatible automatically: your app owns its authorization, validation, integrations, tests, security review, and production operations.

Start with Features and composition and Custom write handlers.

How it fits

Section titled “How it fits”

What this feature needs to run (Requires).

flowchart TB
  n_ai_agent_user_data["ai-agent-user-data"]
  subgraph how_reqs["Requires"]
    n_ai_agent["ai-agent"]
    n_user_data_rights["user-data-rights"]
  end
  n_ai_agent --> n_ai_agent_user_data
  n_user_data_rights --> n_ai_agent_user_data

Dependencies

Section titled “Dependencies”

Extensions & cross-feature APIs

Section titled “Extensions & cross-feature APIs”
  • Registers extension: userData → ai-agent-turn, userData → ai-agent-conversation, userData → ai-agent-permission