orch-code 0.1.1

package/go.mod

@@ -0,0 +1,45 @@
+module github.com/furkanbeydemir/orch
+
+go 1.25.5
+
+require (
+	github.com/charmbracelet/bubbles v1.0.0
+	github.com/charmbracelet/bubbletea v1.3.10
+	github.com/charmbracelet/lipgloss v1.1.0
+	github.com/spf13/cobra v1.10.2
+	modernc.org/sqlite v1.46.1
+)
+
+require (
+	github.com/atotto/clipboard v0.1.4 // indirect
+	github.com/aymanbagabas/go-osc52/v2 v2.0.1 // indirect
+	github.com/charmbracelet/colorprofile v0.4.1 // indirect
+	github.com/charmbracelet/x/ansi v0.11.6 // indirect
+	github.com/charmbracelet/x/cellbuf v0.0.15 // indirect
+	github.com/charmbracelet/x/term v0.2.2 // indirect
+	github.com/clipperhouse/displaywidth v0.9.0 // indirect
+	github.com/clipperhouse/stringish v0.1.1 // indirect
+	github.com/clipperhouse/uax29/v2 v2.5.0 // indirect
+	github.com/dustin/go-humanize v1.0.1 // indirect
+	github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f // indirect
+	github.com/google/uuid v1.6.0 // indirect
+	github.com/inconshreveable/mousetrap v1.1.0 // indirect
+	github.com/lucasb-eyer/go-colorful v1.3.0 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/mattn/go-localereader v0.0.1 // indirect
+	github.com/mattn/go-runewidth v0.0.19 // indirect
+	github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 // indirect
+	github.com/muesli/cancelreader v0.2.2 // indirect
+	github.com/muesli/termenv v0.16.0 // indirect
+	github.com/ncruces/go-strftime v1.0.0 // indirect
+	github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect
+	github.com/rivo/uniseg v0.4.7 // indirect
+	github.com/spf13/pflag v1.0.9 // indirect
+	github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
+	golang.org/x/exp v0.0.0-20251023183803-a4bb9ffd2546 // indirect
+	golang.org/x/sys v0.38.0 // indirect
+	golang.org/x/text v0.3.8 // indirect
+	modernc.org/libc v1.67.6 // indirect
+	modernc.org/mathutil v1.7.1 // indirect
+	modernc.org/memory v1.11.0 // indirect
+)

package/go.sum

@@ -0,0 +1,108 @@
+github.com/atotto/clipboard v0.1.4 h1:EH0zSVneZPSuFR11BlR9YppQTVDbh5+16AmcJi4g1z4=
+github.com/atotto/clipboard v0.1.4/go.mod h1:ZY9tmq7sm5xIbd9bOK4onWV4S6X0u6GY7Vn0Yu86PYI=
+github.com/aymanbagabas/go-osc52/v2 v2.0.1 h1:HwpRHbFMcZLEVr42D4p7XBqjyuxQH5SMiErDT4WkJ2k=
+github.com/aymanbagabas/go-osc52/v2 v2.0.1/go.mod h1:uYgXzlJ7ZpABp8OJ+exZzJJhRNQ2ASbcXHWsFqH8hp8=
+github.com/charmbracelet/bubbles v1.0.0 h1:12J8/ak/uCZEMQ6KU7pcfwceyjLlWsDLAxB5fXonfvc=
+github.com/charmbracelet/bubbles v1.0.0/go.mod h1:9d/Zd5GdnauMI5ivUIVisuEm3ave1XwXtD1ckyV6r3E=
+github.com/charmbracelet/bubbletea v1.3.10 h1:otUDHWMMzQSB0Pkc87rm691KZ3SWa4KUlvF9nRvCICw=
+github.com/charmbracelet/bubbletea v1.3.10/go.mod h1:ORQfo0fk8U+po9VaNvnV95UPWA1BitP1E0N6xJPlHr4=
+github.com/charmbracelet/colorprofile v0.4.1 h1:a1lO03qTrSIRaK8c3JRxJDZOvhvIeSco3ej+ngLk1kk=
+github.com/charmbracelet/colorprofile v0.4.1/go.mod h1:U1d9Dljmdf9DLegaJ0nGZNJvoXAhayhmidOdcBwAvKk=
+github.com/charmbracelet/lipgloss v1.1.0 h1:vYXsiLHVkK7fp74RkV7b2kq9+zDLoEU4MZoFqR/noCY=
+github.com/charmbracelet/lipgloss v1.1.0/go.mod h1:/6Q8FR2o+kj8rz4Dq0zQc3vYf7X+B0binUUBwA0aL30=
+github.com/charmbracelet/x/ansi v0.11.6 h1:GhV21SiDz/45W9AnV2R61xZMRri5NlLnl6CVF7ihZW8=
+github.com/charmbracelet/x/ansi v0.11.6/go.mod h1:2JNYLgQUsyqaiLovhU2Rv/pb8r6ydXKS3NIttu3VGZQ=
+github.com/charmbracelet/x/cellbuf v0.0.15 h1:ur3pZy0o6z/R7EylET877CBxaiE1Sp1GMxoFPAIztPI=
+github.com/charmbracelet/x/cellbuf v0.0.15/go.mod h1:J1YVbR7MUuEGIFPCaaZ96KDl5NoS0DAWkskup+mOY+Q=
+github.com/charmbracelet/x/term v0.2.2 h1:xVRT/S2ZcKdhhOuSP4t5cLi5o+JxklsoEObBSgfgZRk=
+github.com/charmbracelet/x/term v0.2.2/go.mod h1:kF8CY5RddLWrsgVwpw4kAa6TESp6EB5y3uxGLeCqzAI=
+github.com/clipperhouse/displaywidth v0.9.0 h1:Qb4KOhYwRiN3viMv1v/3cTBlz3AcAZX3+y9OLhMtAtA=
+github.com/clipperhouse/displaywidth v0.9.0/go.mod h1:aCAAqTlh4GIVkhQnJpbL0T/WfcrJXHcj8C0yjYcjOZA=
+github.com/clipperhouse/stringish v0.1.1 h1:+NSqMOr3GR6k1FdRhhnXrLfztGzuG+VuFDfatpWHKCs=
+github.com/clipperhouse/stringish v0.1.1/go.mod h1:v/WhFtE1q0ovMta2+m+UbpZ+2/HEXNWYXQgCt4hdOzA=
+github.com/clipperhouse/uax29/v2 v2.5.0 h1:x7T0T4eTHDONxFJsL94uKNKPHrclyFI0lm7+w94cO8U=
+github.com/clipperhouse/uax29/v2 v2.5.0/go.mod h1:Wn1g7MK6OoeDT0vL+Q0SQLDz/KpfsVRgg6W7ihQeh4g=
+github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
+github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY=
+github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto=
+github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f h1:Y/CXytFA4m6baUTXGLOoWe4PQhGxaX0KpnayAqC48p4=
+github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f/go.mod h1:vw97MGsxSvLiUE2X8qFplwetxpGLQrlU1Q9AUEIzCaM=
+github.com/google/pprof v0.0.0-20250317173921-a4b03ec1a45e h1:ijClszYn+mADRFY17kjQEVQ1XRhq2/JR1M3sGqeJoxs=
+github.com/google/pprof v0.0.0-20250317173921-a4b03ec1a45e/go.mod h1:boTsfXsheKC2y+lKOCMpSfarhxDeIzfZG1jqGcPl3cA=
+github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
+github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/hashicorp/golang-lru/v2 v2.0.7 h1:a+bsQ5rvGLjzHuww6tVxozPZFVghXaHOwFs4luLUK2k=
+github.com/hashicorp/golang-lru/v2 v2.0.7/go.mod h1:QeFd9opnmA6QUJc5vARoKUSoFhyfM2/ZepoAG6RGpeM=
+github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8=
+github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw=
+github.com/lucasb-eyer/go-colorful v1.3.0 h1:2/yBRLdWBZKrf7gB40FoiKfAWYQ0lqNcbuQwVHXptag=
+github.com/lucasb-eyer/go-colorful v1.3.0/go.mod h1:R4dSotOR9KMtayYi1e77YzuveK+i7ruzyGqttikkLy0=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/mattn/go-localereader v0.0.1 h1:ygSAOl7ZXTx4RdPYinUpg6W99U8jWvWi9Ye2JC/oIi4=
+github.com/mattn/go-localereader v0.0.1/go.mod h1:8fBrzywKY7BI3czFoHkuzRoWE9C+EiG4R1k4Cjx5p88=
+github.com/mattn/go-runewidth v0.0.19 h1:v++JhqYnZuu5jSKrk9RbgF5v4CGUjqRfBm05byFGLdw=
+github.com/mattn/go-runewidth v0.0.19/go.mod h1:XBkDxAl56ILZc9knddidhrOlY5R/pDhgLpndooCuJAs=
+github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 h1:ZK8zHtRHOkbHy6Mmr5D264iyp3TiX5OmNcI5cIARiQI=
+github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6/go.mod h1:CJlz5H+gyd6CUWT45Oy4q24RdLyn7Md9Vj2/ldJBSIo=
+github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA=
+github.com/muesli/cancelreader v0.2.2/go.mod h1:3XuTXfFS2VjM+HTLZY9Ak0l6eUKfijIfMUZ4EgX0QYo=
+github.com/muesli/termenv v0.16.0 h1:S5AlUN9dENB57rsbnkPyfdGuWIlkmzJjbFf0Tf5FWUc=
+github.com/muesli/termenv v0.16.0/go.mod h1:ZRfOIKPFDYQoDFF4Olj7/QJbW60Ol/kL1pU3VfY/Cnk=
+github.com/ncruces/go-strftime v1.0.0 h1:HMFp8mLCTPp341M/ZnA4qaf7ZlsbTc+miZjCLOFAw7w=
+github.com/ncruces/go-strftime v1.0.0/go.mod h1:Fwc5htZGVVkseilnfgOVb9mKy6w1naJmn9CehxcKcls=
+github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE=
+github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo=
+github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ=
+github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
+github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
+github.com/spf13/cobra v1.10.2 h1:DMTTonx5m65Ic0GOoRY2c16WCbHxOOw6xxezuLaBpcU=
+github.com/spf13/cobra v1.10.2/go.mod h1:7C1pvHqHw5A4vrJfjNwvOdzYu0Gml16OCs2GRiTUUS4=
+github.com/spf13/pflag v1.0.9 h1:9exaQaMOCwffKiiiYk6/BndUBv+iRViNW+4lEMi0PvY=
+github.com/spf13/pflag v1.0.9/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e h1:JVG44RsyaB9T2KIHavMF/ppJZNG9ZpyihvCd0w101no=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e/go.mod h1:RbqR21r5mrJuqunuUZ/Dhy/avygyECGrLceyNeo4LiM=
+go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=
+golang.org/x/exp v0.0.0-20251023183803-a4bb9ffd2546 h1:mgKeJMpvi0yx/sU5GsxQ7p6s2wtOnGAHZWCHUM4KGzY=
+golang.org/x/exp v0.0.0-20251023183803-a4bb9ffd2546/go.mod h1:j/pmGrbnkbPtQfxEe5D0VQhZC6qKbfKifgD0oM7sR70=
+golang.org/x/mod v0.29.0 h1:HV8lRxZC4l2cr3Zq1LvtOsi/ThTgWnUk/y64QSs8GwA=
+golang.org/x/mod v0.29.0/go.mod h1:NyhrlYXJ2H4eJiRy/WDBO6HMqZQ6q9nk4JzS3NuCK+w=
+golang.org/x/sync v0.17.0 h1:l60nONMj9l5drqw6jlhIELNv9I0A4OFgRsG9k2oT9Ug=
+golang.org/x/sync v0.17.0/go.mod h1:9KTHXmSnoGruLpwFjVSX0lNNA75CykiMECbovNTZqGI=
+golang.org/x/sys v0.0.0-20210809222454-d867a43fc93e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.38.0 h1:3yZWxaJjBmCWXqhN1qh02AkOnCQ1poK6oF+a7xWL6Gc=
+golang.org/x/sys v0.38.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/text v0.3.8 h1:nAL+RVCQ9uMn3vJZbV+MRnydTJFPf8qqY42YiA6MrqY=
+golang.org/x/text v0.3.8/go.mod h1:E6s5w1FMmriuDzIBO73fBruAKo1PCIq6d2Q6DHfQ8WQ=
+golang.org/x/tools v0.38.0 h1:Hx2Xv8hISq8Lm16jvBZ2VQf+RLmbd7wVUsALibYI/IQ=
+golang.org/x/tools v0.38.0/go.mod h1:yEsQ/d/YK8cjh0L6rZlY8tgtlKiBNTL14pGDJPJpYQs=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+modernc.org/cc/v4 v4.27.1 h1:9W30zRlYrefrDV2JE2O8VDtJ1yPGownxciz5rrbQZis=
+modernc.org/cc/v4 v4.27.1/go.mod h1:uVtb5OGqUKpoLWhqwNQo/8LwvoiEBLvZXIQ/SmO6mL0=
+modernc.org/ccgo/v4 v4.30.1 h1:4r4U1J6Fhj98NKfSjnPUN7Ze2c6MnAdL0hWw6+LrJpc=
+modernc.org/ccgo/v4 v4.30.1/go.mod h1:bIOeI1JL54Utlxn+LwrFyjCx2n2RDiYEaJVSrgdrRfM=
+modernc.org/fileutil v1.3.40 h1:ZGMswMNc9JOCrcrakF1HrvmergNLAmxOPjizirpfqBA=
+modernc.org/fileutil v1.3.40/go.mod h1:HxmghZSZVAz/LXcMNwZPA/DRrQZEVP9VX0V4LQGQFOc=
+modernc.org/gc/v2 v2.6.5 h1:nyqdV8q46KvTpZlsw66kWqwXRHdjIlJOhG6kxiV/9xI=
+modernc.org/gc/v2 v2.6.5/go.mod h1:YgIahr1ypgfe7chRuJi2gD7DBQiKSLMPgBQe9oIiito=
+modernc.org/gc/v3 v3.1.1 h1:k8T3gkXWY9sEiytKhcgyiZ2L0DTyCQ/nvX+LoCljoRE=
+modernc.org/gc/v3 v3.1.1/go.mod h1:HFK/6AGESC7Ex+EZJhJ2Gni6cTaYpSMmU/cT9RmlfYY=
+modernc.org/goabi0 v0.2.0 h1:HvEowk7LxcPd0eq6mVOAEMai46V+i7Jrj13t4AzuNks=
+modernc.org/goabi0 v0.2.0/go.mod h1:CEFRnnJhKvWT1c1JTI3Avm+tgOWbkOu5oPA8eH8LnMI=
+modernc.org/libc v1.67.6 h1:eVOQvpModVLKOdT+LvBPjdQqfrZq+pC39BygcT+E7OI=
+modernc.org/libc v1.67.6/go.mod h1:JAhxUVlolfYDErnwiqaLvUqc8nfb2r6S6slAgZOnaiE=
+modernc.org/mathutil v1.7.1 h1:GCZVGXdaN8gTqB1Mf/usp1Y/hSqgI2vAGGP4jZMCxOU=
+modernc.org/mathutil v1.7.1/go.mod h1:4p5IwJITfppl0G4sUEDtCr4DthTaT47/N3aT6MhfgJg=
+modernc.org/memory v1.11.0 h1:o4QC8aMQzmcwCK3t3Ux/ZHmwFPzE6hf2Y5LbkRs+hbI=
+modernc.org/memory v1.11.0/go.mod h1:/JP4VbVC+K5sU2wZi9bHoq2MAkCnrt2r98UGeSK7Mjw=
+modernc.org/opt v0.1.4 h1:2kNGMRiUjrp4LcaPuLY2PzUfqM/w9N23quVwhKt5Qm8=
+modernc.org/opt v0.1.4/go.mod h1:03fq9lsNfvkYSfxrfUhZCWPk1lm4cq4N+Bh//bEtgns=
+modernc.org/sortutil v1.2.1 h1:+xyoGf15mM3NMlPDnFqrteY07klSFxLElE2PVuWIJ7w=
+modernc.org/sortutil v1.2.1/go.mod h1:7ZI3a3REbai7gzCLcotuw9AC4VZVpYMjDzETGsSMqJE=
+modernc.org/sqlite v1.46.1 h1:eFJ2ShBLIEnUWlLy12raN0Z1plqmFX9Qe3rjQTKt6sU=
+modernc.org/sqlite v1.46.1/go.mod h1:CzbrU2lSB1DKUusvwGz7rqEKIq+NUd8GWuBBZDs9/nA=
+modernc.org/strutil v1.2.1 h1:UneZBkQA+DX2Rp35KcM69cSsNES9ly8mQWD71HKlOA0=
+modernc.org/strutil v1.2.1/go.mod h1:EHkiggD70koQxjVdSBM3JKM7k6L0FbGE5eymy9i3B9A=
+modernc.org/token v1.1.0 h1:Xl7Ap9dKaEs5kLoOQeQmPWevfnk/DM5qcLcYlA8ys6Y=
+modernc.org/token v1.1.0/go.mod h1:UGzOrNV1mAFSEB63lOFHIpNRUVMvYTc6yu1SMY/XTDM=

package/internal/agents/agent.go

@@ -0,0 +1,31 @@
+// - Coder: plan + relevant files -> unified diff patch
+package agents
+
+import (
+	"github.com/furkanbeydemir/orch/internal/models"
+)
+
+type Agent interface {
+	Name() string
+
+	Execute(input *Input) (*Output, error)
+}
+
+type Input struct {
+	Task              *models.Task
+	TaskBrief         *models.TaskBrief
+	RepoMap           *models.RepoMap
+	Plan              *models.Plan
+	ExecutionContract *models.ExecutionContract
+	Patch             *models.Patch
+	Context           *models.ContextResult
+	ValidationResults []models.ValidationResult
+	RetryDirective    *models.RetryDirective
+	TestResults       string
+}
+
+type Output struct {
+	Plan   *models.Plan
+	Patch  *models.Patch
+	Review *models.ReviewResult
+}

package/internal/agents/coder.go

@@ -0,0 +1,167 @@
+// Package agents contains the Coder agent implementation.
+package agents
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	"github.com/furkanbeydemir/orch/internal/models"
+	"github.com/furkanbeydemir/orch/internal/providers"
+)
+
+type Coder struct {
+	modelID string
+	runtime *LLMRuntime
+}
+
+func NewCoder(modelID string) *Coder {
+	return &Coder{
+		modelID: modelID,
+	}
+}
+
+func (c *Coder) Name() string {
+	return "coder"
+}
+
+func (c *Coder) SetRuntime(runtime *LLMRuntime) {
+	c.runtime = runtime
+}
+
+func (c *Coder) Execute(input *Input) (*Output, error) {
+	if input.Task == nil {
+		return nil, fmt.Errorf("coder: task description is required")
+	}
+
+	if input.Plan == nil {
+		return nil, fmt.Errorf("coder: plan is required")
+	}
+
+	if c.runtime != nil {
+		response, err := c.runtime.Chat(context.Background(), providers.ChatRequest{
+			Role:         providers.RoleCoder,
+			SystemPrompt: "You are a constrained coding agent. Return a unified diff patch only, keep scope minimal, and obey the execution contract.",
+			UserPrompt:   buildCoderPrompt(input),
+		})
+		if err != nil {
+			return nil, fmt.Errorf("coder provider call failed: %w", err)
+		}
+
+		raw := extractUnifiedDiff(response.Text)
+		patch := &models.Patch{TaskID: input.Task.ID, Files: []models.PatchFile{}, RawDiff: raw}
+		return &Output{Patch: patch}, nil
+	}
+
+	patch := &models.Patch{
+		TaskID:  input.Task.ID,
+		Files:   []models.PatchFile{},
+		RawDiff: "",
+	}
+
+	return &Output{
+		Patch: patch,
+	}, nil
+}
+
+func buildCoderPrompt(input *Input) string {
+	if input == nil || input.Task == nil || input.Plan == nil {
+		return ""
+	}
+
+	var b strings.Builder
+	b.WriteString("Task: ")
+	b.WriteString(input.Task.Description)
+	if input.TaskBrief != nil {
+		b.WriteString("\nNormalized Goal: ")
+		b.WriteString(input.TaskBrief.NormalizedGoal)
+		if input.TaskBrief.TaskType != "" {
+			b.WriteString("\nTask Type: ")
+			b.WriteString(string(input.TaskBrief.TaskType))
+		}
+		if input.TaskBrief.RiskLevel != "" {
+			b.WriteString("\nRisk Level: ")
+			b.WriteString(string(input.TaskBrief.RiskLevel))
+		}
+	}
+	if input.Plan != nil {
+		if input.Plan.Summary != "" {
+			b.WriteString("\nPlan Summary: ")
+			b.WriteString(input.Plan.Summary)
+		}
+		if len(input.Plan.AcceptanceCriteria) > 0 {
+			criteria := make([]string, 0, len(input.Plan.AcceptanceCriteria))
+			for _, criterion := range input.Plan.AcceptanceCriteria {
+				criteria = append(criteria, criterion.Description)
+			}
+			b.WriteString("\nAcceptance Criteria: ")
+			b.WriteString(strings.Join(criteria, " | "))
+		}
+	}
+	if input.ExecutionContract != nil {
+		if len(input.ExecutionContract.AllowedFiles) > 0 {
+			b.WriteString("\nAllowed Files: ")
+			b.WriteString(strings.Join(input.ExecutionContract.AllowedFiles, ", "))
+		}
+		if len(input.ExecutionContract.InspectFiles) > 0 {
+			b.WriteString("\nInspect Files: ")
+			b.WriteString(strings.Join(input.ExecutionContract.InspectFiles, ", "))
+		}
+		if len(input.ExecutionContract.RequiredEdits) > 0 {
+			b.WriteString("\nRequired Edits: ")
+			b.WriteString(strings.Join(input.ExecutionContract.RequiredEdits, " | "))
+		}
+		if len(input.ExecutionContract.ProhibitedActions) > 0 {
+			b.WriteString("\nProhibited Actions: ")
+			b.WriteString(strings.Join(input.ExecutionContract.ProhibitedActions, " | "))
+		}
+		if input.ExecutionContract.PatchBudget.MaxFiles > 0 || input.ExecutionContract.PatchBudget.MaxChangedLines > 0 {
+			b.WriteString(fmt.Sprintf("\nPatch Budget: max_files=%d max_changed_lines=%d", input.ExecutionContract.PatchBudget.MaxFiles, input.ExecutionContract.PatchBudget.MaxChangedLines))
+		}
+	}
+	if input.Context != nil {
+		if len(input.Context.RelatedTests) > 0 {
+			b.WriteString("\nRelated Tests: ")
+			b.WriteString(strings.Join(input.Context.RelatedTests, ", "))
+		}
+	}
+	if input.RetryDirective != nil {
+		b.WriteString("\nRetry Stage: ")
+		b.WriteString(input.RetryDirective.Stage)
+		b.WriteString(fmt.Sprintf("\nRetry Attempt: %d", input.RetryDirective.Attempt))
+		if len(input.RetryDirective.Reasons) > 0 {
+			b.WriteString("\nRetry Reasons: ")
+			b.WriteString(strings.Join(input.RetryDirective.Reasons, " | "))
+		}
+		if len(input.RetryDirective.FailedGates) > 0 {
+			b.WriteString("\nFailed Gates: ")
+			b.WriteString(strings.Join(input.RetryDirective.FailedGates, ", "))
+		}
+		if len(input.RetryDirective.FailedTests) > 0 {
+			b.WriteString("\nFailed Tests: ")
+			b.WriteString(strings.Join(input.RetryDirective.FailedTests, " | "))
+		}
+		if len(input.RetryDirective.Instructions) > 0 {
+			b.WriteString("\nRetry Instructions: ")
+			b.WriteString(strings.Join(input.RetryDirective.Instructions, " | "))
+		}
+		if len(input.RetryDirective.Avoid) > 0 {
+			b.WriteString("\nAvoid: ")
+			b.WriteString(strings.Join(input.RetryDirective.Avoid, " | "))
+		}
+	}
+	b.WriteString("\nReturn unified diff patch only.")
+	return b.String()
+}
+
+func extractUnifiedDiff(text string) string {
+	trimmed := strings.TrimSpace(text)
+	if trimmed == "" {
+		return ""
+	}
+	idx := strings.Index(trimmed, "diff --git")
+	if idx >= 0 {
+		return strings.TrimSpace(trimmed[idx:]) + "\n"
+	}
+	return ""
+}

package/internal/agents/planner.go

@@ -0,0 +1,155 @@
+// Package agents contains the Planner agent implementation.
+package agents
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	"github.com/furkanbeydemir/orch/internal/models"
+	"github.com/furkanbeydemir/orch/internal/providers"
+)
+
+type Planner struct {
+	modelID string
+	runtime *LLMRuntime
+}
+
+func NewPlanner(modelID string) *Planner {
+	return &Planner{
+		modelID: modelID,
+	}
+}
+
+func (p *Planner) Name() string {
+	return "planner"
+}
+
+func (p *Planner) SetRuntime(runtime *LLMRuntime) {
+	p.runtime = runtime
+}
+
+func (p *Planner) Execute(input *Input) (*Output, error) {
+	if input.Task == nil {
+		return nil, fmt.Errorf("planner: task description is required")
+	}
+
+	basePlan := buildBasePlan(input)
+	if p.runtime != nil {
+		response, err := p.runtime.Chat(context.Background(), providers.ChatRequest{
+			Role:         providers.RolePlanner,
+			SystemPrompt: "You are a planning refinement agent. Refine the plan concisely and keep scope bounded.",
+			UserPrompt:   buildPlannerPrompt(input),
+		})
+		if err != nil {
+			return nil, fmt.Errorf("planner provider call failed: %w", err)
+		}
+
+		description := strings.TrimSpace(response.Text)
+		if description == "" {
+			description = fmt.Sprintf("Analyze task: %s", input.Task.Description)
+		}
+
+		plan := clonePlan(basePlan)
+		if strings.TrimSpace(plan.Summary) == "" {
+			plan.Summary = description
+		}
+		plan.Steps = prependRefinementStep(plan.Steps, description)
+		if strings.TrimSpace(plan.TestStrategy) == "" {
+			plan.TestStrategy = "Run the configured test command after code changes"
+		}
+
+		return &Output{Plan: plan}, nil
+	}
+
+	return &Output{Plan: clonePlan(basePlan)}, nil
+}
+
+func buildBasePlan(input *Input) *models.Plan {
+	if input != nil && input.Plan != nil {
+		return input.Plan
+	}
+	if input == nil || input.Task == nil {
+		return &models.Plan{}
+	}
+	return &models.Plan{
+		TaskID:  input.Task.ID,
+		Summary: fmt.Sprintf("Plan task: %s", input.Task.Description),
+		Steps: []models.PlanStep{{
+			Order:       1,
+			Description: fmt.Sprintf("Analyzing task: %s", input.Task.Description),
+		}},
+		FilesToModify:  []string{},
+		FilesToInspect: []string{},
+		Risks:          []string{},
+		TestStrategy:   "Unit tests will be run",
+	}
+}
+
+func buildPlannerPrompt(input *Input) string {
+	if input == nil || input.Task == nil {
+		return ""
+	}
+
+	var b strings.Builder
+	b.WriteString("Task: ")
+	b.WriteString(input.Task.Description)
+	if input.TaskBrief != nil {
+		b.WriteString("\nNormalized Goal: ")
+		b.WriteString(input.TaskBrief.NormalizedGoal)
+		if input.TaskBrief.TaskType != "" {
+			b.WriteString("\nTask Type: ")
+			b.WriteString(string(input.TaskBrief.TaskType))
+		}
+		if input.TaskBrief.RiskLevel != "" {
+			b.WriteString("\nRisk Level: ")
+			b.WriteString(string(input.TaskBrief.RiskLevel))
+		}
+	}
+	if input.Plan != nil {
+		if input.Plan.Summary != "" {
+			b.WriteString("\nDraft Plan Summary: ")
+			b.WriteString(input.Plan.Summary)
+		}
+		if len(input.Plan.FilesToInspect) > 0 {
+			b.WriteString("\nCandidate Files To Inspect: ")
+			b.WriteString(strings.Join(input.Plan.FilesToInspect, ", "))
+		}
+		if len(input.Plan.AcceptanceCriteria) > 0 {
+			criteria := make([]string, 0, len(input.Plan.AcceptanceCriteria))
+			for _, criterion := range input.Plan.AcceptanceCriteria {
+				criteria = append(criteria, criterion.Description)
+			}
+			b.WriteString("\nAcceptance Criteria: ")
+			b.WriteString(strings.Join(criteria, " | "))
+		}
+	}
+	b.WriteString("\nReturn concise plan refinement guidance only.")
+	return b.String()
+}
+
+func clonePlan(plan *models.Plan) *models.Plan {
+	if plan == nil {
+		return &models.Plan{}
+	}
+	cloned := *plan
+	cloned.Steps = append([]models.PlanStep(nil), plan.Steps...)
+	cloned.FilesToModify = append([]string(nil), plan.FilesToModify...)
+	cloned.FilesToInspect = append([]string(nil), plan.FilesToInspect...)
+	cloned.Risks = append([]string(nil), plan.Risks...)
+	cloned.TestRequirements = append([]string(nil), plan.TestRequirements...)
+	cloned.AcceptanceCriteria = append([]models.AcceptanceCriterion(nil), plan.AcceptanceCriteria...)
+	cloned.Invariants = append([]string(nil), plan.Invariants...)
+	cloned.ForbiddenChanges = append([]string(nil), plan.ForbiddenChanges...)
+	return &cloned
+}
+
+func prependRefinementStep(steps []models.PlanStep, description string) []models.PlanStep {
+	updated := make([]models.PlanStep, 0, len(steps)+1)
+	updated = append(updated, models.PlanStep{Order: 1, Description: description})
+	for i, step := range steps {
+		step.Order = i + 2
+		updated = append(updated, step)
+	}
+	return updated
+}

package/internal/agents/reviewer.go

@@ -0,0 +1,118 @@
+// Package agents contains the Reviewer agent implementation.
+package agents
+
+import (
+	"context"
+	"fmt"
+	"strings"
+
+	"github.com/furkanbeydemir/orch/internal/models"
+	"github.com/furkanbeydemir/orch/internal/providers"
+)
+
+type Reviewer struct {
+	modelID string
+	runtime *LLMRuntime
+}
+
+func NewReviewer(modelID string) *Reviewer {
+	return &Reviewer{
+		modelID: modelID,
+	}
+}
+
+func (r *Reviewer) Name() string {
+	return "reviewer"
+}
+
+func (r *Reviewer) SetRuntime(runtime *LLMRuntime) {
+	r.runtime = runtime
+}
+
+func (r *Reviewer) Execute(input *Input) (*Output, error) {
+	if input.Task == nil {
+		return nil, fmt.Errorf("reviewer: task description is required")
+	}
+
+	if input.Patch == nil {
+		return nil, fmt.Errorf("reviewer: patch is required")
+	}
+
+	if r.runtime != nil {
+		response, err := r.runtime.Chat(context.Background(), providers.ChatRequest{
+			Role:         providers.RoleReviewer,
+			SystemPrompt: "You are a reviewer. Decide accept or revise and give concise feedback.",
+			UserPrompt:   buildReviewerPrompt(input),
+		})
+		if err != nil {
+			return nil, fmt.Errorf("reviewer provider call failed: %w", err)
+		}
+
+		review := parseReviewResponse(response.Text)
+		return &Output{Review: review}, nil
+	}
+
+	review := &models.ReviewResult{
+		Decision:    models.ReviewAccept,
+		Comments:    []string{"Patch reviewed"},
+		Suggestions: []string{},
+	}
+
+	return &Output{
+		Review: review,
+	}, nil
+}
+
+func buildReviewerPrompt(input *Input) string {
+	if input == nil || input.Task == nil {
+		return ""
+	}
+
+	var b strings.Builder
+	b.WriteString("Task: ")
+	b.WriteString(input.Task.Description)
+	b.WriteString(fmt.Sprintf("\nPatch length: %d chars", len(input.Patch.RawDiff)))
+	if input.TaskBrief != nil {
+		b.WriteString("\nTask Type: ")
+		b.WriteString(string(input.TaskBrief.TaskType))
+		b.WriteString("\nRisk Level: ")
+		b.WriteString(string(input.TaskBrief.RiskLevel))
+	}
+	if input.Plan != nil && len(input.Plan.AcceptanceCriteria) > 0 {
+		criteria := make([]string, 0, len(input.Plan.AcceptanceCriteria))
+		for _, criterion := range input.Plan.AcceptanceCriteria {
+			criteria = append(criteria, criterion.Description)
+		}
+		b.WriteString("\nAcceptance Criteria: ")
+		b.WriteString(strings.Join(criteria, " | "))
+	}
+	if len(input.ValidationResults) > 0 {
+		parts := make([]string, 0, len(input.ValidationResults))
+		for _, result := range input.ValidationResults {
+			parts = append(parts, fmt.Sprintf("%s=%s", result.Name, result.Status))
+		}
+		b.WriteString("\nValidation Gates: ")
+		b.WriteString(strings.Join(parts, ", "))
+	}
+	b.WriteString("\nTest results: ")
+	b.WriteString(input.TestResults)
+	b.WriteString("\nDecide accept or revise and give concise findings.")
+	return b.String()
+}
+
+func parseReviewResponse(text string) *models.ReviewResult {
+	trimmed := strings.TrimSpace(text)
+	decision := models.ReviewAccept
+	lower := strings.ToLower(trimmed)
+	if strings.Contains(lower, "revise") {
+		decision = models.ReviewRevise
+	}
+	if trimmed == "" {
+		trimmed = "Patch reviewed"
+	}
+	return &models.ReviewResult{
+		Decision:    decision,
+		Comments:    []string{trimmed},
+		Suggestions: []string{},
+	}
+}

package/internal/agents/runtime.go

@@ -0,0 +1,25 @@
+package agents
+
+import (
+	"context"
+
+	"github.com/furkanbeydemir/orch/internal/providers"
+)
+
+type LLMRuntime struct {
+	Router *providers.Router
+}
+
+func (r *LLMRuntime) Chat(ctx context.Context, req providers.ChatRequest) (providers.ChatResponse, error) {
+	if r == nil || r.Router == nil {
+		return providers.ChatResponse{}, nil
+	}
+
+	provider, model, err := r.Router.Resolve(req.Role)
+	if err != nil {
+		return providers.ChatResponse{}, err
+	}
+
+	req.Model = model
+	return provider.Chat(ctx, req)
+}