tutti/packages/agent/runtimeprep/provider_instruction_file.go

package runtimeprep

import (
	"context"
	"path/filepath"
	"strings"
)

type InstructionFilePreparer struct {
	ProviderID string
	FileName   string
}

func (p InstructionFilePreparer) Provider() string {
	return strings.TrimSpace(p.ProviderID)
}

func (p InstructionFilePreparer) Prepare(_ context.Context, input ProviderPrepareInput) (ProviderPrepareResult, error) {
	fileName := strings.TrimSpace(p.FileName)
	if fileName == "" {
		fileName = "AGENTS.md"
	}
	path := filepath.Join(input.Cwd, fileName)
	policy, err := tuttiCLIPolicy(input.PrepareInput)
	if err != nil {
		return ProviderPrepareResult{}, err
	}
	writeResult, err := input.Store.WriteManagedBlock(path, policy)
	if err != nil {
		return ProviderPrepareResult{}, err
	}
	if input.Manifest != nil {
		input.Manifest.RecordManagedFile(path, "provider-instructions", writeResult.Created)
	}
	skillRoots, err := cwdExtensionSkillRoots(input.ExtensionSkillRoots)
	if err != nil {
		return ProviderPrepareResult{}, err
	}
	usesExtensionSkillRoots := len(skillRoots) > 0
	if len(skillRoots) == 0 {
		if root := providerSkillRoot(input.Cwd, input.Provider); root != "" {
			skillRoots = []string{root}
		}
	}
	installSkills := installProviderNativeSkills
	if usesExtensionSkillRoots {
		installSkills = installProviderNativeSkillsStable
	}
	for _, skillRoot := range skillRoots {
		if !filepath.IsAbs(skillRoot) {
			skillRoot = filepath.Join(input.Cwd, skillRoot)
		}
		skillPaths, err := installSkills(skillRoot, input.PrepareInput)
		if err != nil {
			return ProviderPrepareResult{}, err
		}
		if input.Manifest != nil {
			for _, skillPath := range skillPaths {
				input.Manifest.RecordManagedFile(skillPath, "provider-skill", true)
			}
		}
	}
	return ProviderPrepareResult{
		Cwd: input.Cwd,
	}, nil
}

func cwdExtensionSkillRoots(declaredRoots []string) ([]string, error) {
	roots := make([]string, 0, len(declaredRoots))
	for _, root := range declaredRoots {
		root = strings.TrimSpace(root)
		if root == "" {
			continue
		}
		if err := validateExtensionRuntimeRelPath(root, "extension runtime skill root"); err != nil {
			return nil, err
		}
		roots = appendUniquePath(roots, filepath.Clean(filepath.FromSlash(root)))
	}
	return roots, nil
}