message

type AddInput struct {
	Role    string `json:"role" description:"Message role. Currently only assistant is supported."`
	Content string `json:"content" description:"Message content to persist in the current turn."`
	Interim *bool  `json:"interim,omitempty" description:"Whether the message is interim. Defaults to false."`
	Mode    string `json:"mode,omitempty" description:"Optional message mode, e.g. task or exec."`
	Status  string `json:"status,omitempty" description:"Optional message status."`
}

type AddOutput struct {
	MessageID       string `json:"messageId,omitempty"`
	ConversationID  string `json:"conversationId,omitempty"`
	TurnID          string `json:"turnId,omitempty"`
	ParentMessageID string `json:"parentMessageId,omitempty"`
	Sequence        int    `json:"sequence,omitempty"`
}

type AskUserInput struct {
	Message         string                 `json:"message" description:"The question or prompt to display to the user."`
	RequestedSchema map[string]interface{} `json:"requestedSchema,omitempty" description:"Optional JSON Schema for the expected user response."`
	Schema          map[string]interface{} `json:"schema,omitempty" description:"Legacy alias for requestedSchema."`
}

type AskUserOutput struct {
	Action  string                 `json:"action"`
	Payload map[string]interface{} `json:"payload,omitempty"`
}

type Candidate struct {
	MessageID string `json:"messageId"`
	Type      string `json:"type"`
	Role      string `json:"role,omitempty"`
	ToolName  string `json:"toolName,omitempty"`
	Preview   string `json:"preview"`
	ByteSize  int    `json:"byteSize"`
	TokenSize int    `json:"tokenSize"`
}

type CompactInput struct {
	MaxTokens      int    `json:"maxTokens" description:"Target total token budget for retained messages."`
	Strategy       string `` /* 146-byte string literal not displayed */
	PreservePinned bool   `json:"preservePinned,omitempty" description:"Reserved for future use (no effect in v1)."`
}

type CompactOutput struct {
	RemovedCount int `json:"removedCount"`
	FreedTokens  int `json:"freedTokens"`
	KeptTokens   int `json:"keptTokens"`
}

type DebugInfo struct {
	Source     string `json:"source,omitempty"`
	RawLen     int    `json:"rawLen,omitempty"`
	RawPreview string `json:"rawPreview,omitempty"`
}

type Elicitor interface {
	Elicit(ctx context.Context, turn *runtimerequestctx.TurnMeta, role string, req *execution.Elicitation) (messageID string, status string, payload map[string]interface{}, err error)
}

type ListCandidatesInput struct {
	// Max number of candidates to return (default: 50)
	Limit int `json:"limit,omitempty" description:"Max number of candidates to return (default 50)."`
	// Types filter (user, assistant, tool). Empty = all
	Types []string `json:"types,omitempty" description:"Optional types to include: user, assistant, tool."`
}

type ListCandidatesOutput struct {
	Candidates []Candidate `json:"candidates"`
}

type MatchFragment struct {
	Offset  int     `json:"offset"`
	Limit   int     `json:"limit"`
	Score   float64 `json:"score"`
	Content string  `json:"content"`
}

type MatchInput struct {
	MessageID string `json:"messageId"`
	Query     string `json:"query"`
	TopK      int    `json:"topK,omitempty"`
}

type MatchOutput struct {
	Size      int             `json:"size"`
	Fragments []MatchFragment `json:"fragments"`
}

type Option func(*Service)

type ProjectInput struct {
	TurnIDs    []string `json:"turnIds,omitempty" description:"turn IDs to hide from active prompt history"`
	MessageIDs []string `json:"messageIds,omitempty" description:"message IDs to hide from active prompt history"`
	Reason     string   `json:"reason,omitempty" description:"short human-readable reason for the projection update"`
}

type ProjectOutput struct {
	HiddenTurnIDs    []string `json:"hiddenTurnIds,omitempty"`
	HiddenMessageIDs []string `json:"hiddenMessageIds,omitempty"`
	Reason           string   `json:"reason,omitempty"`
}

type RemoveInput struct {
	Tuples []RemoveTuple `json:"tuples"`
}

type RemoveOutput struct {
	CreatedSummaryMessageIds []string `json:"createdSummaryMessageIds"`
	ArchivedMessages         int      `json:"archivedMessages"`
}

type RemoveTuple struct {
	Summary    string   `json:"summary" description:"summary to associate with removed messages"`
	MessageIds []string `json:"messageIds"`
	Role       string   `json:"role,omitempty"`
}

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

type ShowInput struct {
	MessageID string             `json:"messageId"`
	ByteRange *textutil.IntRange `json:"byteRange,omitempty" description:"Optional byte range [from,to) over the selected content."`
	Sed       []string           `json:"sed,omitempty" description:"List of sed programs applied in order to the selected content."`
	Transform *TransformSpec     `json:"transform,omitempty" description:"Transform with selector+fields or queryLanguage+query, then format as csv or ndjson."`
}

type ShowOutput struct {
	MessageID string `json:"messageId,omitempty"`
	Content   string `json:"content"`
	Offset    int    `json:"offset"`
	Limit     int    `json:"limit"`
	Size      int    `json:"size"`
	// Continuation carries paging/truncation hints when only part of the message is returned.
	Continuation *extension.Continuation `json:"continuation,omitempty"`
}

type SummarizeChunk struct {
	Offset  int    `json:"offset"`
	Limit   int    `json:"limit"`
	Summary string `json:"summary"`
}

type SummarizeInput struct {
	Body      string `json:"body" internal:"true"`
	MessageID string `json:"messageId"`
	Chunk     int    `json:"chunk,omitempty"`
	Page      int    `json:"page,omitempty"`
	PerPage   int    `json:"perPage,omitempty"`
}

type SummarizeOutput struct {
	Size        int              `json:"size"`
	Chunks      []SummarizeChunk `json:"chunks"`
	Summary     string           `json:"summary"`
	TotalChunks int              `json:"totalChunks"`
	TotalPages  int              `json:"totalPages"`
	Page        int              `json:"page"`
	PerPage     int              `json:"perPage"`
}

type TransformSpec struct {
	Selector string   `json:"selector,omitempty" description:"Simple dot-path (e.g., data or data.items). No wildcards or object construction."`
	Format   string   `json:"format,omitempty" description:"Output format" choices:"csv,ndjson"`
	Fields   []string `json:"fields,omitempty" description:"CSV column order; derived when empty."`
	MaxRows  int      `json:"maxRows,omitempty" description:"Row cap (0 = no cap)."`
}