chore: refactor API to support multi-volumes (wip)

Author: atilafassina

CLAUDE.md

@@ -408,8 +408,8 @@ This project uses conventional commits (enforced by commitlint):
 
 ## Important Context
 
-### Current Branch: improve-bundle-size
-This branch focuses on optimizing bundle size through tsdown configuration tuning.
+### Current Branch: plugin/files
+This branch implements the multi-volume files plugin architecture.
 
 ### Key Dependencies
 - `@databricks/sdk-experimental` v0.15.0+ - Databricks services SDK

apps/dev-playground/.env.dist

@@ -6,6 +6,8 @@ NODE_ENV='development'
 OTEL_EXPORTER_OTLP_ENDPOINT='http://localhost:4318'
 OTEL_RESOURCE_ATTRIBUTES='service.sample_attribute=dev'
 OTEL_SERVICE_NAME='dev-playground'
+DATABRICKS_VOLUME_PLAYGROUND=
+DATABRICKS_VOLUME_OTHER=
 DATABRICKS_GENIE_SPACE_ID=
 LAKEBASE_ENDPOINT='' # Run: databricks postgres list-endpoints projects/{project-id}/branches/{branch-id} — use the `name` field from the output
 PGHOST=

apps/dev-playground/app.yaml

@@ -1,5 +1,7 @@
 env:
   - name: DATABRICKS_WAREHOUSE_ID
     valueFrom: sql-warehouse
-  - name: DATABRICKS_DEFAULT_VOLUME
+  - name: DATABRICKS_VOLUME_PLAYGROUND
     valueFrom: volume
+  - name: DATABRICKS_VOLUME_OTHER
+    valueFrom: other-volume

apps/dev-playground/client/src/appKitTypes.d.ts

@@ -14,46 +14,28 @@ declare module "@databricks/appkit-ui/react" {
           endDate: SQLDateMarker;
         };
         result: Array<{
-          /** @sqlType STRING */
-          app_name: string;
-          /** @sqlType STRING */
-          day_of_week: string;
-          /** @sqlType DECIMAL(35,2) */
-          spend: number;
+          ;
         }>;
       };
     apps_list: {
         name: "apps_list";
         parameters: Record<string, never>;
         result: Array<{
-          /** @sqlType STRING */
-          id: string;
-          /** @sqlType STRING */
-          name: string;
-          /** @sqlType STRING */
-          creator: string;
-          /** @sqlType STRING */
-          tags: string;
-          /** @sqlType DECIMAL(38,6) */
-          totalSpend: number;
-          /** @sqlType DATE */
-          createdAt: string;
+          ;
         }>;
       };
     cost_recommendations: {
         name: "cost_recommendations";
         parameters: Record<string, never>;
         result: Array<{
-          /** @sqlType INT */
-          dummy: number;
+          ;
         }>;
       };
     example: {
         name: "example";
         parameters: Record<string, never>;
         result: Array<{
-          /** @sqlType BOOLEAN */
-          "(1 = 1)": boolean;
+          ;
         }>;
       };
     spend_data: {
@@ -73,12 +55,7 @@ declare module "@databricks/appkit-ui/react" {
           creator: SQLStringMarker;
         };
         result: Array<{
-          /** @sqlType STRING */
-          group_key: string;
-          /** @sqlType TIMESTAMP */
-          aggregation_period: string;
-          /** @sqlType DECIMAL(38,6) */
-          cost_usd: number;
+          ;
         }>;
       };
     spend_summary: {
@@ -92,12 +69,7 @@ declare module "@databricks/appkit-ui/react" {
           startDate: SQLDateMarker;
         };
         result: Array<{
-          /** @sqlType DECIMAL(33,0) */
-          total: number;
-          /** @sqlType DECIMAL(33,0) */
-          average: number;
-          /** @sqlType DECIMAL(33,0) */
-          forecasted: number;
+          ;
         }>;
       };
     sql_helpers_test: {
@@ -117,22 +89,7 @@ declare module "@databricks/appkit-ui/react" {
           binaryParam: SQLStringMarker;
         };
         result: Array<{
-          /** @sqlType STRING */
-          string_value: string;
-          /** @sqlType STRING */
-          number_value: string;
-          /** @sqlType STRING */
-          boolean_value: string;
-          /** @sqlType STRING */
-          date_value: string;
-          /** @sqlType STRING */
-          timestamp_value: string;
-          /** @sqlType BINARY */
-          binary_value: string;
-          /** @sqlType STRING */
-          binary_hex: string;
-          /** @sqlType INT */
-          binary_length: number;
+          ;
         }>;
       };
     top_contributors: {
@@ -146,10 +103,7 @@ declare module "@databricks/appkit-ui/react" {
           endDate: SQLDateMarker;
         };
         result: Array<{
-          /** @sqlType STRING */
-          app_name: string;
-          /** @sqlType DECIMAL(38,6) */
-          total_cost_usd: number;
+          ;
         }>;
       };
     untagged_apps: {