@databricks/appkit 0.17.0 → 0.19.0

package/dist/registry/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/registry/types.ts"],"mappings":";;;;;;;;UA0DiB,kBAAA;EA+BD;EA7Bd,GAAA;EAWM;EATN,WAAA;AAAA;;;;;UAOe,mBAAA;EAoBQ;EAlBvB,IAAA,EAAM,YAAA;EAqBE;EAlBR,KAAA;EAyBe;EAtBf,WAAA;;EAGA,WAAA;EAkCmC;EA/BnC,UAAA,EAAY,kBAAA;EAgByB;;;;EAVrC,MAAA,EAAQ,MAAA,SAAe,kBAAA;EAevB;EAZA,QAAA;AAAA;;;;;UAOe,aAAA,SAAsB,mBAAA;EAqBtB;EAnBf,MAAA;;EAGA,QAAA;EAkBA;EAfA,MAAA,GAAS,MAAA;EAkBA;;;;;EAXT,iBAAA,GAAoB,MAAA,SAAe,kBAAA;AAAA;;;;UAMpB,gBAAA;EAyBc;EAvB7B,KAAA;EAsCiB;EAnCjB,OAAA,EAAS,aAAA;EAsCQ;EAnCjB,GAAA,EAAK,aAAA;AAAA;;;;;;;KAWK,YAAA,GAAe,WAAA;;;;;UAMV,cAAA;EA0Bb;EAxBF,IAAA;EA8BA;EA3BA,WAAA;EAiCA;EA9BA,WAAA;EAgCA;;;EA3BA,SAAA;sEAEE,QAAA,EAAU,IAAA,CAAK,mBAAA;IAGf,QAAA,EAAU,IAAA,CAAK,mBAAA;EAAA;;;;;EAOjB,MAAA;IACE,MAAA,EAAQ,YAAA;EAAA;;;;EAMV,MAAA;;;;EAKA,MAAA;EACA,OAAA;EACA,UAAA;EACA,QAAA;EACA,OAAA;AAAA"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/registry/types.ts"],"mappings":";;;;;;;;UA0DiB,kBAAA;EA+BD;EA7Bd,GAAA;EAWM;EATN,WAAA;AAAA;;;;;UAOe,mBAAA;EAoBQ;EAlBvB,IAAA,EAAM,YAAA;EAqBE;EAlBR,KAAA;EAyBe;EAtBf,WAAA;;EAGA,WAAA;EAkCmC;EA/BnC,UAAA,EAAY,kBAAA;EAgByB;;;;EAVrC,MAAA,EAAQ,MAAA,SAAe,kBAAA;EAevB;EAZA,QAAA;AAAA;;;;;UAOe,aAAA,SAAsB,mBAAA;EAqBtB;EAnBf,MAAA;;EAGA,QAAA;EAkBA;EAfA,MAAA,GAAS,MAAA;EAkBA;;;;;EAXT,iBAAA,GAAoB,MAAA,SAAe,kBAAA;AAAA;;;;UAMpB,gBAAA;EAyBc;EAvB7B,KAAA;EAyBM;EAtBN,OAAA,EAAS,aAAA;EAmCG;EAhCZ,GAAA,EAAK,aAAA;AAAA;;;;;;;KAWK,YAAA,GAAe,WAAA;;;;;UAMV,cAAA;EAkBH;EAhBZ,IAAA,EAAM,KAAA;EAuBN;EApBA,WAAA;EAqBU;EAlBV,WAAA;EA6BA;;;EAxBA,SAAA;IA4BA,kEA1BE,QAAA,EAAU,IAAA,CAAK,mBAAA,iBA0BV;IAvBL,QAAA,EAAU,IAAA,CAAK,mBAAA;EAAA;;;;;EAOjB,MAAA;IACE,MAAA,EAAQ,YAAA;EAAA;;;;EAMV,MAAA;;;;EAKA,MAAA;EACA,OAAA;EACA,UAAA;EACA,QAAA;EACA,OAAA;AAAA"}

package/dist/registry/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../src/registry/types.ts"],"sourcesContent":["/**\n * Resource Registry Type System\n *\n * This module defines the type system for the AppKit Resource Registry,\n * which enables plugins to declare their Databricks resource requirements\n * in a machine-readable format.\n *\n * Resource types and permissions are generated from plugin-manifest.schema.json\n * (see types.generated.ts). Hand-written interfaces below define the registry API.\n */\n\n// Re-export generated registry types (enum + const must be value exports for runtime)\nimport {\n  type AppPermission,\n  type DatabasePermission,\n  type ExperimentPermission,\n  type GenieSpacePermission,\n  type JobPermission,\n  PERMISSION_HIERARCHY_BY_TYPE,\n  PERMISSIONS_BY_TYPE,\n  type ResourcePermission,\n  ResourceType,\n  type SecretPermission,\n  type ServingEndpointPermission,\n  type SqlWarehousePermission,\n  type UcConnectionPermission,\n  type UcFunctionPermission,\n  type VectorSearchIndexPermission,\n  type VolumePermission,\n} from \"./types.generated\";\n\nexport {\n  PERMISSION_HIERARCHY_BY_TYPE,\n  PERMISSIONS_BY_TYPE,\n  ResourceType,\n  type AppPermission,\n  type DatabasePermission,\n  type ExperimentPermission,\n  type GenieSpacePermission,\n  type JobPermission,\n  type ResourcePermission,\n  type SecretPermission,\n  type ServingEndpointPermission,\n  type SqlWarehousePermission,\n  type UcConnectionPermission,\n  type UcFunctionPermission,\n  type VectorSearchIndexPermission,\n  type VolumePermission,\n};\n\n// ============================================================================\n// Hand-written interfaces (not in JSON schema)\n// ============================================================================\n\n/**\n * Defines a single field for a resource. Each field has its own environment variable and optional description.\n * Single-value types use one key (e.g. id); multi-value types (database, secret) use multiple (e.g. instance_name, database_name or scope, key).\n */\nexport interface ResourceFieldEntry {\n  /** Environment variable name for this field */\n  env: string;\n  /** Human-readable description for this field */\n  description?: string;\n}\n\n/**\n * Declares a resource requirement for a plugin.\n * Can be defined statically in a manifest or dynamically via getResourceRequirements().\n */\nexport interface ResourceRequirement {\n  /** Type of Databricks resource required */\n  type: ResourceType;\n\n  /** Unique alias for this resource within the plugin (e.g., 'warehouse', 'secrets'). Used for UI/display. */\n  alias: string;\n\n  /** Stable key for machine use (env naming, composite keys, app.yaml). Required. */\n  resourceKey: string;\n\n  /** Human-readable description of why this resource is needed */\n  description: string;\n\n  /** Required permission level for the resource */\n  permission: ResourcePermission;\n\n  /**\n   * Map of field name to env and optional description.\n   * Single-value types use one key (e.g. id); multi-value (database, secret) use multiple keys.\n   */\n  fields: Record<string, ResourceFieldEntry>;\n\n  /** Whether this resource is required (true) or optional (false) */\n  required: boolean;\n}\n\n/**\n * Internal representation of a resource in the registry.\n * Extends ResourceRequirement with resolution state and plugin ownership.\n */\nexport interface ResourceEntry extends ResourceRequirement {\n  /** Plugin(s) that require this resource (comma-separated if multiple) */\n  plugin: string;\n\n  /** Whether the resource has been resolved (all field env vars set) */\n  resolved: boolean;\n\n  /** Resolved value per field name. Populated by validate() when all field env vars are set. */\n  values?: Record<string, string>;\n\n  /**\n   * Per-plugin permission tracking.\n   * Maps plugin name to the permission it originally requested.\n   * Populated when multiple plugins share the same resource.\n   */\n  permissionSources?: Record<string, ResourcePermission>;\n}\n\n/**\n * Result of validating all registered resources against the environment.\n */\nexport interface ValidationResult {\n  /** Whether all required resources are available */\n  valid: boolean;\n\n  /** List of missing required resources */\n  missing: ResourceEntry[];\n\n  /** Complete list of all registered resources (required and optional) */\n  all: ResourceEntry[];\n}\n\nimport type { JSONSchema7 } from \"json-schema\";\n\n/**\n * Configuration schema definition for plugin config.\n * Re-exported from the standard JSON Schema Draft 7 types.\n *\n * @see {@link https://json-schema.org/draft-07/json-schema-release-notes | JSON Schema Draft 7}\n */\nexport type ConfigSchema = JSONSchema7;\n\n/**\n * Plugin manifest that declares metadata and resource requirements.\n * Attached to plugin classes as a static property.\n */\nexport interface PluginManifest {\n  /** Plugin identifier (matches plugin.name) */\n  name: string;\n\n  /** Human-readable display name for UI/CLI */\n  displayName: string;\n\n  /** Brief description of what the plugin does */\n  description: string;\n\n  /**\n   * Resource requirements declaration\n   */\n  resources: {\n    /** Resources that must be available for the plugin to function */\n    required: Omit<ResourceRequirement, \"required\">[];\n\n    /** Resources that enhance functionality but are not mandatory */\n    optional: Omit<ResourceRequirement, \"required\">[];\n  };\n\n  /**\n   * Configuration schema for the plugin.\n   * Defines the shape and validation rules for plugin config.\n   */\n  config?: {\n    schema: ConfigSchema;\n  };\n\n  /**\n   * When true, excluded from the template plugins manifest during sync.\n   */\n  hidden?: boolean;\n\n  /**\n   * Optional metadata for community plugins\n   */\n  author?: string;\n  version?: string;\n  repository?: string;\n  keywords?: string[];\n  license?: string;\n}\n"],"mappings":""}
+{"version":3,"file":"types.js","names":[],"sources":["../../src/registry/types.ts"],"sourcesContent":["/**\n * Resource Registry Type System\n *\n * This module defines the type system for the AppKit Resource Registry,\n * which enables plugins to declare their Databricks resource requirements\n * in a machine-readable format.\n *\n * Resource types and permissions are generated from plugin-manifest.schema.json\n * (see types.generated.ts). Hand-written interfaces below define the registry API.\n */\n\n// Re-export generated registry types (enum + const must be value exports for runtime)\nimport {\n  type AppPermission,\n  type DatabasePermission,\n  type ExperimentPermission,\n  type GenieSpacePermission,\n  type JobPermission,\n  PERMISSION_HIERARCHY_BY_TYPE,\n  PERMISSIONS_BY_TYPE,\n  type ResourcePermission,\n  ResourceType,\n  type SecretPermission,\n  type ServingEndpointPermission,\n  type SqlWarehousePermission,\n  type UcConnectionPermission,\n  type UcFunctionPermission,\n  type VectorSearchIndexPermission,\n  type VolumePermission,\n} from \"./types.generated\";\n\nexport {\n  PERMISSION_HIERARCHY_BY_TYPE,\n  PERMISSIONS_BY_TYPE,\n  ResourceType,\n  type AppPermission,\n  type DatabasePermission,\n  type ExperimentPermission,\n  type GenieSpacePermission,\n  type JobPermission,\n  type ResourcePermission,\n  type SecretPermission,\n  type ServingEndpointPermission,\n  type SqlWarehousePermission,\n  type UcConnectionPermission,\n  type UcFunctionPermission,\n  type VectorSearchIndexPermission,\n  type VolumePermission,\n};\n\n// ============================================================================\n// Hand-written interfaces (not in JSON schema)\n// ============================================================================\n\n/**\n * Defines a single field for a resource. Each field has its own environment variable and optional description.\n * Single-value types use one key (e.g. id); multi-value types (database, secret) use multiple (e.g. instance_name, database_name or scope, key).\n */\nexport interface ResourceFieldEntry {\n  /** Environment variable name for this field */\n  env: string;\n  /** Human-readable description for this field */\n  description?: string;\n}\n\n/**\n * Declares a resource requirement for a plugin.\n * Can be defined statically in a manifest or dynamically via getResourceRequirements().\n */\nexport interface ResourceRequirement {\n  /** Type of Databricks resource required */\n  type: ResourceType;\n\n  /** Unique alias for this resource within the plugin (e.g., 'warehouse', 'secrets'). Used for UI/display. */\n  alias: string;\n\n  /** Stable key for machine use (env naming, composite keys, app.yaml). Required. */\n  resourceKey: string;\n\n  /** Human-readable description of why this resource is needed */\n  description: string;\n\n  /** Required permission level for the resource */\n  permission: ResourcePermission;\n\n  /**\n   * Map of field name to env and optional description.\n   * Single-value types use one key (e.g. id); multi-value (database, secret) use multiple keys.\n   */\n  fields: Record<string, ResourceFieldEntry>;\n\n  /** Whether this resource is required (true) or optional (false) */\n  required: boolean;\n}\n\n/**\n * Internal representation of a resource in the registry.\n * Extends ResourceRequirement with resolution state and plugin ownership.\n */\nexport interface ResourceEntry extends ResourceRequirement {\n  /** Plugin(s) that require this resource (comma-separated if multiple) */\n  plugin: string;\n\n  /** Whether the resource has been resolved (all field env vars set) */\n  resolved: boolean;\n\n  /** Resolved value per field name. Populated by validate() when all field env vars are set. */\n  values?: Record<string, string>;\n\n  /**\n   * Per-plugin permission tracking.\n   * Maps plugin name to the permission it originally requested.\n   * Populated when multiple plugins share the same resource.\n   */\n  permissionSources?: Record<string, ResourcePermission>;\n}\n\n/**\n * Result of validating all registered resources against the environment.\n */\nexport interface ValidationResult {\n  /** Whether all required resources are available */\n  valid: boolean;\n\n  /** List of missing required resources */\n  missing: ResourceEntry[];\n\n  /** Complete list of all registered resources (required and optional) */\n  all: ResourceEntry[];\n}\n\nimport type { JSONSchema7 } from \"json-schema\";\n\n/**\n * Configuration schema definition for plugin config.\n * Re-exported from the standard JSON Schema Draft 7 types.\n *\n * @see {@link https://json-schema.org/draft-07/json-schema-release-notes | JSON Schema Draft 7}\n */\nexport type ConfigSchema = JSONSchema7;\n\n/**\n * Plugin manifest that declares metadata and resource requirements.\n * Attached to plugin classes as a static property.\n */\nexport interface PluginManifest<TName extends string = string> {\n  /** Plugin identifier — the single source of truth for the plugin's name */\n  name: TName;\n\n  /** Human-readable display name for UI/CLI */\n  displayName: string;\n\n  /** Brief description of what the plugin does */\n  description: string;\n\n  /**\n   * Resource requirements declaration\n   */\n  resources: {\n    /** Resources that must be available for the plugin to function */\n    required: Omit<ResourceRequirement, \"required\">[];\n\n    /** Resources that enhance functionality but are not mandatory */\n    optional: Omit<ResourceRequirement, \"required\">[];\n  };\n\n  /**\n   * Configuration schema for the plugin.\n   * Defines the shape and validation rules for plugin config.\n   */\n  config?: {\n    schema: ConfigSchema;\n  };\n\n  /**\n   * When true, excluded from the template plugins manifest during sync.\n   */\n  hidden?: boolean;\n\n  /**\n   * Optional metadata for community plugins\n   */\n  author?: string;\n  version?: string;\n  repository?: string;\n  keywords?: string[];\n  license?: string;\n}\n"],"mappings":""}

package/dist/shared/src/genie.d.ts

@@ -15,7 +15,7 @@ type GenieStreamEvent = {
   type: "query_result";
   attachmentId: string;
   statementId: string;
-  data: unknown;
+  data: GenieStatementResponse;
 } | {
   type: "error";
   error: string;
@@ -26,6 +26,20 @@ type GenieStreamEvent = {
   nextPageToken: string | null; /** Total messages returned in this initial load */
   loadedCount: number;
 };
+/** Shape of the Databricks SQL statement_response returned by Genie queries */
+interface GenieStatementResponse {
+  manifest: {
+    schema: {
+      columns: Array<{
+        name: string;
+        type_name: string;
+      }>;
+    };
+  };
+  result: {
+    data_array: (string | null)[][];
+  };
+}
 /** Cleaned response — subset of SDK GenieMessage */
 interface GenieMessageResponse {
   messageId: string;
@@ -50,5 +64,5 @@ interface GenieAttachmentResponse {
   suggestedQuestions?: string[];
 }
 //#endregion
-export { GenieAttachmentResponse, GenieMessageResponse, GenieStreamEvent };
+export { GenieAttachmentResponse, GenieMessageResponse, GenieStatementResponse, GenieStreamEvent };
 //# sourceMappingURL=genie.d.ts.map

package/dist/shared/src/genie.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"genie.d.ts","names":[],"sources":["../../../../shared/src/genie.ts"],"mappings":";;KACY,gBAAA;EAEN,IAAA;EACA,cAAA;EACA,SAAA;EACA,OAAA;AAAA;EAEA,IAAA;EAAgB,MAAA;AAAA;EAChB,IAAA;EAAwB,OAAA,EAAS,oBAAA;AAAA;EAEjC,IAAA;EACA,YAAA;EACA,WAAA;EACA,IAAA;AAAA;EAEA,IAAA;EAAe,KAAA;AAAA;EAEf,IAAA;EACA,cAAA;EACA,OAAA,UAIA;EAFA,aAAA,iBAEW;EAAX,WAAA;AAAA;;UAIW,oBAAA;EACf,SAAA;EACA,cAAA;EACA,OAAA;EACA,MAAA;EACA,OAAA;EACA,WAAA,GAAc,uBAAA;EACd,KAAA;AAAA;AAAA,UAGe,uBAAA;EACf,YAAA;EACA,KAAA;IACE,KAAA;IACA,WAAA;IACA,KAAA;IACA,WAAA;EAAA;EAEF,IAAA;IAAS,OAAA;EAAA;EACT,kBAAA;AAAA"}
+{"version":3,"file":"genie.d.ts","names":[],"sources":["../../../../shared/src/genie.ts"],"mappings":";;KACY,gBAAA;EAEN,IAAA;EACA,cAAA;EACA,SAAA;EACA,OAAA;AAAA;EAEA,IAAA;EAAgB,MAAA;AAAA;EAChB,IAAA;EAAwB,OAAA,EAAS,oBAAA;AAAA;EAEjC,IAAA;EACA,YAAA;EACA,WAAA;EACA,IAAA,EAAM,sBAAA;AAAA;EAEN,IAAA;EAAe,KAAA;AAAA;EAEf,IAAA;EACA,cAAA;EACA,OAAA,UAEA;EAAA,aAAA,iBAEW;EAAX,WAAA;AAAA;;UAIW,sBAAA;EACf,QAAA;IACE,MAAA;MACE,OAAA,EAAS,KAAA;QAAQ,IAAA;QAAc,SAAA;MAAA;IAAA;EAAA;EAGnC,MAAA;IACE,UAAA;EAAA;AAAA;;UAKa,oBAAA;EACf,SAAA;EACA,cAAA;EACA,OAAA;EACA,MAAA;EACA,OAAA;EACA,WAAA,GAAc,uBAAA;EACd,KAAA;AAAA;AAAA,UAGe,uBAAA;EACf,YAAA;EACA,KAAA;IACE,KAAA;IACA,WAAA;IACA,KAAA;IACA,WAAA;EAAA;EAEF,IAAA;IAAS,OAAA;EAAA;EACT,kBAAA;AAAA"}

package/dist/shared/src/index.d.ts

@@ -1,7 +1,7 @@
 import { BasePlugin, BasePluginConfig, HttpMethod, IAppRequest, IAppResponse, IAppRouter, PluginConstructor, PluginData, PluginEndpointMap, PluginExports, PluginManifest, PluginMap, PluginPhase, ResourceFieldEntry, ResourceRequirement, RouteConfig, TelemetryOptions, ToPlugin, WithAsUser } from "./plugin.js";
 import { CacheConfig, CacheEntry, CacheStorage } from "./cache.js";
 import { PluginExecuteConfig, PluginExecutionSettings, RetryConfig, StreamConfig, StreamExecuteHandler, StreamExecutionSettings, TelemetryConfig } from "./execute.js";
-import { GenieAttachmentResponse, GenieMessageResponse, GenieStreamEvent } from "./genie.js";
+import { GenieAttachmentResponse, GenieMessageResponse, GenieStatementResponse, GenieStreamEvent } from "./genie.js";
 import { SQLBinaryMarker, SQLBooleanMarker, SQLDateMarker, SQLNumberMarker, SQLStringMarker, SQLTimestampMarker, SQLTypeMarker } from "./sql/types.js";
 import { isSQLTypeMarker, sql } from "./sql/helpers.js";
 import { PendingFetch, PendingFileRead, TunnelConnection } from "./tunnel.js";

package/dist/shared/src/plugin.d.ts

@@ -9,6 +9,7 @@ interface BasePlugin {
   setup(): Promise<void>;
   injectRoutes(router: express.Router): void;
   getEndpoints(): PluginEndpointMap;
+  getSkipBodyParsingPaths?(): ReadonlySet<string>;
   exports?(): unknown;
 }
 /** Base configuration interface for AppKit plugins */
@@ -46,8 +47,8 @@ type PluginConstructor<C = BasePluginConfig, I extends BasePlugin = BasePlugin>
  * Manifest declaration for plugins (imported from registry types).
  * Re-exported here to avoid circular dependencies.
  */
-interface PluginManifest {
-  name: string;
+interface PluginManifest<TName extends string = string> {
+  name: TName;
   displayName: string;
   description: string;
   resources: {
@@ -104,8 +105,11 @@ type PluginExports<T extends BasePlugin> = T["exports"] extends (() => infer R)
 /**
  * Wraps an SDK with the `asUser` method that AppKit automatically adds.
  * When `asUser(req)` is called, it returns the same SDK but scoped to the user's credentials.
+ *
+ * When the SDK is a function (callable export), it is returned as-is since
+ * the plugin manages its own `asUser` pattern per-call.
  */
-type WithAsUser<SDK> = SDK & {
+type WithAsUser<SDK> = SDK extends ((...args: any[]) => any) ? SDK : SDK & {
   /**
    * Execute operations using the user's identity from the request.
    * Returns a user-scoped SDK where all methods execute with the
@@ -117,6 +121,9 @@ type WithAsUser<SDK> = SDK & {
  * Maps plugin names to their exported types (with asUser automatically added).
  * Each plugin exposes its public API via the exports() method,
  * and AppKit wraps it with asUser() for user-scoped execution.
+ *
+ * Callable exports (functions) are passed through without wrapping,
+ * as they manage their own `asUser` pattern (e.g. files plugin).
  */
 type PluginMap<U extends readonly PluginData<PluginConstructor, unknown, string>[]> = { [P in U[number] as P["name"]]: WithAsUser<PluginExports<InstanceType<P["plugin"]>>> };
 type PluginData<T, U, N> = {
@@ -134,7 +141,8 @@ type RouteConfig = {
   /** Unique name for this endpoint (used for frontend access) */name: string;
   method: HttpMethod;
   path: string;
-  handler: (req: IAppRequest, res: IAppResponse) => Promise<void>;
+  handler: (req: IAppRequest, res: IAppResponse) => Promise<void>; /** When true, the server will skip JSON body parsing for this route (e.g. file uploads). */
+  skipBodyParsing?: boolean;
 };
 /** Map of endpoint names to their full paths for a plugin */
 type PluginEndpointMap = Record<string, string>;

package/dist/shared/src/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","names":[],"sources":["../../../../shared/src/plugin.ts"],"mappings":";;;;;UAIiB,UAAA;EACf,IAAA;EAEA,qBAAA;EAEA,KAAA,IAAS,OAAA;EAET,YAAA,CAAa,MAAA,EAAQ,OAAA,CAAQ,MAAA;EAE7B,YAAA,IAAgB,iBAAA;EAEhB,OAAA;AAAA;;UAIe,gBAAA;EACf,IAAA;EACA,IAAA;EAAA,CAEC,GAAA;EAMD,SAAA,GAAY,gBAAA;AAAA;AAAA,KAGF,gBAAA;EAGN,MAAA;EACA,OAAA;EACA,IAAA;AAAA;AAAA,KAQM,WAAA;;;;;KAMA,iBAAA,KACN,gBAAA,YACM,UAAA,GAAa,UAAA,UAEvB,MAAA,EAAQ,CAAA,KACL,CAAA;EACH,cAAA,GAAiB,MAAA;EACjB,KAAA,GAAQ,WAAA;EA7BoB;AAG9B;;;EA+BE,QAAA,EAAU,cAAA;EA5BN;;;;EAiCJ,uBAAA,EAAyB,MAAA,EAAQ,CAAA,GAAI,mBAAA;AAAA;;;;;UAOtB,cAAA;EACf,IAAA;EACA,WAAA;EACA,WAAA;EACA,SAAA;IACE,QAAA,EAAU,IAAA,CAAK,mBAAA;IACf,QAAA,EAAU,IAAA,CAAK,mBAAA;EAAA;EAEjB,MAAA;IACE,MAAA,EAAQ,WAAA;EAAA;EAEV,cAAA;EACA,MAAA;EACA,MAAA;EACA,OAAA;EACA,UAAA;EACA,QAAA;EACA,OAAA;AAAA;;;;;;;UASe,kBAAA;EA3CP;EA6CR,GAAA;EAxCU;EA0CV,WAAA;AAAA;;;;;UAOe,mBAAA;EACf,IAAA;EACA,KAAA;EAlCiB;EAoCjB,WAAA;EACA,WAAA;EACA,UAAA;EAlCU;;;;EAuCV,MAAA,EAAQ,MAAA,SAAe,kBAAA;EACvB,QAAA;AAAA;;AAvBF;;;;KA2DY,aAAA,WAAwB,UAAA,IAClC,CAAA,sCAAqC,CAAA,GAAI,MAAA;AAjD3C;;;;AAAA,KAuDY,UAAA,QAAkB,GAAA;EArD5B;;;;;EA2DA,MAAA,GAAS,GAAA,EAAK,WAAA,KAAgB,GAAA;AAAA;;;;AAbhC;;KAqBY,SAAA,oBACS,UAAA,CAAW,iBAAA,gCAExB,CAAA,YAAa,CAAA,WAAY,UAAA,CAC7B,aAAA,CAAc,YAAA,CAAa,CAAA;AAAA,KAInB,UAAA;EAAwB,MAAA,EAAQ,CAAA;EAAG,MAAA,EAAQ,CAAA;EAAG,IAAA,EAAM,CAAA;AAAA;AAAA,KACpD,QAAA,4BACV,MAAA,GAAS,CAAA,KACN,UAAA,CAAW,CAAA,EAAG,CAAA,EAAG,CAAA;;KAGV,UAAA,GAAa,OAAA,CAAQ,MAAA;AAAA,KACrB,YAAA,GAAe,OAAA,CAAQ,QAAA;AAAA,KACvB,WAAA,GAAc,OAAA,CAAQ,OAAA;AAAA,KAEtB,UAAA;AAAA,KAEA,WAAA;EAlCU,+DAoCpB,IAAA;EACA,MAAA,EAAQ,UAAA;EACR,IAAA;EACA,OAAA,GAAU,GAAA,EAAK,WAAA,EAAa,GAAA,EAAK,YAAA,KAAiB,OAAA;AAAA;;KAIxC,iBAAA,GAAoB,MAAA"}
+{"version":3,"file":"plugin.d.ts","names":[],"sources":["../../../../shared/src/plugin.ts"],"mappings":";;;;;UAIiB,UAAA;EACf,IAAA;EAEA,qBAAA;EAEA,KAAA,IAAS,OAAA;EAET,YAAA,CAAa,MAAA,EAAQ,OAAA,CAAQ,MAAA;EAE7B,YAAA,IAAgB,iBAAA;EAEhB,uBAAA,KAA4B,WAAA;EAE5B,OAAA;AAAA;;UAIe,gBAAA;EACf,IAAA;EACA,IAAA;EAAA,CAEC,GAAA;EAMD,SAAA,GAAY,gBAAA;AAAA;AAAA,KAGF,gBAAA;EAGN,MAAA;EACA,OAAA;EACA,IAAA;AAAA;AAAA,KAQM,WAAA;;;;;KAMA,iBAAA,KACN,gBAAA,YACM,UAAA,GAAa,UAAA,UAEvB,MAAA,EAAQ,CAAA,KACL,CAAA;EACH,cAAA,GAAiB,MAAA;EACjB,KAAA,GAAQ,WAAA;EA7BI;;;AAGd;EA+BE,QAAA,EAAU,cAAA;;;;;EAKV,uBAAA,EAAyB,MAAA,EAAQ,CAAA,GAAI,mBAAA;AAAA;;AAvBvC;;;UA8BiB,cAAA;EACf,IAAA,EAAM,KAAA;EACN,WAAA;EACA,WAAA;EACA,SAAA;IACE,QAAA,EAAU,IAAA,CAAK,mBAAA;IACf,QAAA,EAAU,IAAA,CAAK,mBAAA;EAAA;EAEjB,MAAA;IACE,MAAA,EAAQ,WAAA;EAAA;EAEV,cAAA;EACA,MAAA;EACA,MAAA;EACA,OAAA;EACA,UAAA;EACA,QAAA;EACA,OAAA;AAAA;;;;;;;UASe,kBAAA;EA5CE;EA8CjB,GAAA;EA7CQ;EA+CR,WAAA;AAAA;;;;;UAOe,mBAAA;EACf,IAAA;EACA,KAAA;EAvC6B;EAyC7B,WAAA;EACA,WAAA;EACA,UAAA;EAtCY;;;;EA2CZ,MAAA,EAAQ,MAAA,SAAe,kBAAA;EACvB,QAAA;AAAA;;;;;;KAoCU,aAAA,WAAwB,UAAA,IAClC,CAAA,sCAAqC,CAAA,GAAI,MAAA;AA5D3C;;;;;AAWA;;AAXA,KAqEY,UAAA,QAAkB,GAAA,cAAgB,IAAA,mBAC1C,GAAA,GACA,GAAA;EAjDY;;;;;EAuDV,MAAA,GAAS,GAAA,EAAK,WAAA,KAAgB,GAAA;AAAA;;;;;;AAlBpC;;;KA6BY,SAAA,oBACS,UAAA,CAAW,iBAAA,gCAExB,CAAA,YAAa,CAAA,WAAY,UAAA,CAC7B,aAAA,CAAc,YAAA,CAAa,CAAA;AAAA,KAInB,UAAA;EAAwB,MAAA,EAAQ,CAAA;EAAG,MAAA,EAAQ,CAAA;EAAG,IAAA,EAAM,CAAA;AAAA;AAAA,KACpD,QAAA,4BACV,MAAA,GAAS,CAAA,KACN,UAAA,CAAW,CAAA,EAAG,CAAA,EAAG,CAAA;;KAGV,UAAA,GAAa,OAAA,CAAQ,MAAA;AAAA,KACrB,YAAA,GAAe,OAAA,CAAQ,QAAA;AAAA,KACvB,WAAA,GAAc,OAAA,CAAQ,OAAA;AAAA,KAEtB,UAAA;AAAA,KAEA,WAAA;EAvCU,+DAyCpB,IAAA;EACA,MAAA,EAAQ,UAAA;EACR,IAAA;EACA,OAAA,GAAU,GAAA,EAAK,WAAA,EAAa,GAAA,EAAK,YAAA,KAAiB,OAAA,QApChB;EAsClC,eAAA;AAAA;;KAIU,iBAAA,GAAoB,MAAA"}

package/docs/api/appkit/Class.Plugin.md

@@ -32,7 +32,6 @@ const myManifest: PluginManifest = {
 
 class MyPlugin extends Plugin<MyConfig> {
   static manifest = myManifest;
-  name = 'myPlugin';
 }
 
 ```
@@ -56,8 +55,7 @@ const myManifest: PluginManifest = {
 };
 
 class MyPlugin extends Plugin<MyConfig> {
-  static manifest = myManifest;
-  name = 'myPlugin';
+  static manifest = myManifest<"myPlugin">;
 
   // Runtime method: converts optional resources to required based on config
   static getResourceRequirements(config: MyConfig) {
@@ -253,7 +251,7 @@ A proxied plugin instance that executes as the user
 
 #### Throws[​](#throws "Direct link to Throws")
 
-Error if user token is not available in request headers
+AuthenticationError if user token is not available in request headers (production only). In development mode (`NODE_ENV=development`), falls back to the service principal instead of throwing.
 
 ***
 
@@ -267,6 +265,10 @@ userKey?: string): Promise<T | undefined>;
 
 ```
 
+Execute a function with the plugin's interceptor chain.
+
+All errors are caught and `undefined` is returned (production-safe). Route handlers should check for `undefined` and respond with an appropriate error status.
+
 #### Type Parameters[​](#type-parameters-1 "Direct link to Type Parameters")
 
 | Type Parameter |
@@ -338,7 +340,6 @@ The returned object becomes the plugin's public API on the AppKit instance (e.g.
 
 ```ts
 class MyPlugin extends Plugin {
-  name = "myPlugin";
   private getData() { return []; }
 
   exports() {
@@ -381,6 +382,26 @@ BasePlugin.getEndpoints
 
 ***
 
+### getSkipBodyParsingPaths()[​](#getskipbodyparsingpaths "Direct link to getSkipBodyParsingPaths()")
+
+```ts
+getSkipBodyParsingPaths(): ReadonlySet<string>;
+
+```
+
+#### Returns[​](#returns-7 "Direct link to Returns")
+
+`ReadonlySet`<`string`>
+
+#### Implementation of[​](#implementation-of-4 "Direct link to Implementation of")
+
+```ts
+BasePlugin.getSkipBodyParsingPaths
+
+```
+
+***
+
 ### injectRoutes()[​](#injectroutes "Direct link to injectRoutes()")
 
 ```ts
@@ -394,11 +415,11 @@ injectRoutes(_: Router): void;
 | --------- | -------- |
 | `_`       | `Router` |
 
-#### Returns[​](#returns-7 "Direct link to Returns")
+#### Returns[​](#returns-8 "Direct link to Returns")
 
 `void`
 
-#### Implementation of[​](#implementation-of-4 "Direct link to Implementation of")
+#### Implementation of[​](#implementation-of-5 "Direct link to Implementation of")
 
 ```ts
 BasePlugin.injectRoutes
@@ -421,12 +442,39 @@ protected registerEndpoint(name: string, path: string): void;
 | `name`    | `string` |
 | `path`    | `string` |
 
-#### Returns[​](#returns-8 "Direct link to Returns")
+#### Returns[​](#returns-9 "Direct link to Returns")
 
 `void`
 
 ***
 
+### resolveUserId()[​](#resolveuserid "Direct link to resolveUserId()")
+
+```ts
+protected resolveUserId(req: Request): string;
+
+```
+
+Resolve the effective user ID from a request.
+
+Returns the `x-forwarded-user` header when present. In development mode (`NODE_ENV=development`) falls back to the current context user ID so that callers outside an active `runInUserContext` scope still get a consistent value.
+
+#### Parameters[​](#parameters-6 "Direct link to Parameters")
+
+| Parameter | Type      |
+| --------- | --------- |
+| `req`     | `Request` |
+
+#### Returns[​](#returns-10 "Direct link to Returns")
+
+`string`
+
+#### Throws[​](#throws-1 "Direct link to Throws")
+
+AuthenticationError in production when no user header is present.
+
+***
+
 ### route()[​](#route "Direct link to route()")
 
 ```ts
@@ -440,14 +488,14 @@ protected route<_TResponse>(router: Router, config: RouteConfig): void;
 | -------------- |
 | `_TResponse`   |
 
-#### Parameters[​](#parameters-6 "Direct link to Parameters")
+#### Parameters[​](#parameters-7 "Direct link to Parameters")
 
 | Parameter | Type          |
 | --------- | ------------- |
 | `router`  | `Router`      |
 | `config`  | `RouteConfig` |
 
-#### Returns[​](#returns-9 "Direct link to Returns")
+#### Returns[​](#returns-11 "Direct link to Returns")
 
 `void`
 
@@ -460,11 +508,11 @@ setup(): Promise<void>;
 
 ```
 
-#### Returns[​](#returns-10 "Direct link to Returns")
+#### Returns[​](#returns-12 "Direct link to Returns")
 
 `Promise`<`void`>
 
-#### Implementation of[​](#implementation-of-5 "Direct link to Implementation of")
+#### Implementation of[​](#implementation-of-6 "Direct link to Implementation of")
 
 ```ts
 BasePlugin.setup

package/docs/api/appkit/Class.ResourceRegistry.md

@@ -43,9 +43,9 @@ Collects and registers resource requirements from an array of plugins. For each
 
 #### Parameters[​](#parameters "Direct link to Parameters")
 
-| Parameter    | Type                                                      | Description                                               |
-| ------------ | --------------------------------------------------------- | --------------------------------------------------------- |
-| `rawPlugins` | `PluginData`<`PluginConstructor`, `unknown`, `string`>\[] | Array of plugin data entries from createApp configuration |
+| Parameter    | Type                                                                                                         | Description                                               |
+| ------------ | ------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------- |
+| `rawPlugins` | [`PluginData`](./docs/api/appkit/TypeAlias.PluginData.md)<`PluginConstructor`, `unknown`, `string`>\[] | Array of plugin data entries from createApp configuration |
 
 #### Returns[​](#returns-2 "Direct link to Returns")
 

package/docs/api/appkit/Function.createApp.md

@@ -16,9 +16,9 @@ Initializes telemetry, cache, and service context, then registers plugins in pha
 
 ## Type Parameters[​](#type-parameters "Direct link to Type Parameters")
 
-| Type Parameter                                                          |
-| ----------------------------------------------------------------------- |
-| `T` *extends* `PluginData`<`PluginConstructor`, `unknown`, `string`>\[] |
+| Type Parameter                                                                                                             |
+| -------------------------------------------------------------------------------------------------------------------------- |
+| `T` *extends* [`PluginData`](./docs/api/appkit/TypeAlias.PluginData.md)<`PluginConstructor`, `unknown`, `string`>\[] |
 
 ## Parameters[​](#parameters "Direct link to Parameters")
 

package/docs/api/appkit/Interface.PluginManifest.md

@@ -1,7 +1,13 @@
-# Interface: PluginManifest
+# Interface: PluginManifest\<TName>
 
 Plugin manifest that declares metadata and resource requirements. Attached to plugin classes as a static property.
 
+## Type Parameters[​](#type-parameters "Direct link to Type Parameters")
+
+| Type Parameter             | Default type |
+| -------------------------- | ------------ |
+| `TName` *extends* `string` | `string`     |
+
 ## Properties[​](#properties "Direct link to Properties")
 
 ### author?[​](#author "Direct link to author?")
@@ -89,11 +95,11 @@ optional license: string;
 ### name[​](#name "Direct link to name")
 
 ```ts
-name: string;
+name: TName;
 
 ```
 
-Plugin identifier (matches plugin.name)
+Plugin identifier — the single source of truth for the plugin's name
 
 ***
 

package/docs/api/appkit/TypeAlias.PluginData.md

@@ -0,0 +1,45 @@
+# Type Alias: PluginData\<T, U, N>
+
+```ts
+type PluginData<T, U, N> = {
+  config: U;
+  name: N;
+  plugin: T;
+};
+
+```
+
+## Type Parameters[​](#type-parameters "Direct link to Type Parameters")
+
+| Type Parameter |
+| -------------- |
+| `T`            |
+| `U`            |
+| `N`            |
+
+## Properties[​](#properties "Direct link to Properties")
+
+### config[​](#config "Direct link to config")
+
+```ts
+config: U;
+
+```
+
+***
+
+### name[​](#name "Direct link to name")
+
+```ts
+name: N;
+
+```
+
+***
+
+### plugin[​](#plugin "Direct link to plugin")
+
+```ts
+plugin: T;
+
+```

package/docs/api/appkit/TypeAlias.ToPlugin.md

@@ -21,4 +21,4 @@ type ToPlugin<T, U, N> = (config?: U) => PluginData<T, U, N>;
 
 ## Returns[​](#returns "Direct link to Returns")
 
-`PluginData`<`T`, `U`, `N`>
+[`PluginData`](./docs/api/appkit/TypeAlias.PluginData.md)<`T`, `U`, `N`>

package/docs/api/appkit-ui/files/DirectoryList.md

@@ -0,0 +1,36 @@
+# DirectoryList
+
+Card-wrapped directory listing with loading, error, and empty states
+
+## DirectoryList[​](#directorylist-1 "Direct link to DirectoryList")
+
+Card-wrapped directory listing with loading, error, and empty states
+
+**Source:** [`packages/appkit-ui/src/react/file-browser/directory-list.tsx`](https://github.com/databricks/appkit/blob/main/packages/appkit-ui/src/react/file-browser/directory-list.tsx)
+
+### Props[​](#props "Direct link to Props")
+
+| Prop                 | Type                                                                                             | Required | Default | Description                                                                        |
+| -------------------- | ------------------------------------------------------------------------------------------------ | -------- | ------- | ---------------------------------------------------------------------------------- |
+| `entries`            | `DirectoryEntry[]`                                                                               | ✓        | -       | Directory entries to display                                                       |
+| `loading`            | `boolean`                                                                                        |          | -       | Whether the directory is currently loading                                         |
+| `error`              | `string \| null`                                                                                 |          | -       | Error message to display                                                           |
+| `onEntryClick`       | `(entry: DirectoryEntry) => void`                                                                | ✓        | -       | Called when an entry is clicked                                                    |
+| `onNavigateToParent` | `(() => void)`                                                                                   |          | -       | Called when the back/parent button is clicked                                      |
+| `onRetry`            | `(() => void)`                                                                                   |          | -       | Called when the retry button is clicked                                            |
+| `isAtRoot`           | `boolean`                                                                                        |          | -       | Whether the user is at the root directory (hides back button)                      |
+| `selectedPath`       | `string \| null`                                                                                 |          | -       | Currently selected file path for highlighting                                      |
+| `resolveEntryPath`   | `(entry: DirectoryEntry) => string`                                                              | ✓        | -       | Resolves a DirectoryEntry to its full path                                         |
+| `headerContent`      | `ReactNode`                                                                                      |          | -       | Content rendered between the back button and the entry list (e.g., NewFolderInput) |
+| `hasCurrentPath`     | `boolean`                                                                                        |          | -       | Whether a current path is set (affects empty state message)                        |
+| `formatSize`         | `((bytes: number) => string)`                                                                    |          | -       | Custom file size formatter                                                         |
+| `labels`             | `Pick<FileBrowserLabels, "backToParent" \| "emptyDirectory" \| "noVolumeConfigured" \| "retry">` |          | -       | Customizable labels                                                                |
+
+### Usage[​](#usage "Direct link to Usage")
+
+```tsx
+import { DirectoryList } from '@databricks/appkit-ui';
+
+<DirectoryList /* props */ />
+
+```

package/docs/api/appkit-ui/files/FileBreadcrumb.md

@@ -0,0 +1,27 @@
+# FileBreadcrumb
+
+Path-aware breadcrumb navigation built on top of Breadcrumb primitives
+
+## FileBreadcrumb[​](#filebreadcrumb-1 "Direct link to FileBreadcrumb")
+
+Path-aware breadcrumb navigation built on top of Breadcrumb primitives
+
+**Source:** [`packages/appkit-ui/src/react/file-browser/file-breadcrumb.tsx`](https://github.com/databricks/appkit/blob/main/packages/appkit-ui/src/react/file-browser/file-breadcrumb.tsx)
+
+### Props[​](#props "Direct link to Props")
+
+| Prop                  | Type                      | Required | Default | Description                                                          |
+| --------------------- | ------------------------- | -------- | ------- | -------------------------------------------------------------------- |
+| `rootLabel`           | `string`                  | ✓        | -       | Label for the root breadcrumb item                                   |
+| `segments`            | `string[]`                | ✓        | -       | Path segments after the root                                         |
+| `onNavigateToRoot`    | `() => void`              | ✓        | -       | Called when the root breadcrumb is clicked                           |
+| `onNavigateToSegment` | `(index: number) => void` | ✓        | -       | Called when a segment breadcrumb is clicked (receives segment index) |
+
+### Usage[​](#usage "Direct link to Usage")
+
+```tsx
+import { FileBreadcrumb } from '@databricks/appkit-ui';
+
+<FileBreadcrumb /* props */ />
+
+```

package/docs/api/appkit-ui/files/FileEntry.md

@@ -0,0 +1,27 @@
+# FileEntry
+
+Single file or directory row with icon, name, size, and selection state
+
+## FileEntry[​](#fileentry-1 "Direct link to FileEntry")
+
+Single file or directory row with icon, name, size, and selection state
+
+**Source:** [`packages/appkit-ui/src/react/file-browser/file-entry.tsx`](https://github.com/databricks/appkit/blob/main/packages/appkit-ui/src/react/file-browser/file-entry.tsx)
+
+### Props[​](#props "Direct link to Props")
+
+| Prop         | Type                          | Required | Default | Description                                             |
+| ------------ | ----------------------------- | -------- | ------- | ------------------------------------------------------- |
+| `entry`      | `DirectoryEntry`              | ✓        | -       | The directory entry to render                           |
+| `entryPath`  | `string`                      | ✓        | -       | Resolved full path for this entry                       |
+| `isSelected` | `boolean`                     |          | -       | Whether this entry is currently selected                |
+| `formatSize` | `((bytes: number) => string)` |          | -       | Custom file size formatter (defaults to formatFileSize) |
+
+### Usage[​](#usage "Direct link to Usage")
+
+```tsx
+import { FileEntry } from '@databricks/appkit-ui';
+
+<FileEntry /* props */ />
+
+```

package/docs/api/appkit-ui/files/FilePreviewPanel.md

@@ -0,0 +1,32 @@
+# FilePreviewPanel
+
+Preview panel displaying file metadata, image/text preview, and download/delete actions
+
+## FilePreviewPanel[​](#filepreviewpanel-1 "Direct link to FilePreviewPanel")
+
+Preview panel displaying file metadata, image/text preview, and download/delete actions
+
+**Source:** [`packages/appkit-ui/src/react/file-browser/file-preview-panel.tsx`](https://github.com/databricks/appkit/blob/main/packages/appkit-ui/src/react/file-browser/file-preview-panel.tsx)
+
+### Props[​](#props "Direct link to Props")
+
+| Prop              | Type                                                                                                                                                   | Required | Default | Description                                                               |
+| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | ------- | ------------------------------------------------------------------------- |
+| `selectedFile`    | `string \| null`                                                                                                                                       | ✓        | -       | Full path of the selected file (null when nothing is selected)            |
+| `preview`         | `FilePreview \| null`                                                                                                                                  | ✓        | -       | Preview data for the selected file                                        |
+| `previewLoading`  | `boolean`                                                                                                                                              |          | -       | Whether the preview is loading                                            |
+| `onDownload`      | `((filePath: string) => void)`                                                                                                                         |          | -       | Called when the download button is clicked                                |
+| `onDelete`        | `((filePath: string) => void)`                                                                                                                         |          | -       | Called when the delete button is clicked                                  |
+| `deleting`        | `boolean`                                                                                                                                              |          | -       | Whether a delete operation is in progress                                 |
+| `imagePreviewSrc` | `string \| ((filePath: string) => string)`                                                                                                             |          | -       | Image preview source — string URL or function that receives the file path |
+| `formatSize`      | `((bytes: number) => string)`                                                                                                                          |          | -       | Custom file size formatter (defaults to formatFileSize)                   |
+| `labels`          | `Pick<FileBrowserLabels, "type" \| "download" \| "size" \| "selectFilePrompt" \| "previewNotAvailable" \| "previewFailed" \| "modified" \| "unknown">` |          | -       | Customizable labels                                                       |
+
+### Usage[​](#usage "Direct link to Usage")
+
+```tsx
+import { FilePreviewPanel } from '@databricks/appkit-ui';
+
+<FilePreviewPanel /* props */ />
+
+```

package/docs/api/appkit-ui/files/NewFolderInput.md

@@ -0,0 +1,30 @@
+# NewFolderInput
+
+Inline folder-name input with create/cancel actions
+
+## NewFolderInput[​](#newfolderinput-1 "Direct link to NewFolderInput")
+
+Inline folder-name input with create/cancel actions
+
+**Source:** [`packages/appkit-ui/src/react/file-browser/new-folder-input.tsx`](https://github.com/databricks/appkit/blob/main/packages/appkit-ui/src/react/file-browser/new-folder-input.tsx)
+
+### Props[​](#props "Direct link to Props")
+
+| Prop        | Type                                                           | Required | Default | Description                            |
+| ----------- | -------------------------------------------------------------- | -------- | ------- | -------------------------------------- |
+| `value`     | `string`                                                       | ✓        | -       | Current folder name value              |
+| `onChange`  | `(value: string) => void`                                      | ✓        | -       | Called when folder name changes        |
+| `onCreate`  | `() => void`                                                   | ✓        | -       | Called when the user confirms creation |
+| `onCancel`  | `() => void`                                                   | ✓        | -       | Called when the user cancels           |
+| `creating`  | `boolean`                                                      |          | -       | Whether folder creation is in progress |
+| `autoFocus` | `boolean`                                                      |          | `true`  | Auto-focus the input on mount          |
+| `labels`    | `Pick<FileBrowserLabels, "create" \| "folderNamePlaceholder">` |          | -       | Customizable labels                    |
+
+### Usage[​](#usage "Direct link to Usage")
+
+```tsx
+import { NewFolderInput } from '@databricks/appkit-ui';
+
+<NewFolderInput /* props */ />
+
+```

package/docs/api/appkit-ui/genie/GenieQueryVisualization.md

@@ -0,0 +1,29 @@
+# GenieQueryVisualization
+
+Renders a chart + data table for a Genie query result.
+
+## GenieQueryVisualization[​](#geniequeryvisualization-1 "Direct link to GenieQueryVisualization")
+
+Renders a chart + data table for a Genie query result.
+
+* When a chart type can be inferred: shows Tabs with "Chart" (default) and "Table"
+* When no chart fits: shows only the data table
+* When data is empty/malformed: renders nothing
+
+**Source:** [`packages/appkit-ui/src/react/genie/genie-query-visualization.tsx`](https://github.com/databricks/appkit/blob/main/packages/appkit-ui/src/react/genie/genie-query-visualization.tsx)
+
+### Props[​](#props "Direct link to Props")
+
+| Prop        | Type                     | Required | Default | Description                                |
+| ----------- | ------------------------ | -------- | ------- | ------------------------------------------ |
+| `data`      | `GenieStatementResponse` | ✓        | -       | Raw statement\_response from the Genie API |
+| `className` | `string`                 |          | -       | Additional CSS classes                     |
+
+### Usage[​](#usage "Direct link to Usage")
+
+```tsx
+import { GenieQueryVisualization } from '@databricks/appkit-ui';
+
+<GenieQueryVisualization /* props */ />
+
+```

package/docs/api/appkit.md

@@ -51,6 +51,7 @@ Core library for building Databricks applications with type-safe SQL queries, pl
 | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
 | [ConfigSchema](./docs/api/appkit/TypeAlias.ConfigSchema.md)             | Configuration schema definition for plugin config. Re-exported from the standard JSON Schema Draft 7 types. |
 | [IAppRouter](./docs/api/appkit/TypeAlias.IAppRouter.md)                 | Express router type for plugin route registration                                                           |
+| [PluginData](./docs/api/appkit/TypeAlias.PluginData.md)                 | -                                                                                                           |
 | [ResourcePermission](./docs/api/appkit/TypeAlias.ResourcePermission.md) | Union of all possible permission levels across all resource types.                                          |
 | [ToPlugin](./docs/api/appkit/TypeAlias.ToPlugin.md)                     | -                                                                                                           |