ai-agent-attachments

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

Opt-in add-on for ai-agent: lets a caller attach a PDF/image/CSV/TXT/DOCX/DOC file (already uploaded via POST /api/files) to a conversation, so the agent reads it as part of the prompt — DOCX/DOC only when a document-ingest-foundation provider for them is mounted.

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

What this feature needs to run (Requires, top) and the write commands this feature provides (Provides, bottom).

flowchart TB
  n_ai_agent_attachments["ai-agent-attachments"]
  subgraph how_reqs["Requires"]
    n_ai_agent["ai-agent"]
  end
  subgraph how_provides["Provides"]
    n_cmd_ai_agent_attachments_write_attach(["attach"])
  end
  n_ai_agent --> n_ai_agent_attachments
  n_ai_agent_attachments --> n_cmd_ai_agent_attachments_write_attach

Provides — write commands this feature registers (dispatch them through the command bus):

• ai-agent-attachments:write:attach

Dependencies

• Requires: ai-agent
• Activation: always on (not toggleable)