threadcase

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

type CreateDecision struct {
	Title       string          `json:"title" description:"A concise case title summarising the thread." required:"true"`
	Description string          `json:"description" description:"A clear case description derived from the thread and your investigation." required:"true"`
	Fields      []DecisionField `` /* 134-byte string literal not displayed */
}

type CreatePayload struct {
	Title       string
	Description string
	Fields      map[string]model.FieldValue
}

type Decision struct {
	Kind        DecisionKind    `` /* 300-byte string literal not displayed */
	Message     string          `json:"message,omitempty" description:"For respond: the reply text shown to the user. Omit for materialize."`
	Title       string          `json:"title,omitempty" description:"For materialize: a concise case title summarising the thread."`
	Description string          `json:"description,omitempty" description:"For materialize: a clear case description derived from the thread."`
	Fields      []DecisionField `json:"fields,omitempty" description:"For materialize: custom field assignments. Only include fields you are confident about."`
}

type DecisionField struct {
	FieldID string   `json:"field_id" description:"The field id from the workspace schema." required:"true"`
	Value   string   `json:"value,omitempty" description:"Scalar value (text / number / url / single select option id)."`
	Values  []string `json:"values,omitempty" description:"Multi-select option ids."`
}

type DecisionKind string

type Handler interface {
	// TraceAppend records a milestone line that must stay visible (planner
	// rounds, task results) in the thread-side trace block.
	TraceAppend(ctx context.Context, line string)
	// TraceReplace overwrites the single transient activity line in place, so
	// per-tool chatter ("Searching…", "Fetching…") does not accumulate.
	TraceReplace(ctx context.Context, line string)
	// Question posts a question to the user. Returning an error aborts the turn.
	Question(ctx context.Context, ssn *model.Session, q QuestionPayload) error
	// Create persists a new case for the ModeCreate flow and returns it. The host
	// invokes it once, AFTER the turn completes, with the field values the
	// in-loop finalizer already validated against the workspace schema. A returned
	// error is a persistence failure the model cannot repair by re-emitting JSON,
	// so it is NOT fed back for regeneration; the host surfaces it and falls back.
	// Only called in ModeCreate turns.
	Create(ctx context.Context, ssn *model.Session, p CreatePayload) (*model.Case, error)
}

type HandlerFuncs struct {
	TraceAppendFn  func(ctx context.Context, line string)
	TraceReplaceFn func(ctx context.Context, line string)
	QuestionFn     func(ctx context.Context, ssn *model.Session, q QuestionPayload) error
	CreateFn       func(ctx context.Context, ssn *model.Session, p CreatePayload) (*model.Case, error)
}

type Mode int

type QuestionItem struct {
	ID      string
	Text    string
	Type    QuestionItemType
	Options []string
}

type QuestionItemType string

type QuestionPayload struct {
	Reason string
	Items  []QuestionItem
}

type Result struct {
	Status    Status
	Decision  *Decision
	BusyOwner *model.Session
	// Case is the newly created case for a ModeCreate turn that committed it
	// (via Handler.Create inside the planner loop). Nil for other modes and
	// for non-completed statuses.
	Case *model.Case
	// FallbackReason is the human-readable cause of a StatusFallback turn
	// (propagated from planexec's RunResult.FallbackReason). Empty for other
	// statuses. The host surfaces it to the user as the technical note of the
	// fallback message instead of a generic error; it never crosses back into
	// the loop.
	FallbackReason string
}

type Status int

type TurnRequest struct {
	Session   *model.Session
	Workspace *model.WorkspaceEntry
	Case      *model.Case

	ChannelID   string
	ThreadTS    string
	MentionTS   string
	MentionText string

	SystemMessages []ConversationMessage
	DeltaMessages  []ConversationMessage

	// TriggerTS is the Slack TS used as both the trace ID seed and the lock
	// trigger key (duplicate-event dedup).
	TriggerTS string

	// Mode selects the turn purpose (materialize on creation vs mention).
	Mode Mode

	// CreateInstruction is an optional extra instruction appended to the
	// ModeCreate planner system prompt (under a "# Trigger context" heading).
	// It lets a host inject trigger-specific guidance the generic prompt cannot
	// know — e.g. that the case was raised by a reaction on one message and the
	// surrounding conversation must be read. Empty and ignored for other modes.
	CreateInstruction string

	Handler Handler
}

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