How robjvan/icos-v3 works
ICOS is an experimental cognitive-agent runtime with an Angular web client. The principal workflow is a user conversation handled by the core, routed through a provider-independent model boundary, persisted as a session, and enriched by recall; extracted memory can later be reviewed and promoted with human approval. The graph also preserves documented skills, tools, MCP, security, and administration capabilities. Some subsystem links are documented in the README rather than shown in sampled implementation; those edges cite the README.
Main entry points: conversation.service.ts Conversation service · core-api.service.ts Core API client · chat-ui-component.ts Chat interface · conversation.controller.ts Conversation API
Components 20
Web client
- Chat interface
web-client/src/app/components/chat-ui-component/chat-ui-component.ts - Core API client
web-client/src/app/services/core-api.service.ts - Memory review UI
web-client/src/app/components/memory-review-queue/memory-review-queue.ts
Core API
- Conversation API
core/src/conversation/conversation.controller.ts - Human approvals
core/src/approvals/approval.service.ts - Clarification queue
core/src/clarifications/clarification.service.ts - Authentication
core/src/auth/auth.service.ts
Agent runtime
- Conversation service
core/src/conversation/conversation.service.ts - LLM client
core/src/llm/llm.client.ts - Skills
core/src/skills/skill.service.ts - Tool execution
core/src/tools/tool-execution.service.ts - MCP bridge
core/src/mcp/mcp-tool-bridge.service.ts
Memory system
- Memory recall
core/src/memory/recall.service.ts - Candidate extraction
core/src/memory/llm-memory-candidate-extractor.ts - Epistemic claims
core/src/memory/claim.repository.ts - Memory promotion
core/src/memory/promotion.service.ts
Persistence and integrations
- Provider registry
core/src/providers/provider-registry.service.ts - Session store
core/src/conversation/session.store.ts - SQLite sessions
core/src/session/sqlite-session.repository.ts
Other components
- User
Connections 20
- User → Chat interface: sends message
- Chat interface → Core API client: submits chat
- Core API client → Conversation API: calls REST
- Conversation API → Conversation service: handles turn
- Conversation service → LLM client: requests completion
- LLM client → Provider registry: resolves provider
core/src/llm/llm-client.providers.ts - Conversation service → Session store: persists transcript
- Session store → SQLite sessions: stores sessions
core/src/session/sqlite-session.repository.ts - Conversation service → Memory recall: retrieves context
- Conversation service → Candidate extraction: extracts candidates
- Candidate extraction → Epistemic claims: supports knowledge
- Memory review UI → Core API client: requests review data
- Core API client → Human approvals: resolves approval
- Human approvals → Memory promotion: authorizes promotion
core/src/approvals/approval.service.ts - Memory promotion → Epistemic claims: updates beliefs
- Conversation service → Skills: uses capabilities
- Conversation service → Tool execution: executes tools
- Tool execution → MCP bridge: bridges external tools
- Conversation service → Clarification queue: queues questions
- Core API client → Authentication: authenticates requests