proto

type DocReaderClient interface {
	Read(ctx context.Context, in *ReadRequest, opts ...grpc.CallOption) (*ReadResponse, error)
	// ReadStream is the streaming counterpart of Read. It first emits one
	// ReadStreamResponse carrying the parse metadata (markdown / metadata /
	// error), then emits one message per image. This keeps every gRPC message
	// small so large scanned PDFs (hundreds of page images, far exceeding the
	// unary message-size cap) can be returned without RESOURCE_EXHAUSTED and
	// with bounded memory on both ends.
	ReadStream(ctx context.Context, in *ReadRequest, opts ...grpc.CallOption) (grpc.ServerStreamingClient[ReadStreamResponse], error)
	ListEngines(ctx context.Context, in *ListEnginesRequest, opts ...grpc.CallOption) (*ListEnginesResponse, error)
	// PreprocessImage straightens and crops a photographed page so that OCR sees
	// an upright, content-tight image. The caller sends the raw photograph and
	// receives either the corrected page or a verdict that this input is not a
	// page worth correcting — never an error for "not correctable", because the
	// caller's fallback (use the original bytes) is a normal outcome rather than
	// a failure to report.
	PreprocessImage(ctx context.Context, in *PreprocessImageRequest, opts ...grpc.CallOption) (*PreprocessImageResponse, error)
}

type DocReaderServer interface {
	Read(context.Context, *ReadRequest) (*ReadResponse, error)
	// ReadStream is the streaming counterpart of Read. It first emits one
	// ReadStreamResponse carrying the parse metadata (markdown / metadata /
	// error), then emits one message per image. This keeps every gRPC message
	// small so large scanned PDFs (hundreds of page images, far exceeding the
	// unary message-size cap) can be returned without RESOURCE_EXHAUSTED and
	// with bounded memory on both ends.
	ReadStream(*ReadRequest, grpc.ServerStreamingServer[ReadStreamResponse]) error
	ListEngines(context.Context, *ListEnginesRequest) (*ListEnginesResponse, error)
	// PreprocessImage straightens and crops a photographed page so that OCR sees
	// an upright, content-tight image. The caller sends the raw photograph and
	// receives either the corrected page or a verdict that this input is not a
	// page worth correcting — never an error for "not correctable", because the
	// caller's fallback (use the original bytes) is a normal outcome rather than
	// a failure to report.
	PreprocessImage(context.Context, *PreprocessImageRequest) (*PreprocessImageResponse, error)
	// contains filtered or unexported methods
}

type DocReader_ReadStreamClient = grpc.ServerStreamingClient[ReadStreamResponse]

type DocReader_ReadStreamServer = grpc.ServerStreamingServer[ReadStreamResponse]

type ImageRef struct {
	Filename    string `protobuf:"bytes,1,opt,name=filename,proto3" json:"filename,omitempty"`
	OriginalRef string `protobuf:"bytes,2,opt,name=original_ref,json=originalRef,proto3" json:"original_ref,omitempty"`
	MimeType    string `protobuf:"bytes,3,opt,name=mime_type,json=mimeType,proto3" json:"mime_type,omitempty"`
	StorageKey  string `protobuf:"bytes,4,opt,name=storage_key,json=storageKey,proto3" json:"storage_key,omitempty"` // download URL from shared storage
	ImageData   []byte `protobuf:"bytes,5,opt,name=image_data,json=imageData,proto3" json:"image_data,omitempty"`    // inline bytes fallback
	// contains filtered or unexported fields
}

type ListEnginesRequest struct {
	ConfigOverrides map[string]string `` /* 180-byte string literal not displayed */
	// contains filtered or unexported fields
}

type ListEnginesResponse struct {
	Engines []*ParserEngineInfo `protobuf:"bytes,1,rep,name=engines,proto3" json:"engines,omitempty"`
	// contains filtered or unexported fields
}

type ParserEngineInfo struct {
	Name              string   `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	Description       string   `protobuf:"bytes,2,opt,name=description,proto3" json:"description,omitempty"`
	FileTypes         []string `protobuf:"bytes,3,rep,name=file_types,json=fileTypes,proto3" json:"file_types,omitempty"`
	Available         bool     `protobuf:"varint,4,opt,name=available,proto3" json:"available,omitempty"`
	UnavailableReason string   `protobuf:"bytes,5,opt,name=unavailable_reason,json=unavailableReason,proto3" json:"unavailable_reason,omitempty"`
	// contains filtered or unexported fields
}

type PreprocessImageRequest struct {
	Image []byte `protobuf:"bytes,1,opt,name=image,proto3" json:"image,omitempty"`
	// contains filtered or unexported fields
}

type PreprocessImageResponse struct {

	// image is the corrected page, JPEG-encoded. Empty when fallback_needed.
	Image []byte `protobuf:"bytes,1,opt,name=image,proto3" json:"image,omitempty"`
	// fallback_needed tells the caller to keep its original bytes: the input is
	// not a correctable page, or correcting it would not be an improvement.
	FallbackNeeded bool `protobuf:"varint,2,opt,name=fallback_needed,json=fallbackNeeded,proto3" json:"fallback_needed,omitempty"`
	// Diagnostics for the run's trace and for tuning the thresholds.
	Theta    float32 `protobuf:"fixed32,3,opt,name=theta,proto3" json:"theta,omitempty"`                // dominant text-line angle (degrees)
	Residual float32 `protobuf:"fixed32,4,opt,name=residual,proto3" json:"residual,omitempty"`          // residual skew after alignment; > 2 means low quality
	Flip     bool    `protobuf:"varint,5,opt,name=flip,proto3" json:"flip,omitempty"`                   // whether a 180-degree flip was applied
	NBoxes   int32   `protobuf:"varint,6,opt,name=n_boxes,json=nBoxes,proto3" json:"n_boxes,omitempty"` // text boxes detected
	NKept    int32   `protobuf:"varint,7,opt,name=n_kept,json=nKept,proto3" json:"n_kept,omitempty"`    // text boxes kept after filtering
	// status is "ok" | "no_text" | "low_quality", for logs and metrics.
	Status string `protobuf:"bytes,8,opt,name=status,proto3" json:"status,omitempty"`
	// contains filtered or unexported fields
}

type ReadConfig struct {
	ParserEngine          string            `protobuf:"bytes,1,opt,name=parser_engine,json=parserEngine,proto3" json:"parser_engine,omitempty"`
	ParserEngineOverrides map[string]string `` /* 200-byte string literal not displayed */
	// contains filtered or unexported fields
}

type ReadRequest struct {
	FileContent []byte      `protobuf:"bytes,1,opt,name=file_content,json=fileContent,proto3" json:"file_content,omitempty"`
	FileName    string      `protobuf:"bytes,2,opt,name=file_name,json=fileName,proto3" json:"file_name,omitempty"`
	FileType    string      `protobuf:"bytes,3,opt,name=file_type,json=fileType,proto3" json:"file_type,omitempty"`
	Url         string      `protobuf:"bytes,4,opt,name=url,proto3" json:"url,omitempty"`
	Title       string      `protobuf:"bytes,5,opt,name=title,proto3" json:"title,omitempty"`
	Config      *ReadConfig `protobuf:"bytes,6,opt,name=config,proto3" json:"config,omitempty"`
	RequestId   string      `protobuf:"bytes,7,opt,name=request_id,json=requestId,proto3" json:"request_id,omitempty"`
	// contains filtered or unexported fields
}

type ReadResponse struct {
	MarkdownContent string            `protobuf:"bytes,1,opt,name=markdown_content,json=markdownContent,proto3" json:"markdown_content,omitempty"`
	ImageRefs       []*ImageRef       `protobuf:"bytes,2,rep,name=image_refs,json=imageRefs,proto3" json:"image_refs,omitempty"`
	ImageDirPath    string            `protobuf:"bytes,3,opt,name=image_dir_path,json=imageDirPath,proto3" json:"image_dir_path,omitempty"`
	Metadata        map[string]string `` /* 143-byte string literal not displayed */
	Error           string            `protobuf:"bytes,5,opt,name=error,proto3" json:"error,omitempty"`
	SourceBlocks    []*SourceBlock    `protobuf:"bytes,6,rep,name=source_blocks,json=sourceBlocks,proto3" json:"source_blocks,omitempty"`
	// contains filtered or unexported fields
}

type ReadStreamMeta struct {
	MarkdownContent string            `protobuf:"bytes,1,opt,name=markdown_content,json=markdownContent,proto3" json:"markdown_content,omitempty"`
	ImageDirPath    string            `protobuf:"bytes,2,opt,name=image_dir_path,json=imageDirPath,proto3" json:"image_dir_path,omitempty"`
	Metadata        map[string]string `` /* 143-byte string literal not displayed */
	Error           string            `protobuf:"bytes,4,opt,name=error,proto3" json:"error,omitempty"`
	ImageCount      uint32            `protobuf:"varint,5,opt,name=image_count,json=imageCount,proto3" json:"image_count,omitempty"` // best-effort total image count (0 if unknown)
	SourceBlocks    []*SourceBlock    `protobuf:"bytes,6,rep,name=source_blocks,json=sourceBlocks,proto3" json:"source_blocks,omitempty"`
	// contains filtered or unexported fields
}

type ReadStreamResponse struct {

	// Types that are valid to be assigned to Payload:
	//
	//	*ReadStreamResponse_Meta
	//	*ReadStreamResponse_Image
	Payload isReadStreamResponse_Payload `protobuf_oneof:"payload"`
	// contains filtered or unexported fields
}

type ReadStreamResponse_Image struct {
	Image *ImageRef `protobuf:"bytes,2,opt,name=image,proto3,oneof"`
}

type ReadStreamResponse_Meta struct {
	Meta *ReadStreamMeta `protobuf:"bytes,1,opt,name=meta,proto3,oneof"`
}

type SourceBlock struct {

	// Unicode code point offsets into markdown_content, end exclusive.
	Start uint32 `protobuf:"varint,1,opt,name=start,proto3" json:"start,omitempty"`
	End   uint32 `protobuf:"varint,2,opt,name=end,proto3" json:"end,omitempty"`
	// JSON-encoded locator: {"type":"pdf","page":3,"bbox":[x0,y0,x1,y1]}
	// with ordinals 1-based and bbox as fractions of the page, origin top-left.
	LocatorJson string `protobuf:"bytes,3,opt,name=locator_json,json=locatorJson,proto3" json:"locator_json,omitempty"`
	// contains filtered or unexported fields
}

type UnimplementedDocReaderServer struct{}

type UnsafeDocReaderServer interface {
	// contains filtered or unexported methods
}