acp

type Adapter interface {
	// Parse converts a raw record into a SessionUpdate.
	//
	// Returns a non-nil error if the record is malformed, missing required
	// fields, or cannot be decoded. The error must identify:
	//   (1) what field or byte caused the failure,
	//   (2) why decoding failed (unexpected type, missing key, etc.),
	//   (3) how to fix it (expected format or value).
	Parse(record []byte) (SessionUpdate, error)

	// Format returns the canonical name of the format this adapter handles.
	// Example values: "claude-jsonl", "opencode-json".
	Format() string
}

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

type ContentBlock struct {
	// Type identifies the block type (e.g. "text", "tool_use", "tool_result", "thinking").
	Type string `json:"type"`
	// Text holds the text payload for "text" and "thinking" blocks, matching the
	// ACP spec wire key "text".
	Text string `json:"text,omitempty"`
	// ID is the tool call identifier for "tool_use" and "tool_result" blocks.
	ID string `json:"id,omitempty"`
	// Name is the tool name for "tool_use" blocks.
	Name string `json:"name,omitempty"`
	// Input holds tool input as raw JSON for "tool_use" blocks.
	Input json.RawMessage `json:"input,omitempty"`
	// RawContent holds tool result content for "tool_result" blocks in wire format.
	RawContent json.RawMessage `json:"rawContent,omitempty"`
}

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

type SessionHandler interface {
	// HandleUpdate processes a single session update.
	// Called for every message received from the agent, in order.
	// Returning an error causes the client to stop processing.
	HandleUpdate(ctx context.Context, update SessionUpdate) error

	// HandleSessionEnd is called when a session ends (stop_reason present).
	// sessionId is the session that ended. reason is the stop reason.
	HandleSessionEnd(ctx context.Context, sessionId string, reason StopReason) error
}

type SessionStats struct {
	SessionId   string
	UpdateCount int
	StartTime   time.Time
	LastUpdate  time.Time
	Ended       bool
	EndReason   StopReason // zero value if session is still active
	EndTime     time.Time  // zero value if session is still active
}

type SessionUpdate struct {
	// SessionId uniquely identifies the agent session.
	SessionId string `json:"sessionId"`
	// Role is the message author: "user", "assistant", or "tool".
	Role string `json:"role"`
	// Content holds the ordered content blocks for this update.
	Content []ContentBlock `json:"content,omitempty"`
	// ToolCalls holds extracted tool invocations from this update.
	// Populated by Adapter.Parse; the live ACP client derives these from Content.
	ToolCalls []ToolCall `json:"toolCalls,omitempty"`
	// StopReason is present when the session ends; empty during normal updates.
	StopReason StopReason `json:"stopReason,omitempty"`
	// Usage holds token usage for this update (may be nil for intermediate updates).
	Usage *UsageStats `json:"usage,omitempty"`
	// TokensIn is the number of input tokens consumed (convenience accessor).
	// Adapters should populate this directly; live client reads from Usage.
	TokensIn int `json:"tokensIn,omitempty"`
	// TokensOut is the number of output tokens produced (convenience accessor).
	TokensOut int `json:"tokensOut,omitempty"`
	// Timestamp is the wall-clock time the update was emitted, in milliseconds since epoch.
	Timestamp int64 `json:"timestamp,omitempty"`
	// IsError signals that this update represents an error turn.
	IsError bool `json:"isError,omitempty"`
	// EntryId is the provider-native message ID.
	EntryId string `json:"entryId,omitempty"`
	// ParentEntryId links tool_result turns back to their tool_use origin.
	ParentEntryId string `json:"parentEntryId,omitempty"`
}

type SharedIndexer struct{}

type StopReason string

type ToolCall struct {
	// ToolCallId is the correlation ID linking tool_use to tool_result.
	ToolCallId string `json:"toolCallId"`
	// ToolKind classifies the tool category (function, bash, file, etc.).
	ToolKind ToolKind `json:"toolKind"`
	// ToolName is the name of the tool or function invoked.
	ToolName string `json:"toolName"`
	// ToolInput is the JSON-encoded input arguments supplied to the tool.
	ToolInput string `json:"toolInput,omitempty"`
	// ToolOutput is the JSON-encoded result returned by the tool (if completed).
	ToolOutput string `json:"toolOutput,omitempty"`
}

type ToolKind string

type UsageStats struct {
	InputTokens  int `json:"input_tokens"`
	OutputTokens int `json:"output_tokens"`
}