tools

type AskPeerClaudeInput struct {
	Prompt         string `json:"prompt" jsonschema:"the question or instruction to send to the peer's Claude"`
	Project        string `json:"project,omitempty" jsonschema:"working directory the agent's tools see (default: hearsay's cwd)"`
	MaxTokens      int    `json:"max_tokens,omitempty"`
	MaxToolCalls   int    `json:"max_tool_calls,omitempty"`
	TimeoutSeconds int    `json:"timeout_seconds,omitempty"`
}

type AskPeerClaudeOutput struct {
	Body          string `json:"body,omitempty"`
	TurnCount     int    `json:"turnCount,omitempty"`
	ToolCallCount int    `json:"toolCallCount,omitempty"`
	StopReason    string `json:"stopReason,omitempty"`
	ElapsedMs     int64  `json:"elapsedMs,omitempty"`
	ErrorSummary  string `json:"errorSummary,omitempty"`
}

type Context struct {
	PeerName    string
	PeerVersion string
	DataDir     string
	LiveWindow  time.Duration
	Log         func(tool, status string, dur time.Duration)

	// Agent is non-nil only when --enable-agent was passed; nil
	// keeps Phase-1 behavior (the 8 read-only tools, no ask_peer_claude).
	Agent agent.Agent
}

type EffectiveBudgetOutput struct {
	MaxTokens      int   `json:"maxTokens"`
	MaxToolCalls   int   `json:"maxToolCalls"`
	TimeoutSeconds int64 `json:"timeoutSeconds"`
}

type EndPeerConversationInput struct {
	ConvID string `json:"convId"`
}

type EndPeerConversationOutput struct {
	Ended        bool   `json:"ended"`
	AlreadyEnded bool   `json:"alreadyEnded"`
	TotalTurns   int    `json:"totalTurns"`
	EndedReason  string `json:"endedReason"`
}

type GetCurrentSessionInput struct {
	Project string `json:"project,omitempty" jsonschema:"optional project filter (same semantics as list_sessions.project)"`
}

type GetCurrentSessionOutput struct {
	Ambiguous  bool                        `json:"ambiguous"`
	Session    *transcript.SessionSummary  `json:"session"`
	Candidates []transcript.SessionSummary `json:"candidates,omitempty"`
}

type GetPeerInfoInput struct{}

type GetPeerInfoOutput struct {
	Name               string `json:"name"`
	Version            string `json:"version"`
	SessionCount       int    `json:"sessionCount"`
	ActiveSessionCount int    `json:"activeSessionCount"`
}

type GetSessionSummaryInput struct {
	SessionID string `json:"sessionId"`
}

type GetSessionSummaryOutput struct {
	SessionID         string          `json:"sessionId"`
	FirstUserMessage  string          `json:"firstUserMessage,omitempty"`
	ToolCallCount     int             `json:"toolCallCount"`
	UniqueToolNames   []string        `json:"uniqueToolNames"`
	Subagents         []SubagentEntry `json:"subagents"`
	LastAssistantText string          `json:"lastAssistantText,omitempty"`
}

type ListPeerConversationsInput struct{}

type ListPeerConversationsOutput struct {
	Conversations []PeerConversationSummary `json:"conversations"`
}

type ListSessionsInput struct {
	Project string `json:"project,omitempty" jsonschema:"short project name (substring match on the decoded cwd) or full path"`
	Since   string `json:"since,omitempty" jsonschema:"ISO8601 — only return sessions with lastActivityAt >= since"`
	Limit   int    `json:"limit,omitempty" jsonschema:"max results (default 20)"`
}

type ListSessionsOutput struct {
	Sessions []transcript.SessionSummary `json:"sessions"`
}

type PeerConversationSummary struct {
	ConvID         string    `json:"convId"`
	StartedAt      time.Time `json:"startedAt"`
	LastActivityAt time.Time `json:"lastActivityAt"`
	TurnCount      int       `json:"turnCount"`
	Preview        string    `json:"preview"`
}

type ReadSessionInput struct {
	SessionID string `json:"sessionId" jsonschema:"session UUID from list_sessions or get_current_session"`
	FromTurn  int    `json:"fromTurn,omitempty" jsonschema:"inclusive start turn (default 0)"`
	ToTurn    int    `json:"toTurn,omitempty" jsonschema:"exclusive end turn (0 means end)"`
	Format    string `json:"format,omitempty" jsonschema:"'full' (default) returns markdown + JSON metadata; 'json' returns metadata only"`
}

type ReadSessionOutput struct {
	// Body holds the rendered markdown for format="full" (the default);
	// it is omitted for format="json".  See the AskPeerClaudeOutput
	// docstring for why the body lives in StructuredContent rather than
	// only in Content — Claude Code-class clients render the structured
	// channel and silently drop the Content channel when both exist.
	Body            string `json:"body,omitempty"`
	SessionID       string `json:"sessionId"`
	TotalTurns      int    `json:"totalTurns"`
	RenderedTurns   int    `json:"renderedTurns"`
	NextCursor      *int   `json:"nextCursor,omitempty"`
	PartialLastLine bool   `json:"partialLastLine"`
}

type ReadSubagentInput struct {
	SessionID string `json:"sessionId"`
	AgentUUID string `json:"agentUuid" jsonschema:"the tool_use.id of an Agent-tool call shown in read_session output"`
	FromTurn  int    `json:"fromTurn,omitempty"`
	ToTurn    int    `json:"toTurn,omitempty"`
}

type ReadSubagentOutput struct {
	SessionID       string `json:"sessionId"`
	AgentID         string `json:"agentId"`
	AgentType       string `json:"agentType,omitempty"`
	Description     string `json:"description,omitempty"`
	TotalTurns      int    `json:"totalTurns"`
	RenderedTurns   int    `json:"renderedTurns"`
	NextCursor      *int   `json:"nextCursor,omitempty"`
	PartialLastLine bool   `json:"partialLastLine"`
}

type ReadToolResultInput struct {
	SessionID string `json:"sessionId"`
	ToolUseID string `json:"toolUseId"`
	MaxBytes  int    `json:"maxBytes,omitempty" jsonschema:"default 65536"`
}

type ReadToolResultOutput struct{}

type SearchMatch struct {
	TurnIndex        int              `json:"turnIndex"`
	MatchedText      string           `json:"matchedText"`
	SurroundingTurns []map[string]any `json:"surroundingTurns"`
}

type SearchSessionInput struct {
	SessionID    string `json:"sessionId"`
	Query        string `json:"query" jsonschema:"literal substring (case-insensitive)"`
	ContextTurns int    `json:"contextTurns,omitempty" jsonschema:"context turns on each side (default 3)"`
}

type SearchSessionOutput struct {
	Query        string        `json:"query"`
	TotalMatches int           `json:"totalMatches"`
	Matches      []SearchMatch `json:"matches"`
}

type SendPeerMessageInput struct {
	ConvID         string `json:"convId" jsonschema:"the conversation handle returned by start_peer_conversation"`
	Prompt         string `json:"prompt" jsonschema:"the next user message in the conversation"`
	MaxTokens      int    `json:"max_tokens,omitempty"`
	MaxToolCalls   int    `json:"max_tool_calls,omitempty"`
	TimeoutSeconds int    `json:"timeout_seconds,omitempty"`
}

type SendPeerMessageOutput = AskPeerClaudeOutput

type StartPeerConversationInput struct {
	SystemPrompt   string `json:"system_prompt,omitempty" jsonschema:"optional system prompt seeded on the conversation"`
	Project        string `json:"project,omitempty" jsonschema:"working directory for the agent's tools (default: hearsay's cwd)"`
	MaxTokens      int    `json:"max_tokens,omitempty"`
	MaxToolCalls   int    `json:"max_tool_calls,omitempty"`
	TimeoutSeconds int    `json:"timeout_seconds,omitempty"`
}

type StartPeerConversationOutput struct {
	ConvID          string                `json:"convId"`
	StartedAt       time.Time             `json:"startedAt"`
	EffectiveBudget EffectiveBudgetOutput `json:"effectiveBudget"`
}

type SubagentEntry struct {
	AgentID     string `json:"agentId"`
	AgentType   string `json:"agentType,omitempty"`
	Description string `json:"description,omitempty"`
}