How guzhujushi/trimum works
trimum is a Python AI-process runtime: users submit work through the CLI or other documented interfaces, which is transformed into workflow actions, planned when needed, checked by security policy, and executed through a unified tool gateway. The graph retains documented memory, MCP, agent-runtime, audit, and event capabilities. Some of these implementations were not excerpted, so their documented presence is shown without speculative implementation-level connections.
Main entry points: workflow_engine.py Workflow engine · tool_gateway.py Tool gateway · commands CLI commands · workflow_runtime.py Workflow runtime
Components 28
User interfaces
- CLI commands
src/trimum_core/cli/commands - CLI parser
src/trimum_core/cli/parser.py - CLI helpers
src/trimum_core/cli/_utils.py - Web API
src/trimum_core/api_server.py
Workflow orchestration
- Request transform
src/trimum_core/transform_agent.py - Workflow engine
src/trimum_core/workflow_engine.py - Workflow runtime
src/trimum_core/workflow_runtime.py - Fallback planner
src/trimum_core/planner_agent.py - Workflow catalog
src/trimum_core/workflow_catalog.py
Secure execution
- Tool gateway
src/trimum_core/tool_gateway.py - Policy engine
src/trimum_core/policy_engine.py - Tool dispatchers
src/trimum_core/tool_dispatchers.py - Sandbox execution
src/trimum_core/sandbox_exec.py - Seccomp execution
src/trimum_core/seccomp_exec.py
Runtime services
- Event bus
src/trimum_core/event_bus.py - Event index
src/trimum_core/event_index.py - Memory classifier
src/trimum_core/memory_classifier.py - Audit store
src/trimum_core/audit_store.py - Core models
src/trimum_core/models.py - Configuration
src/trimum_core/config.py - JSON-RPC IPC
src/trimum_core/ipc_handler.py - Structured logging
src/trimum_core/logger.py - Runtime paths
src/trimum_core/paths.py
Agent ecosystem
- MCP registry
src/trimum_core/mcp_registry.py - MCP client
src/trimum_core/mcp_client.py - Agent runtime
src/trimum_core/agent_runtime.py - Agent manager
src/trimum_core/agent_manager.py
Other components
- User
Connections 26
- User → CLI commands: submits request
- CLI commands → CLI parser: parses commands
src/trimum_core/cli/parser.py - CLI parser → CLI helpers: uses helpers
src/trimum_core/cli/parser.py - CLI commands → Request transform: transforms request
src/trimum_core/cli/commands/workflow.py - Request transform → Workflow engine: routes labels
- Workflow engine → Fallback planner: plans fallback
- Workflow engine → Workflow runtime: runs workflow
src/trimum_core/workflow_runtime.py - Workflow engine → Event bus: emits events
src/trimum_core/workflow_engine.py - Workflow runtime → Event bus: subscribes events
src/trimum_core/workflow_runtime.py - Workflow engine → Workflow catalog: matches workflows
- Workflow engine → Tool gateway: dispatches tools
src/trimum_core/workflow_runtime.py - Workflow engine → Core models: uses task models
src/trimum_core/workflow_engine.py - Event bus → Event index: indexes listeners
src/trimum_core/event_bus.py - Tool gateway → Policy engine: checks permissions
- Tool gateway → Tool dispatchers: dispatches tools
- Tool dispatchers → Sandbox execution: executes commands
src/trimum_core/tool_dispatchers.py - Tool dispatchers → Seccomp execution: uses seccomp
src/trimum_core/tool_dispatchers.py - Tool gateway → MCP registry: discovers MCP
- MCP registry → MCP client: manages clients
src/trimum_core/mcp_registry.py - Agent runtime → Tool gateway: uses tool gateway
- Agent manager → Agent runtime: manages agents
- CLI commands → Memory classifier: manages memories
- Workflow runtime → Audit store: records execution
src/trimum_core/workflow_runtime.py - JSON-RPC IPC → Web API: proxies requests
src/trimum_core/ipc_handler.py - Configuration → Runtime paths: selects paths
- Structured logging → Configuration: reads logging settings
src/trimum_core/logger.py