@@ -86,8 +86,6 @@ class Chunk(google.protobuf.message.Message):
8686 TYPE_FIELD_NUMBER : builtins .int
8787 REFERENCE_FIELD_NUMBER : builtins .int
8888 MARKDOWN_REFERENCE_FIELD_NUMBER : builtins .int
89- START_POS_FIELD_NUMBER : builtins .int
90- END_POS_FIELD_NUMBER : builtins .int
9189 uid : builtins .str
9290 """The chunk uid (internal UUID, also used as id)."""
9391 id : builtins .str
@@ -113,14 +111,6 @@ class Chunk(google.protobuf.message.Message):
113111 @property
114112 def markdown_reference (self ) -> global___Chunk .Reference :
115113 """Reference to the position of the chunk within the Markdown (source) file."""
116- start_pos : builtins .int
117- """start position of the chunk in the source file
118- Deprecated: use markdown_reference instead
119- """
120- end_pos : builtins .int
121- """end position of the chunk in the source file
122- Deprecated: use markdown_reference instead
123- """
124114 def __init__ (
125115 self ,
126116 * ,
@@ -134,11 +124,9 @@ class Chunk(google.protobuf.message.Message):
134124 type : global___Chunk .Type .ValueType = ...,
135125 reference : global___Chunk .Reference | None = ...,
136126 markdown_reference : global___Chunk .Reference | None = ...,
137- start_pos : builtins .int = ...,
138- end_pos : builtins .int = ...,
139127 ) -> None : ...
140128 def HasField (self , field_name : typing_extensions .Literal ["create_time" , b"create_time" , "markdown_reference" , b"markdown_reference" , "reference" , b"reference" ]) -> builtins .bool : ...
141- def ClearField (self , field_name : typing_extensions .Literal ["create_time" , b"create_time" , "end_pos" , b"end_pos" , " id" , b"id" , "markdown_reference" , b"markdown_reference" , "name" , b"name" , "original_file_id" , b"original_file_id" , "reference" , b"reference" , "retrievable" , b"retrievable" , "start_pos" , b"start_pos " , "tokens" , b"tokens" , "type" , b"type" , "uid" , b"uid" ]) -> None : ...
129+ def ClearField (self , field_name : typing_extensions .Literal ["create_time" , b"create_time" , "id" , b"id" , "markdown_reference" , b"markdown_reference" , "name" , b"name" , "original_file_id" , b"original_file_id" , "reference" , b"reference" , "retrievable" , b"retrievable" , "tokens" , b"tokens" , "type" , b"type" , "uid" , b"uid" ]) -> None : ...
142130
143131global___Chunk = Chunk
144132
@@ -231,6 +219,7 @@ class GetChunkRequest(google.protobuf.message.Message):
231219 KNOWLEDGE_BASE_ID_FIELD_NUMBER : builtins .int
232220 FILE_ID_FIELD_NUMBER : builtins .int
233221 CHUNK_ID_FIELD_NUMBER : builtins .int
222+ CHUNK_TYPE_FIELD_NUMBER : builtins .int
234223 namespace_id : builtins .str
235224 """Namespace ID."""
236225 knowledge_base_id : builtins .str
@@ -239,15 +228,22 @@ class GetChunkRequest(google.protobuf.message.Message):
239228 """File ID."""
240229 chunk_id : builtins .str
241230 """Chunk ID."""
231+ chunk_type : global___Chunk .Type .ValueType
232+ """Optional chunk type filter. If specified, returns a chunk of this type
233+ from the same file. If not specified, returns the chunk identified by chunk_id.
234+ """
242235 def __init__ (
243236 self ,
244237 * ,
245238 namespace_id : builtins .str = ...,
246239 knowledge_base_id : builtins .str = ...,
247240 file_id : builtins .str = ...,
248241 chunk_id : builtins .str = ...,
242+ chunk_type : global___Chunk .Type .ValueType | None = ...,
249243 ) -> None : ...
250- def ClearField (self , field_name : typing_extensions .Literal ["chunk_id" , b"chunk_id" , "file_id" , b"file_id" , "knowledge_base_id" , b"knowledge_base_id" , "namespace_id" , b"namespace_id" ]) -> None : ...
244+ def HasField (self , field_name : typing_extensions .Literal ["_chunk_type" , b"_chunk_type" , "chunk_type" , b"chunk_type" ]) -> builtins .bool : ...
245+ def ClearField (self , field_name : typing_extensions .Literal ["_chunk_type" , b"_chunk_type" , "chunk_id" , b"chunk_id" , "chunk_type" , b"chunk_type" , "file_id" , b"file_id" , "knowledge_base_id" , b"knowledge_base_id" , "namespace_id" , b"namespace_id" ]) -> None : ...
246+ def WhichOneof (self , oneof_group : typing_extensions .Literal ["_chunk_type" , b"_chunk_type" ]) -> typing_extensions .Literal ["chunk_type" ] | None : ...
251247
252248global___GetChunkRequest = GetChunkRequest
253249
@@ -260,7 +256,10 @@ class GetChunkResponse(google.protobuf.message.Message):
260256 CHUNK_FIELD_NUMBER : builtins .int
261257 @property
262258 def chunk (self ) -> global___Chunk :
263- """The chunk resource."""
259+ """The chunk metadata, including markdown_reference for extracting content.
260+ Clients should use GetFile to fetch the full content/summary markdown,
261+ then use markdown_reference coordinates to extract the specific chunk text.
262+ """
264263 def __init__ (
265264 self ,
266265 * ,
0 commit comments