pins.go RawHistoryFolder

1package skills
2
3import (
4	"fmt"
5	"sort"
6	"strings"
7)
8
9// Pins records independent global and project selections by discovered name.
10type Pins struct {
11	Global  []string `json:"global,omitempty"`
12	Project []string `json:"project,omitempty"`
13}
14
15// Resolve returns each available pinned skill once, in name order.
16func (p Pins) Resolve(available []*Skill) ([]*Skill, []string) {
17	names := make(map[string]bool)
18	for _, name := range append(append([]string(nil), p.Global...), p.Project...) {
19		names[name] = true
20	}
21	sorted := make([]string, 0, len(names))
22	for name := range names {
23		sorted = append(sorted, name)
24	}
25	sort.Strings(sorted)
26	var selected []*Skill
27	var warnings []string
28	for _, name := range sorted {
29		if s := FindByName(available, name); s != nil {
30			selected = append(selected, s)
31		} else {
32			warnings = append(warnings, fmt.Sprintf("pinned skill %q is unavailable", name))
33		}
34	}
35	return selected, warnings
36}
37
38// PreloadPrompt includes pinned instructions with the first real request.
39// It creates no synthetic tool calls and does not start a model turn.
40func PreloadPrompt(selected []*Skill, request string) string {
41	if len(selected) == 0 {
42		return request
43	}
44	var b strings.Builder
45	b.WriteString("Pinned skills for this conversation. Apply these instructions where relevant to the user's requests.\n\n")
46	for _, s := range selected {
47		b.WriteString(InvocationPrompt(s, ""))
48		b.WriteString("\n\n")
49	}
50	b.WriteString("---\n\nUser request:\n")
51	b.WriteString(request)
52	return b.String()
53}