How iamsonal/aiagentstudio works
Pluto is a Salesforce-native AI-agent framework. Users interact through chat or supported messaging/API channels; ingress is normalized as needed, then an agent runtime gathers context and memory, invokes an LLM and configured actions, records execution state, and returns a response. The README also identifies direct and conversational runtimes, sequential pipelines, approvals, provider extensibility, security, and auditability. UI-to-service relationships are supported by sampled LWC excerpts; most Apex runtime connections are documented at capability level, so unsampled implementation links are not asserted.
Main entry points: OrchestrationService.cls Agent Orchestration · aiAssistantChat.js Chat Component · ChatConversationalRuntimeService.cls Conversational Runtime · InteractionSessionService.cls Interaction Sessions
Components 29
Interaction UI
- Chat Component
force-app/main/default/lwc/aiAssistantChat/aiAssistantChat.js - Chat Session Manager
force-app/main/default/lwc/aiAssistantChat/services/chatSessionManager.js - Message Formatter
force-app/main/default/lwc/aiAssistantChat/utils/messageFormatter.js - Event Subscriptions
force-app/main/default/lwc/aiAssistantChat/services/eventSubscriptionManager.js - EMP API Client
force-app/main/default/lwc/universalEmpApi/universalEmpApi.js - Speech Input
force-app/main/default/lwc/speechToTextInput/speechToTextInput.js - Speech Recognition
force-app/main/default/lwc/speechToTextInput/services/speechToTextService.js - Markdown Viewer
force-app/main/default/lwc/markdownViewer/markdownViewer.js
Ingress and Sessions
- Normalized Ingress
force-app/main/default/classes/IngressProcessingService.cls - Ingress Event Service
force-app/main/default/classes/IngressEventService.cls - Interaction Sessions
force-app/main/default/classes/InteractionSessionService.cls - Interaction Messages
force-app/main/default/classes/InteractionMessageService.cls
Agent Runtime
- Conversational Runtime
force-app/main/default/classes/ChatConversationalRuntimeService.cls - Direct Runtime
force-app/main/default/classes/DirectRuntimeService.cls - Agent Orchestration
force-app/main/default/classes/OrchestrationService.cls - Context Resolution
force-app/main/default/classes/ContextResolverService.cls - Conversation Memory
force-app/main/default/classes/BufferWindowMemoryManager.cls - LLM Interaction
force-app/main/default/classes/LLMInteractionService.cls - OpenAI Adapter
force-app/main/default/classes/OpenAIProviderAdapter.cls - Execution Records
force-app/main/default/objects/AgentExecution__c
Tools and Governance
- Standard Actions
force-app/main/default/classes/actions - Capability Execution
force-app/main/default/classes/CapabilityExecutionService.cls - Pipeline Composition
force-app/main/default/classes/PipelineCompositionService.cls - Human Approval
force-app/main/default/classes/HITLGatewayService.cls - PII Masking
force-app/main/default/classes/PIIMaskingService.cls
Other components
- User
- Salesforce Data
- LLM Provider
- Messaging Channels
Connections 31
- User → Chat Component: uses
README.md - Chat Component → Chat Session Manager: delegates
force-app/main/default/lwc/aiAssistantChat/aiAssistantChat.js - Chat Session Manager → Message Formatter: formats
force-app/main/default/lwc/aiAssistantChat/services/chatSessionManager.js - Chat Component → Event Subscriptions: subscribes
force-app/main/default/lwc/aiAssistantChat/aiAssistantChat.js - Event Subscriptions → EMP API Client: uses
force-app/main/default/lwc/aiAssistantChat/services/eventSubscriptionManager.js - Speech Input → Speech Recognition: captures speech
force-app/main/default/lwc/speechToTextInput/speechToTextInput.js - User → Speech Input: speaks
- User → Messaging Channels: sends requests
README.md - Messaging Channels → Normalized Ingress: normalizes
README.md - Chat Component → Conversational Runtime: sends message
README.md - Normalized Ingress → Ingress Event Service: stages events
- Ingress Event Service → Interaction Sessions: hands off
README.md - Interaction Sessions → Interaction Messages: stores conversation
README.md - Interaction Sessions → Conversational Runtime: starts execution
- Conversational Runtime → Agent Orchestration: orchestrates
- Direct Runtime → Agent Orchestration: orchestrates
- Agent Orchestration → Context Resolution: gathers context
README.md - Agent Orchestration → Conversation Memory: uses history
README.md - Agent Orchestration → LLM Interaction: analyzes request
README.md - LLM Interaction → OpenAI Adapter: dispatches request
- OpenAI Adapter → LLM Provider: calls model
- Agent Orchestration → Capability Execution: executes tools
README.md - Capability Execution → Standard Actions: dispatches actions
- Standard Actions → Salesforce Data: reads and writes
README.md - Agent Orchestration → Pipeline Composition: runs workflows
README.md - Agent Orchestration → Human Approval: requests approval
README.md - Agent Orchestration → PII Masking: masks sensitive data
- Conversational Runtime → Execution Records: tracks execution
README.md - LLM Interaction → Interaction Messages: records interaction
- Conversational Runtime → Chat Component: delivers response
README.md - Markdown Viewer → Chat Component: renders content