probo/pkg/agentrun/service.go

// Copyright (c) 2026 Probo Inc <hello@probo.com>.
//
// 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
}