agent/pkg/agentic/sync.go
Virgil bad6d66abf feat(agentic): harden RFC platform sync handling
Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-31 13:19:18 +00:00

340 lines
8.5 KiB
Go

// SPDX-License-Identifier: EUPL-1.2
package agentic
import (
"context"
"time"
core "dappco.re/go/core"
)
type SyncPushInput struct {
AgentID string `json:"agent_id,omitempty"`
}
type SyncPushOutput struct {
Success bool `json:"success"`
Count int `json:"count"`
}
type SyncPullInput struct {
AgentID string `json:"agent_id,omitempty"`
}
type SyncPullOutput struct {
Success bool `json:"success"`
Count int `json:"count"`
Context []map[string]any `json:"context"`
}
type syncQueuedPush struct {
AgentID string `json:"agent_id"`
Dispatches []map[string]any `json:"dispatches"`
QueuedAt time.Time `json:"queued_at"`
}
type syncStatusState struct {
LastPushAt time.Time `json:"last_push_at,omitempty"`
LastPullAt time.Time `json:"last_pull_at,omitempty"`
}
// result := c.Action("agentic.sync.push").Run(ctx, core.NewOptions())
func (s *PrepSubsystem) handleSyncPush(ctx context.Context, options core.Options) core.Result {
output, err := s.syncPush(ctx, options.String("agent_id"))
if err != nil {
return core.Result{Value: err, OK: false}
}
return core.Result{Value: output, OK: true}
}
// result := c.Action("agentic.sync.pull").Run(ctx, core.NewOptions())
func (s *PrepSubsystem) handleSyncPull(ctx context.Context, options core.Options) core.Result {
output, err := s.syncPull(ctx, options.String("agent_id"))
if err != nil {
return core.Result{Value: err, OK: false}
}
return core.Result{Value: output, OK: true}
}
func (s *PrepSubsystem) syncPush(ctx context.Context, agentID string) (SyncPushOutput, error) {
if agentID == "" {
agentID = AgentName()
}
dispatches := collectSyncDispatches()
token := s.syncToken()
if token == "" {
return SyncPushOutput{Success: true, Count: 0}, nil
}
queuedPushes := readSyncQueue()
if len(dispatches) > 0 {
queuedPushes = append(queuedPushes, syncQueuedPush{
AgentID: agentID,
Dispatches: dispatches,
QueuedAt: time.Now(),
})
}
if len(queuedPushes) == 0 {
return SyncPushOutput{Success: true, Count: 0}, nil
}
synced := 0
for i, queued := range queuedPushes {
if len(queued.Dispatches) == 0 {
continue
}
if err := s.postSyncPush(ctx, queued.AgentID, queued.Dispatches, token); err != nil {
writeSyncQueue(queuedPushes[i:])
return SyncPushOutput{Success: true, Count: synced}, nil
}
synced += len(queued.Dispatches)
recordSyncPush(time.Now())
}
writeSyncQueue(nil)
return SyncPushOutput{Success: true, Count: synced}, nil
}
func (s *PrepSubsystem) syncPull(ctx context.Context, agentID string) (SyncPullOutput, error) {
if agentID == "" {
agentID = AgentName()
}
token := s.syncToken()
if token == "" {
cached := readSyncContext()
return SyncPullOutput{Success: true, Count: len(cached), Context: cached}, nil
}
endpoint := core.Concat(s.syncAPIURL(), "/v1/agent/context?agent_id=", agentID)
result := HTTPGet(ctx, endpoint, token, "Bearer")
if !result.OK {
cached := readSyncContext()
return SyncPullOutput{Success: true, Count: len(cached), Context: cached}, nil
}
var response map[string]any
parseResult := core.JSONUnmarshalString(result.Value.(string), &response)
if !parseResult.OK {
cached := readSyncContext()
return SyncPullOutput{Success: true, Count: len(cached), Context: cached}, nil
}
contextData := syncContextPayload(response)
writeSyncContext(contextData)
recordSyncPull(time.Now())
return SyncPullOutput{
Success: true,
Count: len(contextData),
Context: contextData,
}, nil
}
func (s *PrepSubsystem) syncAPIURL() string {
if value := core.Env("CORE_API_URL"); value != "" {
return value
}
if s != nil && s.brainURL != "" {
return s.brainURL
}
return "https://api.lthn.sh"
}
func (s *PrepSubsystem) syncToken() string {
if value := core.Env("CORE_AGENT_API_KEY"); value != "" {
return value
}
if value := core.Env("CORE_BRAIN_KEY"); value != "" {
return value
}
if s != nil && s.brainKey != "" {
return s.brainKey
}
return ""
}
func collectSyncDispatches() []map[string]any {
var dispatches []map[string]any
for _, path := range WorkspaceStatusPaths() {
workspaceDir := core.PathDir(path)
statusResult := ReadStatusResult(workspaceDir)
workspaceStatus, ok := workspaceStatusValue(statusResult)
if !ok {
continue
}
if !shouldSyncStatus(workspaceStatus.Status) {
continue
}
dispatches = append(dispatches, syncDispatchRecord(workspaceDir, workspaceStatus))
}
return dispatches
}
func shouldSyncStatus(status string) bool {
switch status {
case "completed", "merged", "failed", "blocked":
return true
}
return false
}
func (s *PrepSubsystem) postSyncPush(ctx context.Context, agentID string, dispatches []map[string]any, token string) error {
payload := map[string]any{
"agent_id": agentID,
"dispatches": dispatches,
}
result := HTTPPost(ctx, core.Concat(s.syncAPIURL(), "/v1/agent/sync"), core.JSONMarshalString(payload), token, "Bearer")
if result.OK {
return nil
}
err, _ := result.Value.(error)
if err == nil {
err = core.E("agentic.sync.push", "sync push failed", nil)
}
return err
}
func syncStateDir() string {
return core.JoinPath(CoreRoot(), "sync")
}
func syncQueuePath() string {
return core.JoinPath(syncStateDir(), "queue.json")
}
func syncContextPath() string {
return core.JoinPath(syncStateDir(), "context.json")
}
func syncStatusPath() string {
return core.JoinPath(syncStateDir(), "status.json")
}
func readSyncQueue() []syncQueuedPush {
var queued []syncQueuedPush
result := fs.Read(syncQueuePath())
if !result.OK {
return queued
}
parseResult := core.JSONUnmarshalString(result.Value.(string), &queued)
if !parseResult.OK {
return []syncQueuedPush{}
}
return queued
}
func writeSyncQueue(queued []syncQueuedPush) {
if len(queued) == 0 {
fs.Delete(syncQueuePath())
return
}
fs.EnsureDir(syncStateDir())
fs.WriteAtomic(syncQueuePath(), core.JSONMarshalString(queued))
}
func readSyncContext() []map[string]any {
var contextData []map[string]any
result := fs.Read(syncContextPath())
if !result.OK {
return contextData
}
parseResult := core.JSONUnmarshalString(result.Value.(string), &contextData)
if !parseResult.OK {
return []map[string]any{}
}
return contextData
}
func writeSyncContext(contextData []map[string]any) {
fs.EnsureDir(syncStateDir())
fs.WriteAtomic(syncContextPath(), core.JSONMarshalString(contextData))
}
func syncContextPayload(payload map[string]any) []map[string]any {
if contextData := payloadDataSlice(payload, "context", "items", "memories"); len(contextData) > 0 {
return contextData
}
return nil
}
func syncDispatchRecord(workspaceDir string, workspaceStatus *WorkspaceStatus) map[string]any {
record := map[string]any{
"workspace": WorkspaceName(workspaceDir),
"repo": workspaceStatus.Repo,
"org": workspaceStatus.Org,
"task": workspaceStatus.Task,
"agent": workspaceStatus.Agent,
"branch": workspaceStatus.Branch,
"status": workspaceStatus.Status,
"question": workspaceStatus.Question,
"issue": workspaceStatus.Issue,
"runs": workspaceStatus.Runs,
"process_id": workspaceStatus.ProcessID,
"pr_url": workspaceStatus.PRURL,
"started_at": workspaceStatus.StartedAt,
"updated_at": workspaceStatus.UpdatedAt,
}
if report := readSyncWorkspaceReport(workspaceDir); len(report) > 0 {
record["report"] = report
if findings := anyMapSliceValue(report["findings"]); len(findings) > 0 {
record["findings"] = findings
}
if changes := anyMapValue(report["changes"]); len(changes) > 0 {
record["changes"] = changes
}
}
return record
}
func readSyncWorkspaceReport(workspaceDir string) map[string]any {
reportPath := core.JoinPath(WorkspaceMetaDir(workspaceDir), "report.json")
result := fs.Read(reportPath)
if !result.OK {
return nil
}
var report map[string]any
parseResult := core.JSONUnmarshalString(result.Value.(string), &report)
if !parseResult.OK {
return nil
}
return report
}
func readSyncStatusState() syncStatusState {
var state syncStatusState
result := fs.Read(syncStatusPath())
if !result.OK {
return state
}
parseResult := core.JSONUnmarshalString(result.Value.(string), &state)
if !parseResult.OK {
return syncStatusState{}
}
return state
}
func writeSyncStatusState(state syncStatusState) {
fs.EnsureDir(syncStateDir())
fs.WriteAtomic(syncStatusPath(), core.JSONMarshalString(state))
}
func recordSyncPush(at time.Time) {
state := readSyncStatusState()
state.LastPushAt = at
writeSyncStatusState(state)
}
func recordSyncPull(at time.Time) {
state := readSyncStatusState()
state.LastPullAt = at
writeSyncStatusState(state)
}