casebound

type ConversationMessage struct {
	UserID    string
	UserName  string
	Text      string
	Timestamp string
}

type Host interface {
	// Reply posts the agent's answer to the thread.
	Reply(ctx context.Context, channelID, threadTS, text string) error
	// ReportFailure tells the user the turn could not finish. reason is the
	// technical cause; the host decides how much of it to show.
	ReportFailure(ctx context.Context, channelID, threadTS, reason string) error
}

type HostFuncs struct {
	ReplyFn         func(ctx context.Context, channelID, threadTS, text string) error
	ReportFailureFn func(ctx context.Context, channelID, threadTS, reason string) error
}

type Result struct {
	Status Status
	// ProcessID names the run. Set for StatusStarted, and for StatusDuplicate
	// where it names the run the earlier delivery started.
	ProcessID agentkit.ProcessID
	// Busy describes the run holding the thread, when it could still be read.
	Busy *agentkernel.BusyTurn
}

type Status int

type TurnRequest struct {
	// Session is the persisted Session for this thread. It must already exist:
	// its ID is the turn-lock subject, so the row has to be claimed before a
	// turn can be spawned.
	Session *model.Session

	ChannelID   string
	ThreadTS    string
	MentionTS   string
	MentionText string
	// MentionUserID is the Slack user who mentioned the bot. It becomes the
	// access actor for the whole run, so tools see exactly what that person may
	// see. A turn without it is refused: a run with no actor is read by the
	// usecase layer as a system context and would bypass private-case access
	// control entirely.
	MentionUserID string
	BotUserID     string

	Workspace     *model.WorkspaceEntry
	Case          *model.Case
	Actions       []*model.Action
	CurrentAction *model.Action

	// SystemMessages is the conversation snapshot inlined into the system
	// prompt; it is non-empty only for a fresh session. DeltaMessages is what
	// arrived since the previous mention.
	SystemMessages []ConversationMessage
	DeltaMessages  []ConversationMessage

	// TriggerTS is the Slack TS of the event that started this turn. It is the
	// idempotency key, which is what makes a re-delivered Slack event resolve to
	// the run it already started instead of starting a second one.
	TriggerTS string
}

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