1
PHP Package
Virgil edited this page 2026-03-11 12:14:36 +00:00
Table of Contents
PHP Package
Composer: lthn/agent
Namespace: Core\Mod\Agentic\
Provider: Core\Mod\Agentic\Boot
Boot Provider
Listens to lifecycle events via static $listens:
AdminPanelBooting— registers admin views, Livewire components, routes.ApiRoutesRegistering— registers REST API routes withagent.authmiddleware.ConsoleBooting— registers artisan commands.McpToolsRegistering— registers Brain MCP tools (remember, recall, forget, list).
Singletons: AgenticManager, AgentToolRegistry, ForgejoService, BrainService.
Scheduled commands:
agentic:plan-cleanup— daily.agentic:scan— every 5 minutes (when forge token configured).agentic:dispatch— every 2 minutes.agentic:pr-manage— every 5 minutes.
Models
| Model | Description |
|---|---|
AgentSession |
Agent session tracking |
AgentPlan |
Execution plan |
AgentPhase |
Plan phase |
AgentApiKey |
API key management |
Task |
Task record |
BrainMemory |
Vector memory entries |
Prompt |
Prompt templates |
PromptVersion |
Prompt versioning |
PlanTemplateVersion |
Plan template versioning |
WorkspaceState |
Workspace state tracking |
Services
| Service | Description |
|---|---|
AgenticManager |
Central manager singleton |
AgentToolRegistry |
MCP tool registration |
AgentSessionService |
Session lifecycle |
AgentApiKeyService |
API key CRUD |
BrainService |
Ollama + Qdrant vector store (OpenBrain). Configured via mcp.brain.* config |
ClaudeService |
Claude API integration |
GeminiService |
Gemini API integration |
OpenAIService |
OpenAI API integration |
ForgejoService |
Forgejo API (issues, PRs, repos) |
ContentService |
Content operations |
IpRestrictionService |
IP-based access control |
PlanTemplateService |
Plan template management |
AgentDetection |
Agent identification |
Actions
Organised by domain:
- Brain/: Memory operations.
- Forge/: Forgejo integration actions.
- Phase/: Plan phase management.
- Plan/: Plan CRUD and execution.
- Session/: Session lifecycle.
- Task/: Task CRUD and claiming.
Artisan Commands
| Command | Description |
|---|---|
agentic:task |
Task management |
agentic:plan |
Plan management |
agentic:generate |
Code generation |
agentic:plan-cleanup |
Stale plan retention |
agentic:brain:seed-memory |
Seed brain memory from files |
agentic:brain:ingest |
Ingest documents into brain |
agentic:scan |
Scan Forgejo for actionable work |
agentic:dispatch |
Dispatch tasks to agents |
agentic:pr-manage |
PR lifecycle management |
agentic:prep-workspace |
Prepare workspace for agent |
Livewire Components
Admin panel components under View\Modal\Admin\:
Dashboard, Plans, PlanDetail, Sessions, SessionDetail, ToolAnalytics, ToolCalls, ApiKeys, Templates.
MCP Tools
Brain tools registered via AgentToolRegistry:
BrainRemember— store memory.BrainRecall— retrieve memory.BrainForget— delete memory.BrainList— list memories.
Dependencies
PHP: lthn/php.
Dev: laravel/pint, livewire/livewire, orchestra/testbench, pestphp/pest.