// Copyright (c) 2026 Probo Inc . // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE // SOFTWARE. package agentrun import ( "context" "errors" "fmt" "time" "go.gearno.de/kit/pg" "go.probo.inc/probo/pkg/agent" "go.probo.inc/probo/pkg/coredata" "go.probo.inc/probo/pkg/gid" "go.probo.inc/probo/pkg/page" ) type Service struct { pg *pg.Client } func NewService(pgClient *pg.Client) *Service { return &Service{pg: pgClient} } func (s *Service) Get( ctx context.Context, scope coredata.Scoper, agentRunID gid.GID, ) (*coredata.AgentRun, error) { run := &coredata.AgentRun{} err := s.pg.WithConn( ctx, func(ctx context.Context, conn pg.Querier) error { if err := run.LoadByID(ctx, conn, scope, agentRunID); err != nil { return fmt.Errorf("cannot load agent run: %w", err) } return nil }, ) if err != nil { return nil, err } return run, nil } func (s *Service) ListForOrganizationID( ctx context.Context, scope coredata.Scoper, organizationID gid.GID, cursor *page.Cursor[coredata.AgentRunOrderField], ) (*page.Page[*coredata.AgentRun, coredata.AgentRunOrderField], error) { var runs coredata.AgentRuns err := s.pg.WithConn( ctx, func(ctx context.Context, conn pg.Querier) error { organization := &coredata.Organization{} if err := organization.LoadByID(ctx, conn, scope, organizationID); err != nil { return fmt.Errorf("cannot load organization: %w", err) } if err := runs.LoadByOrganizationID(ctx, conn, scope, organization.ID, cursor); err != nil { return fmt.Errorf("cannot load agent runs: %w", err) } return nil }, ) if err != nil { return nil, err } return page.NewPage(runs, cursor), nil } // SubmitApproval records human approval decisions for a run parked in // AWAITING_APPROVAL and requeues it to PENDING so a worker resumes it. // decisions is keyed by pending tool-call ID and must cover exactly the // run's pending approvals (a missing decision would be treated as an // implicit denial on resume, so partial submissions are rejected). The // refreshed run is returned. func (s *Service) SubmitApproval( ctx context.Context, scope coredata.Scoper, agentRunID gid.GID, decisions map[string]agent.ApprovalResult, ) (*coredata.AgentRun, error) { run := &coredata.AgentRun{} err := s.pg.WithTx( ctx, func(ctx context.Context, tx pg.Tx) error { if err := run.LoadByIDForUpdate(ctx, tx, scope, agentRunID); err != nil { if errors.Is(err, coredata.ErrResourceNotFound) { return ErrAgentRunNotFound } return fmt.Errorf("cannot load agent run: %w", err) } if run.Status != coredata.AgentRunStatusAwaitingApproval { return ErrNotAwaitingApproval } if run.Checkpoint == nil { return fmt.Errorf("agent run %s has no checkpoint", agentRunID) } checkpoint, err := agent.MergeApprovalDecisions(run.Checkpoint, decisions) if err != nil { if errors.Is(err, agent.ErrApprovalDecisionsMismatch) { return ErrApprovalDecisionsMismatch } return fmt.Errorf("cannot merge approval decisions: %w", err) } run.Checkpoint = checkpoint run.Status = coredata.AgentRunStatusPending run.StartedAt = nil run.UpdatedAt = time.Now() if err := run.RequeueForApprovalResume(ctx, tx, scope); err != nil { return fmt.Errorf("cannot requeue agent run for approval resume: %w", err) } return nil }, ) if err != nil { return nil, err } return run, nil } func (s *Service) CountForOrganizationID( ctx context.Context, scope coredata.Scoper, organizationID gid.GID, ) (int, error) { var count int err := s.pg.WithConn( ctx, func(ctx context.Context, conn pg.Querier) (err error) { runs := &coredata.AgentRuns{} count, err = runs.CountByOrganizationID(ctx, conn, scope, organizationID) if err != nil { return fmt.Errorf("cannot count agent runs: %w", err) } return nil }, ) if err != nil { return 0, err } return count, nil }