toolregistry

type OutputDeltaPublisher interface {
	PublishToolOutputDelta(ctx context.Context, stream string, delta string) error
}

type ServerDataItem struct {
	Kind     string          `json:"kind"`
	Audience string          `json:"audience"`
	Data     json.RawMessage `json:"data"`
}

type ToolCallMessage struct {
	// ToolUseID is the transport identity for this request stream message. For
	// registry-routed tool calls it is stable across retries and equals the
	// logical ToolCallID when the caller supplied one.
	Type      ToolCallMessageType `json:"type"`
	ToolUseID string              `json:"tool_use_id,omitempty"`
	PingID    string              `json:"ping_id,omitempty"`
	Tool      tools.Ident         `json:"tool,omitempty"`
	Payload   json.RawMessage     `json:"payload,omitempty"`
	Meta      *ToolCallMeta       `json:"meta,omitempty"`

	// TraceParent and TraceState carry W3C Trace Context headers for distributed
	// tracing across Pulse boundaries. These fields are optional and may be empty.
	// When set, consumers should extract them into their context before starting
	// spans for handling the tool call.
	TraceParent string `json:"traceparent,omitempty"`
	TraceState  string `json:"tracestate,omitempty"`

	// Baggage carries the W3C baggage header when the global propagator includes
	// baggage propagation (common for OTEL setups). Optional.
	Baggage string `json:"baggage,omitempty"`
}

type ToolCallMessageType string

type ToolCallMeta struct {
	RunID     string `json:"run_id"`
	SessionID string `json:"session_id"`
	TurnID    string `json:"turn_id,omitempty"`
	// ToolCallID is the logical execution identity assigned by the runtime. When
	// present, registry retries must reuse it as the transport ToolUseID instead
	// of minting a fresh per-attempt identifier.
	ToolCallID       string `json:"tool_call_id,omitempty"`
	ParentToolCallID string `json:"parent_tool_call_id,omitempty"`
}

type ToolError struct {
	Code    string `json:"code"`
	Message string `json:"message"`
	// Issues optionally carries structured field-level validation issues.
	// When present, consumers can build a RetryHint without parsing Message.
	Issues []*tools.FieldIssue `json:"issues,omitempty"`
}

type ToolOutputDeltaMessage struct {
	ToolUseID string `json:"tool_use_id"`
	// Stream identifies which logical output channel produced the delta
	// (for example, "stdout", "stderr", "log", "progress").
	Stream string `json:"stream"`
	Delta  string `json:"delta"`
}

type ToolResultMessage struct {
	ToolUseID string          `json:"tool_use_id"`
	Result    json.RawMessage `json:"result_json,omitempty"`
	// Bounds carries canonical bounded-result metadata projected out-of-band
	// from the semantic result payload when the tool declares a bounded-result
	// contract.
	Bounds *agent.Bounds `json:"bounds,omitempty"`
	// ServerData carries server-only metadata about the tool execution that must
	// not be serialized into model provider requests.
	//
	// This is the canonical home for any non-model payloads emitted alongside a
	// tool result. Consumers may project it into different observer views (for
	// example, UI render cards vs persistence-only evidence), but the wire
	// protocol keeps a single server-side envelope.
	ServerData []*ServerDataItem `json:"server_data,omitempty"`
	Error      *ToolError        `json:"error,omitempty"`
}