feat: default include_declared to true in ListTables (#332)

## Summary

- Default `include_declared` to `true` in `ListTablesRequest` schema and
REST query parameter for backwards compatibility
- Add `include_declared` query parameter to both `ListTables` and
`ListAllTables` REST endpoints

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: jackye1995

docs/src/client/operations/models/ListTablesRequest.md

@@ -12,7 +12,7 @@
 |**id** | **List<String>** |  |  [optional] |
 |**pageToken** | **String** | An opaque token that allows pagination for list operations (e.g. ListNamespaces).  For an initial request of a list operation, if the implementation cannot return all items in one response, or if there are more items than the page limit specified in the request, the implementation must return a page token in the response, indicating there are more results available.  After the initial request, the value of the page token from each response must be used as the page token value for the next request.  Caller must interpret either `null`, missing value or empty string value of the page token from the implementation's response as the end of the listing results.  |  [optional] |
 |**limit** | **Integer** | An inclusive upper bound of the number of results that a caller will receive.  |  [optional] |
-|**includeDeclared** | **Boolean** | When true, includes tables that have been declared in the namespace but not yet created on storage, in addition to tables that have been created. When false or not set, only tables with storage components are returned.  |  [optional] |
+|**includeDeclared** | **Boolean** | When true (default), includes tables that have been declared in the namespace but not yet created on storage, in addition to tables that have been created. When false, only tables with storage components are returned.  |  [optional] |
 
 
 

docs/src/rest.yaml

@@ -275,6 +275,7 @@ paths:
       - $ref: "#/components/parameters/delimiter"
       - $ref: "#/components/parameters/page_token"
       - $ref: "#/components/parameters/limit"
+      - $ref: "#/components/parameters/include_declared"
     get:
       tags:
         - Namespace
@@ -291,6 +292,7 @@ paths:
         - `id`: pass through path parameter of the same name
         - `page_token`: pass through query parameter of the same name
         - `limit`: pass through query parameter of the same name
+        - `include_declared`: pass through query parameter of the same name
       responses:
         200:
           $ref: "#/components/responses/ListTablesResponse"
@@ -326,10 +328,12 @@ paths:
         - `page_token`: pass through query parameter of the same name
         - `limit`: pass through query parameter of the same name
         - `delimiter`: pass through query parameter of the same name
+        - `include_declared`: pass through query parameter of the same name
       parameters:
         - $ref: "#/components/parameters/delimiter"
         - $ref: "#/components/parameters/page_token"
         - $ref: "#/components/parameters/limit"
+        - $ref: "#/components/parameters/include_declared"
       responses:
         200:
           $ref: "#/components/responses/ListTablesResponse"
@@ -2042,6 +2046,18 @@ components:
       schema:
         type: boolean
         default: false
+    include_declared:
+      name: include_declared
+      description: |
+        When true (default), includes tables that have been declared in the namespace
+        but not yet created on storage, in addition to tables that have
+        been created. When false, only tables with storage
+        components are returned.
+      in: query
+      required: false
+      schema:
+        type: boolean
+        default: true
     load_detailed_metadata:
       name: load_detailed_metadata
       description: |
@@ -2387,10 +2403,11 @@ components:
           $ref: "#/components/schemas/PageLimit"
         include_declared:
           type: boolean
+          default: true
           description: |
-            When true, includes tables that have been declared in the namespace
+            When true (default), includes tables that have been declared in the namespace
             but not yet created on storage, in addition to tables that have
-            been created. When false or not set, only tables with storage
+            been created. When false, only tables with storage
             components are returned.
 
     ListTablesResponse:

java/lance-namespace-apache-client/api/openapi.yaml

@@ -288,12 +288,14 @@ paths:
         - `id`: pass through path parameter of the same name
         - `page_token`: pass through query parameter of the same name
         - `limit`: pass through query parameter of the same name
+        - `include_declared`: pass through query parameter of the same name
       operationId: ListTables
       parameters:
       - $ref: '#/components/parameters/id'
       - $ref: '#/components/parameters/delimiter'
       - $ref: '#/components/parameters/page_token'
       - $ref: '#/components/parameters/limit'
+      - $ref: '#/components/parameters/include_declared'
       responses:
         "200":
           $ref: '#/components/responses/ListTablesResponse'
@@ -323,6 +325,7 @@ paths:
     - $ref: '#/components/parameters/delimiter'
     - $ref: '#/components/parameters/page_token'
     - $ref: '#/components/parameters/limit'
+    - $ref: '#/components/parameters/include_declared'
   /v1/table:
     get:
       description: |
@@ -334,11 +337,13 @@ paths:
         - `page_token`: pass through query parameter of the same name
         - `limit`: pass through query parameter of the same name
         - `delimiter`: pass through query parameter of the same name
+        - `include_declared`: pass through query parameter of the same name
       operationId: ListAllTables
       parameters:
       - $ref: '#/components/parameters/delimiter'
       - $ref: '#/components/parameters/page_token'
       - $ref: '#/components/parameters/limit'
+      - $ref: '#/components/parameters/include_declared'
       responses:
         "200":
           $ref: '#/components/responses/ListTablesResponse'
@@ -2440,6 +2445,20 @@ components:
         default: false
         type: boolean
       style: form
+    include_declared:
+      description: |
+        When true (default), includes tables that have been declared in the namespace
+        but not yet created on storage, in addition to tables that have
+        been created. When false, only tables with storage
+        components are returned.
+      explode: true
+      in: query
+      name: include_declared
+      required: false
+      schema:
+        default: true
+        type: boolean
+      style: form
     load_detailed_metadata:
       description: |
         Whether to load detailed metadata that requires opening the dataset.
@@ -3331,10 +3350,11 @@ components:
           type: integer
           nullable: true
         include_declared:
+          default: true
           description: |
-            When true, includes tables that have been declared in the namespace
+            When true (default), includes tables that have been declared in the namespace
             but not yet created on storage, in addition to tables that have
-            been created. When false or not set, only tables with storage
+            been created. When false, only tables with storage
             components are returned.
           type: boolean
     ListTablesResponse:

java/lance-namespace-apache-client/docs/ListTablesRequest.md

@@ -12,7 +12,7 @@
 |**id** | **List<String>** |  |  [optional] |
 |**pageToken** | **String** | An opaque token that allows pagination for list operations (e.g. ListNamespaces).  For an initial request of a list operation, if the implementation cannot return all items in one response, or if there are more items than the page limit specified in the request, the implementation must return a page token in the response, indicating there are more results available.  After the initial request, the value of the page token from each response must be used as the page token value for the next request.  Caller must interpret either `null`, missing value or empty string value of the page token from the implementation's response as the end of the listing results.  |  [optional] |
 |**limit** | **Integer** | An inclusive upper bound of the number of results that a caller will receive.  |  [optional] |
-|**includeDeclared** | **Boolean** | When true, includes tables that have been declared in the namespace but not yet created on storage, in addition to tables that have been created. When false or not set, only tables with storage components are returned.  |  [optional] |
+|**includeDeclared** | **Boolean** | When true (default), includes tables that have been declared in the namespace but not yet created on storage, in addition to tables that have been created. When false, only tables with storage components are returned.  |  [optional] |
 
 
 

java/lance-namespace-apache-client/docs/MetadataApi.md

@@ -2611,11 +2611,11 @@ public class Example {
 
 ## listTables
 
-> ListTablesResponse listTables(id, delimiter, pageToken, limit)
+> ListTablesResponse listTables(id, delimiter, pageToken, limit, includeDeclared)
 
 List tables in a namespace
 
-List all child table names of the parent namespace `id`.  REST NAMESPACE ONLY REST namespace uses GET to perform this operation without a request body. It passes in the `ListTablesRequest` information in the following way: - `id`: pass through path parameter of the same name - `page_token`: pass through query parameter of the same name - `limit`: pass through query parameter of the same name 
+List all child table names of the parent namespace `id`.  REST NAMESPACE ONLY REST namespace uses GET to perform this operation without a request body. It passes in the `ListTablesRequest` information in the following way: - `id`: pass through path parameter of the same name - `page_token`: pass through query parameter of the same name - `limit`: pass through query parameter of the same name - `include_declared`: pass through query parameter of the same name 
 
 ### Example
 
@@ -2652,8 +2652,9 @@ public class Example {
         String delimiter = "delimiter_example"; // String | An optional delimiter of the `string identifier`, following the Lance Namespace spec. When not specified, the `$` delimiter must be used. 
         String pageToken = "pageToken_example"; // String | Pagination token from a previous request
         Integer limit = 56; // Integer | Maximum number of items to return
+        Boolean includeDeclared = true; // Boolean | When true (default), includes tables that have been declared in the namespace but not yet created on storage, in addition to tables that have been created. When false, only tables with storage components are returned. 
         try {
-            ListTablesResponse result = apiInstance.listTables(id, delimiter, pageToken, limit);
+            ListTablesResponse result = apiInstance.listTables(id, delimiter, pageToken, limit, includeDeclared);
             System.out.println(result);
         } catch (ApiException e) {
             System.err.println("Exception when calling MetadataApi#listTables");
@@ -2675,6 +2676,7 @@ public class Example {
 | **delimiter** | **String**| An optional delimiter of the `string identifier`, following the Lance Namespace spec. When not specified, the `$` delimiter must be used.  | [optional] |
 | **pageToken** | **String**| Pagination token from a previous request | [optional] |
 | **limit** | **Integer**| Maximum number of items to return | [optional] |
+| **includeDeclared** | **Boolean**| When true (default), includes tables that have been declared in the namespace but not yet created on storage, in addition to tables that have been created. When false, only tables with storage components are returned.  | [optional] [default to true] |
 
 ### Return type
 

java/lance-namespace-apache-client/docs/NamespaceApi.md

@@ -385,11 +385,11 @@ public class Example {
 
 ## listTables
 
-> ListTablesResponse listTables(id, delimiter, pageToken, limit)
+> ListTablesResponse listTables(id, delimiter, pageToken, limit, includeDeclared)
 
 List tables in a namespace
 
-List all child table names of the parent namespace `id`.  REST NAMESPACE ONLY REST namespace uses GET to perform this operation without a request body. It passes in the `ListTablesRequest` information in the following way: - `id`: pass through path parameter of the same name - `page_token`: pass through query parameter of the same name - `limit`: pass through query parameter of the same name 
+List all child table names of the parent namespace `id`.  REST NAMESPACE ONLY REST namespace uses GET to perform this operation without a request body. It passes in the `ListTablesRequest` information in the following way: - `id`: pass through path parameter of the same name - `page_token`: pass through query parameter of the same name - `limit`: pass through query parameter of the same name - `include_declared`: pass through query parameter of the same name 
 
 ### Example
 
@@ -426,8 +426,9 @@ public class Example {
         String delimiter = "delimiter_example"; // String | An optional delimiter of the `string identifier`, following the Lance Namespace spec. When not specified, the `$` delimiter must be used. 
         String pageToken = "pageToken_example"; // String | Pagination token from a previous request
         Integer limit = 56; // Integer | Maximum number of items to return
+        Boolean includeDeclared = true; // Boolean | When true (default), includes tables that have been declared in the namespace but not yet created on storage, in addition to tables that have been created. When false, only tables with storage components are returned. 
         try {
-            ListTablesResponse result = apiInstance.listTables(id, delimiter, pageToken, limit);
+            ListTablesResponse result = apiInstance.listTables(id, delimiter, pageToken, limit, includeDeclared);
             System.out.println(result);
         } catch (ApiException e) {
             System.err.println("Exception when calling NamespaceApi#listTables");
@@ -449,6 +450,7 @@ public class Example {
 | **delimiter** | **String**| An optional delimiter of the `string identifier`, following the Lance Namespace spec. When not specified, the `$` delimiter must be used.  | [optional] |
 | **pageToken** | **String**| Pagination token from a previous request | [optional] |
 | **limit** | **Integer**| Maximum number of items to return | [optional] |
+| **includeDeclared** | **Boolean**| When true (default), includes tables that have been declared in the namespace but not yet created on storage, in addition to tables that have been created. When false, only tables with storage components are returned.  | [optional] [default to true] |
 
 ### Return type