Method AddAttachedFile

pkg/session/session.go:724–738

AddAttachedFile records absPath as a file the user attached to this session. The path must be absolute; relative paths are silently dropped (with a debug log) since they would be ambiguous to sub-agents started in a fresh working directory. Empty paths and duplicates already present in AttachedFiles

(absPath string)

// so that delegated agents can read the same files without having to scan the
// workspace or guess from a bare filename.
func (s *Session) AddAttachedFile(absPath string) {
	if absPath == "" {
		return
	}
	if !filepath.IsAbs(absPath) {
		slog.Debug("ignoring non-absolute attached file path", "session_id", s.ID, "path", absPath)
		return
	}
	s.mu.Lock()
	defer s.mu.Unlock()
	if slices.Contains(s.AttachedFiles, absPath) {
		return
	}
	s.AttachedFiles = append(s.AttachedFiles, absPath)
}

// AttachedFilesSnapshot returns a copy of the session's attached file paths.
// Callers may freely mutate the returned slice without affecting the session.