Method persistInstructionFiles

coderd/x/chatd/chatd.go:9021–9123

persistInstructionFiles fetches AGENTS.md instruction files and skills from the workspace agent, persisting both as message parts. This is called once when a workspace is first attached to a chat (or when the agent changes). Returns the formatted instruction string and skill index for injection into

(
	ctx context.Context,
	chat database.Chat,
	modelConfigID uuid.UUID,
	getWorkspaceAgent func(context.Context) (database.WorkspaceAgent, error),
	getWorkspaceConn func(context.Context) (workspacesdk.AgentConn, error),
)

// instruction string and skill index for injection into the
// current turn's prompt.
func (p *Server) persistInstructionFiles(
	ctx context.Context,
	chat database.Chat,
	modelConfigID uuid.UUID,
	getWorkspaceAgent func(context.Context) (database.WorkspaceAgent, error),
	getWorkspaceConn func(context.Context) (workspacesdk.AgentConn, error),
) (instruction string, skills []chattool.SkillMeta, err error) {
	agent, agentParts, discoveredSkills, workspaceConnOK := p.fetchWorkspaceContext(
		ctx, chat, getWorkspaceAgent, getWorkspaceConn,
	)
	// Defensive guard: fetchWorkspaceContext returns nil when the
	// chat has no valid workspace or the agent lookup fails. It's
	// cheaper to guard here than push the precondition up to all
	// callers.
	if agent == nil {
		return "", nil, nil
	}

	agentID := uuid.NullUUID{UUID: agent.ID, Valid: true}
	hasContent := false
	hasContextFilePart := false
	for _, part := range agentParts {
		if part.Type == codersdk.ChatMessagePartTypeContextFile {
			hasContextFilePart = true
			if part.ContextFileContent != "" {
				hasContent = true
			}
		}
	}
	directory := agent.ExpandedDirectory
	if directory == "" {
		directory = agent.Directory
	}

	if !hasContent {
		if !workspaceConnOK {
			return "", nil, nil
		}
		// Persist a blank context-file marker (plus any skill-only
		// parts) so subsequent turns skip the workspace agent dial.
		if !hasContextFilePart {
			agentParts = append([]codersdk.ChatMessagePart{{
				Type:               codersdk.ChatMessagePartTypeContextFile,
				ContextFileAgentID: agentID,
			}}, agentParts...)
		}
		content, err := chatprompt.MarshalParts(agentParts)
		if err != nil {
			return "", nil, nil
		}
		contextAPIKeyID, _ := aibridge.DelegatedAPIKeyIDFromContext(ctx)
		msgParams := database.InsertChatMessagesParams{ //nolint:exhaustruct // Fields populated by appendUserChatMessage.
			ChatID: chat.ID,
		}
		appendUserChatMessage(&msgParams, newUserChatMessage(
			contextAPIKeyID,
			content,
			database.ChatMessageVisibilityBoth,