wsagent

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)
}

type HandlerFuncs struct {
	TraceAppendFn  func(ctx context.Context, line string)
	TraceReplaceFn func(ctx context.Context, line string)
}

type Result struct {
	Status Status
	// ReplyText is the agent's reply, set only on StatusCompleted. The usecase
	// layer posts it to the workspace-channel thread.
	ReplyText string
	// BusyOwner is the Slack user id of the turn currently holding the lock,
	// set only on StatusBusy.
	BusyOwner string
}

type Status int

type TurnRequest struct {
	// Session is the (channel, thread) session; CaseID is 0 (workspace-scoped,
	// not bound to any single case).
	Session *model.Session
	// Workspace is the channel-mode workspace whose workspace channel was
	// mentioned.
	Workspace *model.WorkspaceEntry
	// ActorID is the mentioning Slack user id — the access actor. The host
	// injects it as the ctx auth token so every casemulti read/write enforces
	// this user's private-case membership.
	ActorID string
	// MentionText is the user's message (with the bot mention stripped by the
	// caller). Used as the planner UserInput.
	MentionText string
	// TriggerTS is the Slack ts of the triggering event, used for turn-lock
	// idempotency.
	TriggerTS string
	// Handler receives progress-trace callbacks. May be nil (treated as no-op).
	Handler Handler
}

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