@databricks/appkit 0.26.1 → 0.27.1

package/CLAUDE.md

@@ -48,6 +48,7 @@ npx @databricks/appkit docs <query>
 - [Execution context](./docs/plugins/execution-context.md): AppKit manages Databricks authentication via two contexts:
 - [Files plugin](./docs/plugins/files.md): File operations against Databricks Unity Catalog Volumes. Supports listing, reading, downloading, uploading, deleting, and previewing files with built-in caching, retry, and timeout handling via the execution interceptor pipeline.
 - [Genie plugin](./docs/plugins/genie.md): Integrates Databricks AI/BI Genie spaces into your AppKit application, enabling natural language data queries via a conversational interface.
+- [Jobs plugin](./docs/plugins/jobs.md): Trigger and monitor Databricks Lakeflow Jobs from your AppKit application.
 - [Lakebase plugin](./docs/plugins/lakebase.md): Provides a PostgreSQL connection pool for Databricks Lakebase Autoscaling with automatic OAuth token refresh.
 - [Model Serving plugin](./docs/plugins/model-serving.md): Provides an authenticated proxy to Databricks Model Serving endpoints, with invoke and streaming support.
 - [Plugin management](./docs/plugins/plugin-management.md): AppKit includes a CLI for managing plugins. All commands are available under npx @databricks/appkit plugin.
@@ -93,7 +94,11 @@ npx @databricks/appkit docs <query>
 - [Interface: FilePolicyUser](./docs/api/appkit/Interface.FilePolicyUser.md): Minimal user identity passed to the policy function.
 - [Interface: FileResource](./docs/api/appkit/Interface.FileResource.md): Describes the file or directory being acted upon.
 - [Interface: GenerateDatabaseCredentialRequest](./docs/api/appkit/Interface.GenerateDatabaseCredentialRequest.md): Request parameters for generating database OAuth credentials
+- [Interface: IJobsConfig](./docs/api/appkit/Interface.IJobsConfig.md): Configuration for the Jobs plugin.
 - [Interface: ITelemetry](./docs/api/appkit/Interface.ITelemetry.md): Plugin-facing interface for OpenTelemetry instrumentation.
+- [Interface: JobAPI](./docs/api/appkit/Interface.JobAPI.md): User-facing API for a single configured job.
+- [Interface: JobConfig](./docs/api/appkit/Interface.JobConfig.md): Per-job configuration options.
+- [Interface: JobsConnectorConfig](./docs/api/appkit/Interface.JobsConnectorConfig.md): Properties
 - [Interface: LakebasePoolConfig](./docs/api/appkit/Interface.LakebasePoolConfig.md): Configuration for creating a Lakebase connection pool
 - [Interface: PluginManifest<TName>](./docs/api/appkit/Interface.PluginManifest.md): Plugin manifest that declares metadata and resource requirements.
 - [Interface: RequestedClaims](./docs/api/appkit/Interface.RequestedClaims.md): Optional claims for fine-grained Unity Catalog table permissions
@@ -111,6 +116,8 @@ npx @databricks/appkit docs <query>
 - [Type Alias: FileAction](./docs/api/appkit/TypeAlias.FileAction.md): Every action the files plugin can perform.
 - [Type Alias: FilePolicy()](./docs/api/appkit/TypeAlias.FilePolicy.md): A policy function that decides whether user may perform action on
 - [Type Alias: IAppRouter](./docs/api/appkit/TypeAlias.IAppRouter.md): Express router type for plugin route registration
+- [Type Alias: JobHandle](./docs/api/appkit/TypeAlias.JobHandle.md): Job handle returned by appkit.jobs("etl").
+- [Type Alias: JobsExport()](./docs/api/appkit/TypeAlias.JobsExport.md): Public API shape of the jobs plugin.
 - [Type Alias: PluginData<T, U, N>](./docs/api/appkit/TypeAlias.PluginData.md): Tuple of plugin class, config, and name. Created by toPlugin() and passed to createApp().
 - [Type Alias: ResourcePermission](./docs/api/appkit/TypeAlias.ResourcePermission.md): Union of all possible permission levels across all resource types.
 - [Type Alias: ServingFactory](./docs/api/appkit/TypeAlias.ServingFactory.md): Factory function returned by AppKit.serving.

package/NOTICE.md

@@ -79,4 +79,5 @@ This Software contains code from the following open source projects:
 | [tailwind-merge](https://www.npmjs.com/package/tailwind-merge) | 3.4.0 | MIT | https://github.com/dcastil/tailwind-merge |
 | [vaul](https://www.npmjs.com/package/vaul) | 1.1.2 | MIT | https://vaul.emilkowal.ski/ |
 | [ws](https://www.npmjs.com/package/ws) | 7.5.10, 8.18.3 | MIT | https://github.com/websockets/ws |
+| [zod](https://www.npmjs.com/package/zod) | 4.3.6 | MIT | https://zod.dev |
 

package/dist/appkit/package.js

@@ -1,6 +1,6 @@
 //#region package.json
 var name = "@databricks/appkit";
-var version = "0.26.1";
+var version = "0.27.1";
 
 //#endregion
 export { name, version };

package/dist/connectors/index.js

@@ -4,6 +4,8 @@ import { FilesConnector } from "./files/client.js";
 import "./files/index.js";
 import { GenieConnector } from "./genie/client.js";
 import "./genie/index.js";
+import { JobsConnector } from "./jobs/client.js";
+import "./jobs/index.js";
 import "./lakebase-v1/index.js";
 import { SQLWarehouseConnector } from "./sql-warehouse/client.js";
 import "./sql-warehouse/index.js";

package/dist/connectors/jobs/client.d.ts

@@ -0,0 +1,2 @@
+import "./types.js";
+import { WorkspaceClient, jobs } from "@databricks/sdk-experimental";

package/dist/connectors/jobs/client.js

@@ -0,0 +1,132 @@
+import { createLogger } from "../../logging/logger.js";
+import { AppKitError } from "../../errors/base.js";
+import { ExecutionError } from "../../errors/execution.js";
+import { init_errors } from "../../errors/index.js";
+import { TelemetryManager } from "../../telemetry/telemetry-manager.js";
+import { SpanKind, SpanStatusCode } from "../../telemetry/index.js";
+import { Context } from "@databricks/sdk-experimental";
+
+//#region src/connectors/jobs/client.ts
+init_errors();
+const logger = createLogger("connectors:jobs");
+var JobsConnector = class {
+	name = "jobs";
+	config;
+	telemetry;
+	telemetryMetrics;
+	constructor(config) {
+		this.config = config;
+		this.telemetry = TelemetryManager.getProvider(this.name, this.config.telemetry);
+		this.telemetryMetrics = {
+			apiCallCount: this.telemetry.getMeter().createCounter("jobs.api_call.count", {
+				description: "Total number of Jobs API calls",
+				unit: "1"
+			}),
+			apiCallDuration: this.telemetry.getMeter().createHistogram("jobs.api_call.duration", {
+				description: "Duration of Jobs API calls",
+				unit: "ms"
+			})
+		};
+	}
+	async submitRun(workspaceClient, request, signal) {
+		return this._callApi("submit", async () => {
+			return workspaceClient.jobs.submit(request, this._createContext(signal));
+		});
+	}
+	async runNow(workspaceClient, request, signal) {
+		return this._callApi("runNow", async () => {
+			return workspaceClient.jobs.runNow(request, this._createContext(signal));
+		});
+	}
+	async getRun(workspaceClient, request, signal) {
+		return this._callApi("getRun", async () => {
+			return workspaceClient.jobs.getRun(request, this._createContext(signal));
+		});
+	}
+	async getRunOutput(workspaceClient, request, signal) {
+		return this._callApi("getRunOutput", async () => {
+			return workspaceClient.jobs.getRunOutput(request, this._createContext(signal));
+		});
+	}
+	async cancelRun(workspaceClient, request, signal) {
+		await this._callApi("cancelRun", async () => {
+			return workspaceClient.jobs.cancelRun(request, this._createContext(signal));
+		});
+	}
+	async listRuns(workspaceClient, request, signal) {
+		return this._callApi("listRuns", async () => {
+			const runs = [];
+			const limit = Math.max(1, Math.min(request.limit ?? 100, 100));
+			for await (const run of workspaceClient.jobs.listRuns({
+				...request,
+				limit
+			}, this._createContext(signal))) {
+				runs.push(run);
+				if (runs.length >= limit) break;
+			}
+			return runs;
+		});
+	}
+	async getJob(workspaceClient, request, signal) {
+		return this._callApi("getJob", async () => {
+			return workspaceClient.jobs.get(request, this._createContext(signal));
+		});
+	}
+	async _callApi(operation, fn) {
+		const startTime = Date.now();
+		let success = false;
+		return this.telemetry.startActiveSpan(`jobs.${operation}`, {
+			kind: SpanKind.CLIENT,
+			attributes: { "jobs.operation": operation }
+		}, async (span) => {
+			try {
+				const result = await fn();
+				success = true;
+				span.setStatus({ code: SpanStatusCode.OK });
+				return result;
+			} catch (error) {
+				span.recordException(error);
+				span.setStatus({
+					code: SpanStatusCode.ERROR,
+					message: error instanceof Error ? error.message : String(error)
+				});
+				if (error instanceof AppKitError) throw error;
+				if (error instanceof Error && "statusCode" in error && typeof error.statusCode === "number") throw error;
+				throw new ExecutionError(`Jobs API call failed: ${error instanceof Error ? error.message : String(error)}`);
+			} finally {
+				const duration = Date.now() - startTime;
+				span.end();
+				this.telemetryMetrics.apiCallCount.add(1, {
+					operation,
+					success: success.toString()
+				});
+				this.telemetryMetrics.apiCallDuration.record(duration, {
+					operation,
+					success: success.toString()
+				});
+				logger.event()?.setContext("jobs", {
+					operation,
+					duration_ms: duration,
+					success
+				});
+			}
+		}, {
+			name: this.name,
+			includePrefix: true
+		});
+	}
+	_createContext(signal) {
+		return new Context({ cancellationToken: {
+			get isCancellationRequested() {
+				return signal?.aborted ?? false;
+			},
+			onCancellationRequested: (cb) => {
+				signal?.addEventListener("abort", cb, { once: true });
+			}
+		} });
+	}
+};
+
+//#endregion
+export { JobsConnector };
+//# sourceMappingURL=client.js.map

package/dist/connectors/jobs/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../../../src/connectors/jobs/client.ts"],"sourcesContent":["import {\n  Context,\n  type jobs,\n  type WorkspaceClient,\n} from \"@databricks/sdk-experimental\";\nimport { AppKitError, ExecutionError } from \"../../errors\";\nimport { createLogger } from \"../../logging/logger\";\nimport type { TelemetryProvider } from \"../../telemetry\";\nimport {\n  type Counter,\n  type Histogram,\n  type Span,\n  SpanKind,\n  SpanStatusCode,\n  TelemetryManager,\n} from \"../../telemetry\";\nimport type { JobsConnectorConfig } from \"./types\";\n\nconst logger = createLogger(\"connectors:jobs\");\n\nexport class JobsConnector {\n  private readonly name = \"jobs\";\n  private readonly config: JobsConnectorConfig;\n  private readonly telemetry: TelemetryProvider;\n  private readonly telemetryMetrics: {\n    apiCallCount: Counter;\n    apiCallDuration: Histogram;\n  };\n\n  constructor(config: JobsConnectorConfig) {\n    this.config = config;\n    this.telemetry = TelemetryManager.getProvider(\n      this.name,\n      this.config.telemetry,\n    );\n    this.telemetryMetrics = {\n      apiCallCount: this.telemetry\n        .getMeter()\n        .createCounter(\"jobs.api_call.count\", {\n          description: \"Total number of Jobs API calls\",\n          unit: \"1\",\n        }),\n      apiCallDuration: this.telemetry\n        .getMeter()\n        .createHistogram(\"jobs.api_call.duration\", {\n          description: \"Duration of Jobs API calls\",\n          unit: \"ms\",\n        }),\n    };\n  }\n\n  async submitRun(\n    workspaceClient: WorkspaceClient,\n    request: jobs.SubmitRun,\n    signal?: AbortSignal,\n  ): Promise<jobs.SubmitRunResponse> {\n    return this._callApi(\"submit\", async () => {\n      return workspaceClient.jobs.submit(request, this._createContext(signal));\n    });\n  }\n\n  async runNow(\n    workspaceClient: WorkspaceClient,\n    request: jobs.RunNow,\n    signal?: AbortSignal,\n  ): Promise<jobs.RunNowResponse> {\n    return this._callApi(\"runNow\", async () => {\n      return workspaceClient.jobs.runNow(request, this._createContext(signal));\n    });\n  }\n\n  async getRun(\n    workspaceClient: WorkspaceClient,\n    request: jobs.GetRunRequest,\n    signal?: AbortSignal,\n  ): Promise<jobs.Run> {\n    return this._callApi(\"getRun\", async () => {\n      return workspaceClient.jobs.getRun(request, this._createContext(signal));\n    });\n  }\n\n  async getRunOutput(\n    workspaceClient: WorkspaceClient,\n    request: jobs.GetRunOutputRequest,\n    signal?: AbortSignal,\n  ): Promise<jobs.RunOutput> {\n    return this._callApi(\"getRunOutput\", async () => {\n      return workspaceClient.jobs.getRunOutput(\n        request,\n        this._createContext(signal),\n      );\n    });\n  }\n\n  async cancelRun(\n    workspaceClient: WorkspaceClient,\n    request: jobs.CancelRun,\n    signal?: AbortSignal,\n  ): Promise<void> {\n    await this._callApi(\"cancelRun\", async () => {\n      return workspaceClient.jobs.cancelRun(\n        request,\n        this._createContext(signal),\n      );\n    });\n  }\n\n  async listRuns(\n    workspaceClient: WorkspaceClient,\n    request: jobs.ListRunsRequest,\n    signal?: AbortSignal,\n  ): Promise<jobs.BaseRun[]> {\n    return this._callApi(\"listRuns\", async () => {\n      const runs: jobs.BaseRun[] = [];\n      const limit = Math.max(1, Math.min(request.limit ?? 100, 100));\n      for await (const run of workspaceClient.jobs.listRuns(\n        { ...request, limit },\n        this._createContext(signal),\n      )) {\n        runs.push(run);\n        if (runs.length >= limit) break;\n      }\n      return runs;\n    });\n  }\n\n  async getJob(\n    workspaceClient: WorkspaceClient,\n    request: jobs.GetJobRequest,\n    signal?: AbortSignal,\n  ): Promise<jobs.Job> {\n    return this._callApi(\"getJob\", async () => {\n      return workspaceClient.jobs.get(request, this._createContext(signal));\n    });\n  }\n\n  private async _callApi<T>(\n    operation: string,\n    fn: () => Promise<T>,\n  ): Promise<T> {\n    const startTime = Date.now();\n    let success = false;\n\n    return this.telemetry.startActiveSpan(\n      `jobs.${operation}`,\n      {\n        kind: SpanKind.CLIENT,\n        attributes: {\n          \"jobs.operation\": operation,\n        },\n      },\n      async (span: Span) => {\n        try {\n          const result = await fn();\n          success = true;\n          span.setStatus({ code: SpanStatusCode.OK });\n          return result;\n        } catch (error) {\n          span.recordException(error as Error);\n          span.setStatus({\n            code: SpanStatusCode.ERROR,\n            message: error instanceof Error ? error.message : String(error),\n          });\n          if (error instanceof AppKitError) {\n            throw error;\n          }\n          // Preserve SDK ApiError (and any error with a numeric statusCode)\n          // so Plugin.execute() can map it to the correct HTTP status.\n          if (\n            error instanceof Error &&\n            \"statusCode\" in error &&\n            typeof (error as Record<string, unknown>).statusCode === \"number\"\n          ) {\n            throw error;\n          }\n          throw new ExecutionError(\n            `Jobs API call failed: ${error instanceof Error ? error.message : String(error)}`,\n          );\n        } finally {\n          const duration = Date.now() - startTime;\n          span.end();\n          this.telemetryMetrics.apiCallCount.add(1, {\n            operation,\n            success: success.toString(),\n          });\n          this.telemetryMetrics.apiCallDuration.record(duration, {\n            operation,\n            success: success.toString(),\n          });\n\n          logger.event()?.setContext(\"jobs\", {\n            operation,\n            duration_ms: duration,\n            success,\n          });\n        }\n      },\n      { name: this.name, includePrefix: true },\n    );\n  }\n\n  private _createContext(signal?: AbortSignal) {\n    return new Context({\n      cancellationToken: {\n        // Getter — evaluated on every read so SDK code paths that poll\n        // (rather than subscribe) observe cancellation live.\n        get isCancellationRequested() {\n          return signal?.aborted ?? false;\n        },\n        onCancellationRequested: (cb: () => void) => {\n          signal?.addEventListener(\"abort\", cb, { once: true });\n        },\n      },\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/connectors/jobs/index.d.ts

@@ -0,0 +1,2 @@
+import { JobsConnectorConfig } from "./types.js";
+import "./client.js";

package/dist/connectors/jobs/index.js

@@ -0,0 +1,3 @@
+import { JobsConnector } from "./client.js";
+
+export {  };

package/dist/connectors/jobs/types.d.ts

@@ -0,0 +1,10 @@
+import { TelemetryOptions } from "../../shared/src/plugin.js";
+import "../../shared/src/index.js";
+
+//#region src/connectors/jobs/types.d.ts
+interface JobsConnectorConfig {
+  telemetry?: TelemetryOptions;
+}
+//#endregion
+export { JobsConnectorConfig };
+//# sourceMappingURL=types.d.ts.map

package/dist/connectors/jobs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/connectors/jobs/types.ts"],"mappings":";;;;UAEiB,mBAAA;EACf,SAAA,GAAY,gBAAA;AAAA"}

package/dist/index.d.ts

@@ -5,6 +5,8 @@ import { StreamExecutionSettings } from "./shared/src/execute.js";
 import { isSQLTypeMarker, sql } from "./shared/src/sql/helpers.js";
 import "./shared/src/index.js";
 import { CacheManager } from "./cache/index.js";
+import { JobsConnectorConfig } from "./connectors/jobs/types.js";
+import "./connectors/jobs/index.js";
 import { DatabaseCredential, GenerateDatabaseCredentialRequest, LakebasePoolConfig, RequestedClaims, RequestedClaimsPermissionSet, RequestedResource, createLakebasePool, generateDatabaseCredential, getLakebaseOrmConfig, getLakebasePgConfig, getUsernameWithApiLookup, getWorkspaceClient } from "./connectors/lakebase/index.js";
 import { getExecutionContext } from "./context/execution-context.js";
 import "./context/index.js";
@@ -34,6 +36,9 @@ import { analytics } from "./plugins/analytics/analytics.js";
 import { FileAction, FilePolicy, FilePolicyUser, FileResource, PolicyDeniedError, READ_ACTIONS, WRITE_ACTIONS } from "./plugins/files/policy.js";
 import { files } from "./plugins/files/plugin.js";
 import { genie } from "./plugins/genie/genie.js";
+import { IJobsConfig, JobAPI, JobConfig, JobHandle, JobsExport } from "./plugins/jobs/types.js";
+import { jobs } from "./plugins/jobs/plugin.js";
+import "./plugins/jobs/index.js";
 import { lakebase } from "./plugins/lakebase/lakebase.js";
 import { server } from "./plugins/server/index.js";
 import { EndpointConfig, ServingEndpointEntry, ServingEndpointRegistry, ServingFactory } from "./plugins/serving/types.js";
@@ -42,4 +47,4 @@ import "./plugins/index.js";
 import { extractServingEndpoints, findServerFile } from "./type-generator/serving/server-file-extractor.js";
 import { appKitServingTypesPlugin } from "./type-generator/serving/vite-plugin.js";
 import { appKitTypesPlugin } from "./type-generator/vite-plugin.js";
-export { AppKitError, AuthenticationError, type BasePluginConfig, type CacheConfig, CacheManager, type ConfigSchema, ConfigurationError, ConnectionError, type Counter, type DatabaseCredential, type EndpointConfig, ExecutionError, type ExecutionResult, type FileAction, type FilePolicy, type FilePolicyUser, type FileResource, type GenerateDatabaseCredentialRequest, type Histogram, type IAppRouter, type ITelemetry, InitializationError, type LakebasePoolConfig, Plugin, type PluginData, type PluginManifest, PolicyDeniedError, READ_ACTIONS, type RequestedClaims, RequestedClaimsPermissionSet, type RequestedResource, type ResourceEntry, type ResourceFieldEntry, type ResourcePermission, ResourceRegistry, type ResourceRequirement, ResourceType, ServerError, type ServingEndpointEntry, type ServingEndpointRegistry, type ServingFactory, SeverityNumber, type Span, SpanStatusCode, type StreamExecutionSettings, type TelemetryConfig, type ToPlugin, TunnelError, ValidationError, type ValidationResult, WRITE_ACTIONS, analytics, appKitServingTypesPlugin, appKitTypesPlugin, createApp, createLakebasePool, extractServingEndpoints, files, findServerFile, generateDatabaseCredential, genie, getExecutionContext, getLakebaseOrmConfig, getLakebasePgConfig, getPluginManifest, getResourceRequirements, getUsernameWithApiLookup, getWorkspaceClient, isSQLTypeMarker, lakebase, server, serving, sql, toPlugin };
+export { AppKitError, AuthenticationError, type BasePluginConfig, type CacheConfig, CacheManager, type ConfigSchema, ConfigurationError, ConnectionError, type Counter, type DatabaseCredential, type EndpointConfig, ExecutionError, type ExecutionResult, type FileAction, type FilePolicy, type FilePolicyUser, type FileResource, type GenerateDatabaseCredentialRequest, type Histogram, type IAppRouter, type IJobsConfig, type ITelemetry, InitializationError, type JobAPI, type JobConfig, type JobHandle, type JobsConnectorConfig, type JobsExport, type LakebasePoolConfig, Plugin, type PluginData, type PluginManifest, PolicyDeniedError, READ_ACTIONS, type RequestedClaims, RequestedClaimsPermissionSet, type RequestedResource, type ResourceEntry, type ResourceFieldEntry, type ResourcePermission, ResourceRegistry, type ResourceRequirement, ResourceType, ServerError, type ServingEndpointEntry, type ServingEndpointRegistry, type ServingFactory, SeverityNumber, type Span, SpanStatusCode, type StreamExecutionSettings, type TelemetryConfig, type ToPlugin, TunnelError, ValidationError, type ValidationResult, WRITE_ACTIONS, analytics, appKitServingTypesPlugin, appKitTypesPlugin, createApp, createLakebasePool, extractServingEndpoints, files, findServerFile, generateDatabaseCredential, genie, getExecutionContext, getLakebaseOrmConfig, getLakebasePgConfig, getPluginManifest, getResourceRequirements, getUsernameWithApiLookup, getWorkspaceClient, isSQLTypeMarker, jobs, lakebase, server, serving, sql, toPlugin };

package/dist/index.js

@@ -27,6 +27,7 @@ import { analytics } from "./plugins/analytics/analytics.js";
 import { PolicyDeniedError, READ_ACTIONS, WRITE_ACTIONS } from "./plugins/files/policy.js";
 import { files } from "./plugins/files/plugin.js";
 import { genie } from "./plugins/genie/genie.js";
+import { jobs } from "./plugins/jobs/plugin.js";
 import { lakebase } from "./plugins/lakebase/lakebase.js";
 import { extractServingEndpoints, findServerFile } from "./type-generator/serving/server-file-extractor.js";
 import { appKitServingTypesPlugin } from "./type-generator/serving/vite-plugin.js";
@@ -40,5 +41,5 @@ init_context();
 init_errors();
 
 //#endregion
-export { AppKitError, AuthenticationError, CacheManager, ConfigurationError, ConnectionError, ExecutionError, InitializationError, Plugin, PolicyDeniedError, READ_ACTIONS, RequestedClaimsPermissionSet, ResourceRegistry, ResourceType, ServerError, SeverityNumber, SpanStatusCode, TunnelError, ValidationError, WRITE_ACTIONS, analytics, appKitServingTypesPlugin, appKitTypesPlugin, createApp, createLakebasePool, extractServingEndpoints, files, findServerFile, generateDatabaseCredential, genie, getExecutionContext, getLakebaseOrmConfig, getLakebasePgConfig, getPluginManifest, getResourceRequirements, getUsernameWithApiLookup, getWorkspaceClient, isSQLTypeMarker, lakebase, server, serving, sql, toPlugin };
+export { AppKitError, AuthenticationError, CacheManager, ConfigurationError, ConnectionError, ExecutionError, InitializationError, Plugin, PolicyDeniedError, READ_ACTIONS, RequestedClaimsPermissionSet, ResourceRegistry, ResourceType, ServerError, SeverityNumber, SpanStatusCode, TunnelError, ValidationError, WRITE_ACTIONS, analytics, appKitServingTypesPlugin, appKitTypesPlugin, createApp, createLakebasePool, extractServingEndpoints, files, findServerFile, generateDatabaseCredential, genie, getExecutionContext, getLakebaseOrmConfig, getLakebasePgConfig, getPluginManifest, getResourceRequirements, getUsernameWithApiLookup, getWorkspaceClient, isSQLTypeMarker, jobs, lakebase, server, serving, sql, toPlugin };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * Core library for building Databricks applications with type-safe SQL queries,\n * plugin architecture, and React integration.\n */\n\n// Types from shared\nexport type {\n  BasePluginConfig,\n  CacheConfig,\n  IAppRouter,\n  PluginData,\n  StreamExecutionSettings,\n} from \"shared\";\nexport { isSQLTypeMarker, sql } from \"shared\";\nexport { CacheManager } from \"./cache\";\nexport type {\n  DatabaseCredential,\n  GenerateDatabaseCredentialRequest,\n  LakebasePoolConfig,\n  RequestedClaims,\n  RequestedResource,\n} from \"./connectors/lakebase\";\n// Lakebase Autoscaling connector\nexport {\n  createLakebasePool,\n  generateDatabaseCredential,\n  getLakebaseOrmConfig,\n  getLakebasePgConfig,\n  getUsernameWithApiLookup,\n  getWorkspaceClient,\n  RequestedClaimsPermissionSet,\n} from \"./connectors/lakebase\";\nexport { getExecutionContext } from \"./context\";\nexport { createApp } from \"./core\";\n// Errors\nexport {\n  AppKitError,\n  AuthenticationError,\n  ConfigurationError,\n  ConnectionError,\n  ExecutionError,\n  InitializationError,\n  ServerError,\n  TunnelError,\n  ValidationError,\n} from \"./errors\";\n// Plugin authoring\nexport {\n  type ExecutionResult,\n  Plugin,\n  type ToPlugin,\n  toPlugin,\n} from \"./plugin\";\nexport { analytics, files, genie, lakebase, server, serving } from \"./plugins\";\n// Files plugin types (for custom policy authoring)\nexport type {\n  FileAction,\n  FilePolicy,\n  FilePolicyUser,\n  FileResource,\n} from \"./plugins/files/policy\";\nexport {\n  PolicyDeniedError,\n  READ_ACTIONS,\n  WRITE_ACTIONS,\n} from \"./plugins/files/policy\";\nexport type {\n  EndpointConfig,\n  ServingEndpointEntry,\n  ServingEndpointRegistry,\n  ServingFactory,\n} from \"./plugins/serving/types\";\n// Registry types and utilities for plugin manifests\nexport type {\n  ConfigSchema,\n  PluginManifest,\n  ResourceEntry,\n  ResourceFieldEntry,\n  ResourcePermission,\n  ResourceRequirement,\n  ValidationResult,\n} from \"./registry\";\nexport {\n  getPluginManifest,\n  getResourceRequirements,\n  ResourceRegistry,\n  ResourceType,\n} from \"./registry\";\n// Telemetry (for advanced custom telemetry)\nexport {\n  type Counter,\n  type Histogram,\n  type ITelemetry,\n  SeverityNumber,\n  type Span,\n  SpanStatusCode,\n  type TelemetryConfig,\n} from \"./telemetry\";\nexport {\n  extractServingEndpoints,\n  findServerFile,\n} from \"./type-generator/serving/server-file-extractor\";\nexport { appKitServingTypesPlugin } from \"./type-generator/serving/vite-plugin\";\n// Vite plugin and type generation\nexport { appKitTypesPlugin } from \"./type-generator/vite-plugin\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkCgD;aAa9B"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * Core library for building Databricks applications with type-safe SQL queries,\n * plugin architecture, and React integration.\n */\n\n// Types from shared\nexport type {\n  BasePluginConfig,\n  CacheConfig,\n  IAppRouter,\n  PluginData,\n  StreamExecutionSettings,\n} from \"shared\";\nexport { isSQLTypeMarker, sql } from \"shared\";\nexport { CacheManager } from \"./cache\";\nexport type { JobsConnectorConfig } from \"./connectors/jobs\";\nexport type {\n  DatabaseCredential,\n  GenerateDatabaseCredentialRequest,\n  LakebasePoolConfig,\n  RequestedClaims,\n  RequestedResource,\n} from \"./connectors/lakebase\";\n// Lakebase Autoscaling connector\nexport {\n  createLakebasePool,\n  generateDatabaseCredential,\n  getLakebaseOrmConfig,\n  getLakebasePgConfig,\n  getUsernameWithApiLookup,\n  getWorkspaceClient,\n  RequestedClaimsPermissionSet,\n} from \"./connectors/lakebase\";\nexport { getExecutionContext } from \"./context\";\nexport { createApp } from \"./core\";\n// Errors\nexport {\n  AppKitError,\n  AuthenticationError,\n  ConfigurationError,\n  ConnectionError,\n  ExecutionError,\n  InitializationError,\n  ServerError,\n  TunnelError,\n  ValidationError,\n} from \"./errors\";\n// Plugin authoring\nexport {\n  type ExecutionResult,\n  Plugin,\n  type ToPlugin,\n  toPlugin,\n} from \"./plugin\";\nexport {\n  analytics,\n  files,\n  genie,\n  jobs,\n  lakebase,\n  server,\n  serving,\n} from \"./plugins\";\n// Files plugin types (for custom policy authoring)\nexport type {\n  FileAction,\n  FilePolicy,\n  FilePolicyUser,\n  FileResource,\n} from \"./plugins/files/policy\";\nexport {\n  PolicyDeniedError,\n  READ_ACTIONS,\n  WRITE_ACTIONS,\n} from \"./plugins/files/policy\";\nexport type {\n  IJobsConfig,\n  JobAPI,\n  JobConfig,\n  JobHandle,\n  JobsExport,\n} from \"./plugins/jobs\";\nexport type {\n  EndpointConfig,\n  ServingEndpointEntry,\n  ServingEndpointRegistry,\n  ServingFactory,\n} from \"./plugins/serving/types\";\n// Registry types and utilities for plugin manifests\nexport type {\n  ConfigSchema,\n  PluginManifest,\n  ResourceEntry,\n  ResourceFieldEntry,\n  ResourcePermission,\n  ResourceRequirement,\n  ValidationResult,\n} from \"./registry\";\nexport {\n  getPluginManifest,\n  getResourceRequirements,\n  ResourceRegistry,\n  ResourceType,\n} from \"./registry\";\n// Telemetry (for advanced custom telemetry)\nexport {\n  type Counter,\n  type Histogram,\n  type ITelemetry,\n  SeverityNumber,\n  type Span,\n  SpanStatusCode,\n  type TelemetryConfig,\n} from \"./telemetry\";\nexport {\n  extractServingEndpoints,\n  findServerFile,\n} from \"./type-generator/serving/server-file-extractor\";\nexport { appKitServingTypesPlugin } from \"./type-generator/serving/vite-plugin\";\n// Vite plugin and type generation\nexport { appKitTypesPlugin } from \"./type-generator/vite-plugin\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmCgD;aAa9B"}

package/dist/plugins/index.d.ts

@@ -9,6 +9,9 @@ import { GenieConversationHistoryResponse } from "../connectors/genie/types.js";
 import { IGenieConfig } from "./genie/types.js";
 import { GeniePlugin, genie } from "./genie/genie.js";
 import "./genie/index.js";
+import { IJobsConfig, JobAPI, JobConfig, JobHandle, JobsExport } from "./jobs/types.js";
+import { jobs } from "./jobs/plugin.js";
+import "./jobs/index.js";
 import { ILakebaseConfig } from "./lakebase/types.js";
 import { lakebase } from "./lakebase/lakebase.js";
 import "./lakebase/index.js";

package/dist/plugins/index.js

@@ -5,6 +5,8 @@ import { FilesPlugin, files } from "./files/plugin.js";
 import "./files/index.js";
 import { GeniePlugin, genie } from "./genie/genie.js";
 import "./genie/index.js";
+import { jobs } from "./jobs/plugin.js";
+import "./jobs/index.js";
 import { lakebase } from "./lakebase/lakebase.js";
 import "./lakebase/index.js";
 import { ServerPlugin, server } from "./server/index.js";

package/dist/plugins/jobs/defaults.js

@@ -0,0 +1,45 @@
+//#region src/plugins/jobs/defaults.ts
+/**
+* Execution defaults for read-tier operations (getRun, getJob, listRuns, lastRun, getRunOutput).
+* Cache 60s (ttl in seconds)
+* Retry 3x with 1s backoff
+* Timeout 30s
+*/
+const JOBS_READ_DEFAULTS = {
+	cache: {
+		enabled: true,
+		ttl: 60
+	},
+	retry: {
+		enabled: true,
+		initialDelay: 1e3,
+		attempts: 3
+	},
+	timeout: 3e4
+};
+/**
+* Execution defaults for write-tier operations (runNow, cancelRun).
+* No cache
+* No retry
+* Timeout 120s
+*/
+const JOBS_WRITE_DEFAULTS = {
+	cache: { enabled: false },
+	retry: { enabled: false },
+	timeout: 12e4
+};
+/**
+* Execution defaults for stream-tier operations (runNowAndWait with polling).
+* No cache
+* No retry
+* Timeout 600s
+*/
+const JOBS_STREAM_DEFAULTS = {
+	cache: { enabled: false },
+	retry: { enabled: false },
+	timeout: 6e5
+};
+
+//#endregion
+export { JOBS_READ_DEFAULTS, JOBS_STREAM_DEFAULTS, JOBS_WRITE_DEFAULTS };
+//# sourceMappingURL=defaults.js.map

package/dist/plugins/jobs/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","names":[],"sources":["../../../src/plugins/jobs/defaults.ts"],"sourcesContent":["import type { PluginExecuteConfig } from \"shared\";\n\n/**\n * Execution defaults for read-tier operations (getRun, getJob, listRuns, lastRun, getRunOutput).\n * Cache 60s (ttl in seconds)\n * Retry 3x with 1s backoff\n * Timeout 30s\n */\nexport const JOBS_READ_DEFAULTS: PluginExecuteConfig = {\n  cache: { enabled: true, ttl: 60 },\n  retry: { enabled: true, initialDelay: 1000, attempts: 3 },\n  timeout: 30_000,\n};\n\n/**\n * Execution defaults for write-tier operations (runNow, cancelRun).\n * No cache\n * No retry\n * Timeout 120s\n */\nexport const JOBS_WRITE_DEFAULTS: PluginExecuteConfig = {\n  cache: { enabled: false },\n  retry: { enabled: false },\n  timeout: 120_000,\n};\n\n/**\n * Execution defaults for stream-tier operations (runNowAndWait with polling).\n * No cache\n * No retry\n * Timeout 600s\n */\nexport const JOBS_STREAM_DEFAULTS: PluginExecuteConfig = {\n  cache: { enabled: false },\n  retry: { enabled: false },\n  timeout: 600_000,\n};\n"],"mappings":";;;;;;;AAQA,MAAa,qBAA0C;CACrD,OAAO;EAAE,SAAS;EAAM,KAAK;EAAI;CACjC,OAAO;EAAE,SAAS;EAAM,cAAc;EAAM,UAAU;EAAG;CACzD,SAAS;CACV;;;;;;;AAQD,MAAa,sBAA2C;CACtD,OAAO,EAAE,SAAS,OAAO;CACzB,OAAO,EAAE,SAAS,OAAO;CACzB,SAAS;CACV;;;;;;;AAQD,MAAa,uBAA4C;CACvD,OAAO,EAAE,SAAS,OAAO;CACzB,OAAO,EAAE,SAAS,OAAO;CACzB,SAAS;CACV"}

package/dist/plugins/jobs/index.d.ts

@@ -0,0 +1,2 @@
+import { IJobsConfig, JobAPI, JobConfig, JobHandle, JobsExport } from "./types.js";
+import { jobs } from "./plugin.js";

package/dist/plugins/jobs/index.js

@@ -0,0 +1,3 @@
+import { jobs } from "./plugin.js";
+
+export {  };

package/dist/plugins/jobs/manifest.js

@@ -0,0 +1,40 @@
+//#region src/plugins/jobs/manifest.json
+var manifest_default = {
+	$schema: "https://databricks.github.io/appkit/schemas/plugin-manifest.schema.json",
+	name: "jobs",
+	displayName: "Jobs Plugin",
+	description: "Manage Databricks Lakeflow Jobs.",
+	resources: {
+		"required": [{
+			"type": "job",
+			"alias": "Job",
+			"resourceKey": "job",
+			"description": "A Databricks job to trigger and monitor",
+			"permission": "CAN_MANAGE_RUN",
+			"fields": { "id": {
+				"env": "DATABRICKS_JOB_ID",
+				"description": "Numeric Databricks job ID. Find it in the Jobs UI or via `databricks jobs list`."
+			} }
+		}],
+		"optional": []
+	},
+	config: { "schema": {
+		"type": "object",
+		"properties": {
+			"timeout": {
+				"type": "number",
+				"default": 6e4,
+				"description": "Default timeout for Jobs API calls in milliseconds"
+			},
+			"pollIntervalMs": {
+				"type": "number",
+				"default": 5e3,
+				"description": "Poll interval for waiting on run completion in milliseconds"
+			}
+		}
+	} }
+};
+
+//#endregion
+export { manifest_default as default };
+//# sourceMappingURL=manifest.js.map

package/dist/plugins/jobs/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","names":[],"sources":["../../../src/plugins/jobs/manifest.json"],"sourcesContent":[""],"mappings":""}

package/dist/plugins/jobs/params.js

@@ -0,0 +1,35 @@
+//#region src/plugins/jobs/params.ts
+/** Throw if any value is not a string, number, or boolean. */
+function assertPrimitiveValues(params) {
+	for (const [k, v] of Object.entries(params)) if (v !== null && v !== void 0 && typeof v === "object") throw new Error(`Parameter "${k}" must be a primitive value, got ${Array.isArray(v) ? "array" : "object"}`);
+}
+/**
+* Maps validated parameters to SDK request fields based on the task type.
+* This is a pure function — stateless and testable in isolation.
+*/
+function mapParams(taskType, params) {
+	switch (taskType) {
+		case "notebook":
+			assertPrimitiveValues(params);
+			return { notebook_params: Object.fromEntries(Object.entries(params).map(([k, v]) => [k, String(v)])) };
+		case "python_wheel":
+			assertPrimitiveValues(params);
+			return { python_named_params: Object.fromEntries(Object.entries(params).map(([k, v]) => [k, String(v)])) };
+		case "python_script": return { python_params: Array.isArray(params.args) ? params.args.map(String) : [] };
+		case "spark_jar": return { jar_params: Array.isArray(params.args) ? params.args.map(String) : [] };
+		case "sql":
+			assertPrimitiveValues(params);
+			return { sql_params: Object.fromEntries(Object.entries(params).map(([k, v]) => [k, String(v)])) };
+		case "dbt":
+			if (Object.keys(params).length > 0) throw new Error("dbt tasks do not accept parameters");
+			return {};
+		default: {
+			const _exhaustive = taskType;
+			throw new Error(`Unknown task type: ${_exhaustive}`);
+		}
+	}
+}
+
+//#endregion
+export { mapParams };
+//# sourceMappingURL=params.js.map

package/dist/plugins/jobs/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","names":[],"sources":["../../../src/plugins/jobs/params.ts"],"sourcesContent":["import type { TaskType } from \"./types\";\n\n/** Throw if any value is not a string, number, or boolean. */\nfunction assertPrimitiveValues(params: Record<string, unknown>): void {\n  for (const [k, v] of Object.entries(params)) {\n    if (v !== null && v !== undefined && typeof v === \"object\") {\n      throw new Error(\n        `Parameter \"${k}\" must be a primitive value, got ${Array.isArray(v) ? \"array\" : \"object\"}`,\n      );\n    }\n  }\n}\n\n/**\n * Maps validated parameters to SDK request fields based on the task type.\n * This is a pure function — stateless and testable in isolation.\n */\nexport function mapParams(\n  taskType: TaskType,\n  params: Record<string, unknown>,\n): Record<string, unknown> {\n  switch (taskType) {\n    case \"notebook\":\n      // notebook_params expects Record<string, string>, values coerced to string\n      assertPrimitiveValues(params);\n      return {\n        notebook_params: Object.fromEntries(\n          Object.entries(params).map(([k, v]) => [k, String(v)]),\n        ),\n      };\n    case \"python_wheel\":\n      assertPrimitiveValues(params);\n      return {\n        python_named_params: Object.fromEntries(\n          Object.entries(params).map(([k, v]) => [k, String(v)]),\n        ),\n      };\n    case \"python_script\":\n      // python_params expects string[] (positional args)\n      return {\n        python_params: Array.isArray(params.args)\n          ? params.args.map(String)\n          : [],\n      };\n    case \"spark_jar\":\n      // jar_params expects string[]\n      return {\n        jar_params: Array.isArray(params.args) ? params.args.map(String) : [],\n      };\n    case \"sql\":\n      assertPrimitiveValues(params);\n      return {\n        sql_params: Object.fromEntries(\n          Object.entries(params).map(([k, v]) => [k, String(v)]),\n        ),\n      };\n    case \"dbt\":\n      if (Object.keys(params).length > 0) {\n        throw new Error(\"dbt tasks do not accept parameters\");\n      }\n      return {};\n    default: {\n      const _exhaustive: never = taskType;\n      throw new Error(`Unknown task type: ${_exhaustive}`);\n    }\n  }\n}\n"],"mappings":";;AAGA,SAAS,sBAAsB,QAAuC;AACpE,MAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,OAAO,CACzC,KAAI,MAAM,QAAQ,MAAM,UAAa,OAAO,MAAM,SAChD,OAAM,IAAI,MACR,cAAc,EAAE,mCAAmC,MAAM,QAAQ,EAAE,GAAG,UAAU,WACjF;;;;;;AASP,SAAgB,UACd,UACA,QACyB;AACzB,SAAQ,UAAR;EACE,KAAK;AAEH,yBAAsB,OAAO;AAC7B,UAAO,EACL,iBAAiB,OAAO,YACtB,OAAO,QAAQ,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC,CAAC,CACvD,EACF;EACH,KAAK;AACH,yBAAsB,OAAO;AAC7B,UAAO,EACL,qBAAqB,OAAO,YAC1B,OAAO,QAAQ,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC,CAAC,CACvD,EACF;EACH,KAAK,gBAEH,QAAO,EACL,eAAe,MAAM,QAAQ,OAAO,KAAK,GACrC,OAAO,KAAK,IAAI,OAAO,GACvB,EAAE,EACP;EACH,KAAK,YAEH,QAAO,EACL,YAAY,MAAM,QAAQ,OAAO,KAAK,GAAG,OAAO,KAAK,IAAI,OAAO,GAAG,EAAE,EACtE;EACH,KAAK;AACH,yBAAsB,OAAO;AAC7B,UAAO,EACL,YAAY,OAAO,YACjB,OAAO,QAAQ,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC,CAAC,CACvD,EACF;EACH,KAAK;AACH,OAAI,OAAO,KAAK,OAAO,CAAC,SAAS,EAC/B,OAAM,IAAI,MAAM,qCAAqC;AAEvD,UAAO,EAAE;EACX,SAAS;GACP,MAAM,cAAqB;AAC3B,SAAM,IAAI,MAAM,sBAAsB,cAAc"}

package/dist/plugins/jobs/plugin.d.ts

@@ -0,0 +1,66 @@
+import { IAppRouter, ToPlugin } from "../../shared/src/plugin.js";
+import "../../shared/src/index.js";
+import { Plugin } from "../../plugin/plugin.js";
+import "../../plugin/index.js";
+import { PluginManifest, ResourceRequirement } from "../../registry/types.js";
+import "../../registry/index.js";
+import { IJobsConfig, JobAPI, JobConfig, JobsExport } from "./types.js";
+
+//#region src/plugins/jobs/plugin.d.ts
+declare class JobsPlugin extends Plugin {
+  static manifest: PluginManifest;
+  protected config: IJobsConfig;
+  private connector;
+  private jobIds;
+  private jobConfigs;
+  private jobKeys;
+  /**
+   * Scans process.env for DATABRICKS_JOB_* keys and merges with explicit config.
+   * Explicit config wins for per-job overrides; auto-discovered jobs get default `{}` config.
+   */
+  static discoverJobs(config: IJobsConfig): Record<string, JobConfig>;
+  /**
+   * Generates resource requirements dynamically from discovered + configured jobs.
+   * Each job key maps to a `DATABRICKS_JOB_{KEY_UPPERCASE}` env var (or `DATABRICKS_JOB_ID` for "default").
+   */
+  static getResourceRequirements(config: IJobsConfig): ResourceRequirement[];
+  constructor(config: IJobsConfig);
+  setup(): Promise<void>;
+  private get client();
+  private getJobId;
+  private _readSettings;
+  private _writeSettings;
+  /**
+   * Validates params against the job's Zod schema (if any) and maps them
+   * to SDK request fields based on the task type. Shared by runNow and runAndWait.
+   */
+  private _validateAndMap;
+  /**
+   * Creates a JobAPI for a specific configured job key.
+   * Each method is scoped to the job's configured ID.
+   */
+  protected createJobAPI(jobKey: string): JobAPI;
+  /**
+   * Resolve `:jobKey` from the request. Returns the key and ID,
+   * or sends a 404 and returns `{ jobKey: undefined, jobId: undefined }`.
+   */
+  private _resolveJob;
+  private _sendStatusError;
+  /**
+   * Validate params from an HTTP request body. Eager validation lets streaming
+   * requests get a clean 400 instead of a generic SSE error event. Throws
+   * ValidationError so handlers can map to a 400 response via their catch block.
+   */
+  private _parseRunParams;
+  private _handleRun;
+  injectRoutes(router: IAppRouter): void;
+  exports(): JobsExport;
+  clientConfig(): Record<string, unknown>;
+}
+/**
+ * @internal
+ */
+declare const jobs: ToPlugin<typeof JobsPlugin, IJobsConfig, string>;
+//#endregion
+export { jobs };
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/jobs/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","names":[],"sources":["../../../src/plugins/jobs/plugin.ts"],"mappings":";;;;;;;;;cAsFM,UAAA,SAAmB,MAAA;EAAA,OAChB,QAAA,EAAuB,cAAA;EAAA,UAEZ,MAAA,EAAQ,WAAA;EAAA,QAClB,SAAA;EAAA,QACA,MAAA;EAAA,QACA,UAAA;EAAA,QACA,OAAA;;;;;SAMD,YAAA,CAAa,MAAA,EAAQ,WAAA,GAAc,MAAA,SAAe,SAAA;EAAf;;;;EAAA,OAgCnC,uBAAA,CAAwB,MAAA,EAAQ,WAAA,GAAc,mBAAA;cAqBzC,MAAA,EAAQ,WAAA;EA0Bd,KAAA,CAAA,GAAK,OAAA;EAAA,YAMC,MAAA,CAAA;EAAA,QAIJ,QAAA;EAAA,QAcA,aAAA;EAAA,QAYA,cAAA;EAhIqB;;;;EAAA,QA6IrB,eAAA;EA1IkB;;;;EAAA,UAoKhB,YAAA,CAAa,MAAA,WAAiB,MAAA;EA1JjC;;;;EAAA,QAgXC,WAAA;EAAA,QA0BA,gBAAA;EA1W+B;;;;;EAAA,QAsX/B,eAAA;EAAA,QAuCM,UAAA;EA4Cd,YAAA,CAAa,MAAA,EAAQ,UAAA;EA6IrB,OAAA,CAAA,GAAW,UAAA;EAsBX,YAAA,CAAA,GAAgB,MAAA;AAAA;;;;cAiBL,IAAA,EAAI,QAAA,QAAA,UAAA,EAAA,WAAA"}