chat

Documentation

Overview

Package chat is the advisory surface: pick an agent and talk to it.

This is deliberately NOT the build engine. The orchestrator claims an issue, takes a lease, writes to a worktree and opens a branch. A chat answers a question. Sharing the machinery would mean every conversation held a lease on something and every typo cost a run.

What makes an answer worth having is the grounding: the agent's own persona, plus a recall from the PROJECT brain, so replies come from what this project knows rather than from the model's priors. An agent that answers about your deploy policy from its training data is worse than one that says it does not know, because you cannot tell the difference.

Index

• type Recaller
• type Service
  • func New(db *sql.DB, log *slog.Logger, b Recaller) *Service
  • func (s *Service) Routes(r chi.Router)

Types

type Recaller

type Recaller interface {
	// Recall takes the AGENT slug, not a namespace: the store resolves which
	// brains that agent may read, which is what keeps a chat inside the same
	// grants the agent works under.
	Recall(ctx context.Context, agentSlug, query string, limit int) ([]brain.Memory, error)
}

Recaller is the brain, narrowed to the one read this package makes.

type Service

type Service struct {
	// contains filtered or unexported fields
}

func New

func New(db *sql.DB, log *slog.Logger, b Recaller) *Service

func (*Service) Routes

func (s *Service) Routes(r chi.Router)