Agent

Module: forge.lthn.ai/core/agent Composer: lthn/agent

AI agent orchestration platform. Provides a Go-side job runner, agent loop engine, and Clotho dual-run verification system alongside a PHP Laravel package for task management, plan execution, brain/memory services, and MCP tool registration. The Go binary dispatches work to AI agents via SSH; the PHP package exposes REST APIs consumed by the Go client.

Packages

Go

Package	Description
`pkg/orchestrator`	Clotho orchestrator — agent config, dual-run verification, security helpers
`pkg/jobrunner`	Poll-dispatch engine: JobSource/JobHandler interfaces, Poller, Journal (JSONL audit)
`pkg/lifecycle`	API client for PHP agentic service, Core service wrapper, task types
`pkg/loop`	Agent loop engine — prompt model, parse tool calls, execute, repeat
`cmd/agent`	Agent CLI entry point
`cmd/dispatch`	Dispatch commands with rate limiting
`cmd/mcp`	MCP server with ethics, marketplace, core CLI tools
`cmd/tasks`	Task management commands
`cmd/workspace`	Workspace + agent + task management CLI
`cmd/taskgit`	Git-based task commands

PHP

Namespace	Description
`Core\Mod\Agentic\`	Boot provider, config, models, services
`Core\Mod\Agentic\Actions\`	Brain, Forge, Phase, Plan, Session, Task actions
`Core\Mod\Agentic\Models\`	AgentSession, AgentPlan, AgentPhase, Task, BrainMemory, Prompt, etc.
`Core\Mod\Agentic\Services\`	AgenticManager, BrainService, ClaudeService, GeminiService, OpenAIService, ForgejoService
`Core\Mod\Agentic\Mcp\`	MCP prompts, servers, and tool handlers
`Core\Mod\Agentic\Console\`	Artisan commands: scan, dispatch, pr-manage, plan, task, brain-seed, etc.

Topic Pages

Go-Architecture — Go packages, types, interfaces
PHP-Package — Laravel module, models, services