transport

const (
	// EventKindRequestStart marks the beginning of a request lifecycle.
	EventKindRequestStart EventKind = iota + 1
	// EventKindRequestFinish marks a successful terminal request event.
	EventKindRequestFinish
	// EventKindRequestFailure marks a failed terminal request event.
	EventKindRequestFailure
	// EventKindStreamOpen marks the opening of a streaming response.
	EventKindStreamOpen
	// EventKindStreamClose marks the closing of a streaming response.
	EventKindStreamClose
	// EventKindStreamFailure marks a failed stream write or flush.
	EventKindStreamFailure
)

const (
	// ReasonOK marks a terminal event with no error classification.
	ReasonOK Reason = "ok"
	// ReasonRequestDecodeFailed marks failure to decode the HTTP request body
	// or query parameters into the generated request type.
	ReasonRequestDecodeFailed Reason = "request_decode_failed"
	// ReasonInvalidJSONRPCEnvelope marks failure to parse the JSON-RPC
	// envelope.
	ReasonInvalidJSONRPCEnvelope Reason = "invalid_jsonrpc_envelope"
	// ReasonInvalidJSONRPCBatch marks rejection of a malformed JSON-RPC batch
	// request.
	ReasonInvalidJSONRPCBatch Reason = "invalid_jsonrpc_batch"
	// ReasonInvalidJSONRPCMethod marks rejection of a JSON-RPC envelope whose
	// method field is missing or malformed.
	ReasonInvalidJSONRPCMethod Reason = "invalid_jsonrpc_method"
	// ReasonInvalidJSONRPCParams marks failure to decode JSON-RPC params into
	// the generated parameter type.
	ReasonInvalidJSONRPCParams Reason = "invalid_jsonrpc_params"
	// ReasonUnsupportedMethod marks rejection of a JSON-RPC method the
	// generated handler does not implement.
	ReasonUnsupportedMethod Reason = "unsupported_method"
	// ReasonMissingCredentials marks rejection because required credentials
	// were not presented.
	ReasonMissingCredentials Reason = "missing_credentials"
	// ReasonInvalidCredentials marks rejection because credentials were
	// presented but could not be validated.
	ReasonInvalidCredentials Reason = "invalid_credentials"
	// ReasonPermissionRejected marks rejection because authorization checks
	// denied the principal.
	ReasonPermissionRejected Reason = "permission_rejected"
	// ReasonPrincipalMismatch marks rejection because the principal did not
	// match the session owner.
	ReasonPrincipalMismatch Reason = "principal_mismatch"
	// ReasonHandlerError marks a handler returning a non-nil error.
	ReasonHandlerError Reason = "handler_error"
	// ReasonPanic marks a recovered panic in the generated handler.
	ReasonPanic Reason = "panic"
	// ReasonResponseWriteFailed marks a failure while writing the HTTP
	// response body.
	ReasonResponseWriteFailed Reason = "response_write_failed"
	// ReasonStreamWriteFailed marks a failed write to a streaming response.
	ReasonStreamWriteFailed Reason = "stream_write_failed"
	// ReasonStreamFlushFailed marks a failed flush of a streaming response.
	ReasonStreamFlushFailed Reason = "stream_flush_failed"
	// ReasonMCPSessionMissing marks an MCP events-stream request that omitted
	// the Mcp-Session-Id header.
	ReasonMCPSessionMissing Reason = "mcp_session_missing"
	// ReasonMCPSessionNotFound marks an MCP events-stream request whose
	// session id is unknown to the server.
	ReasonMCPSessionNotFound Reason = "mcp_session_not_found"
	// ReasonMCPSessionPrincipalMismatch marks an MCP events-stream request
	// whose authenticated principal differs from the session owner.
	ReasonMCPSessionPrincipalMismatch Reason = "mcp_session_principal_mismatch"
	// ReasonMCPEventsStreamWriteFailed marks a failure writing an MCP
	// notification frame to the events-stream response.
	ReasonMCPEventsStreamWriteFailed Reason = "mcp_events_stream_write_failed"
)

const (
	// TransportHTTP identifies generic HTTP-generated transport events.
	TransportHTTP TransportKind = "http"
	// TransportJSONRPC identifies JSON-RPC-generated transport events.
	TransportJSONRPC TransportKind = "jsonrpc"
	// TransportMCP identifies Loom-MCP-generated transport events.
	TransportMCP TransportKind = "mcp"
)