@fabricorg/databricks-testkit 0.2.3 → 0.3.0

package/dist/index.d.cts

@@ -131,7 +131,8 @@ declare function toNamedParameters(sql: string, params: readonly unknown[]): {
 declare function parseStatementRows(response: StatementResponse): Record<string, unknown>[];
 /**
  * Auth precedence (ADR-0006): DATABRICKS_BEARER (pre-minted, CI) →
- * DATABRICKS_CLIENT_ID/SECRET (OAuth M2M) → DATABRICKS_TOKEN (PAT).
+ * explicit env/file OIDC federation → DATABRICKS_CLIENT_ID/SECRET (OAuth
+ * M2M) → DATABRICKS_TOKEN (legacy PAT).
  */
 declare function createClientFromEnv(env: Record<string, string | undefined>, fetchImpl?: typeof fetch): DatabricksRestClient;
 declare function resolveTokenProvider(host: string, env: Record<string, string | undefined>, fetchImpl?: typeof fetch): string | (() => Promise<string>);
@@ -208,6 +209,23 @@ interface LiveCheckResult {
     details?: unknown;
     error?: string;
 }
+type TargetPackMaturity = 'proposed' | 'building' | 'shipped' | 'live-gated' | 'certifying' | 'certified';
+interface TargetPackEvidenceMetadata {
+    id: string;
+    name: string;
+    version: string;
+    maturity: TargetPackMaturity;
+    capabilities: string[];
+    docsUrl?: string;
+    certificationScopes: string[];
+    target: {
+        cloud?: string;
+        region?: string;
+        workspace?: string;
+        runtime?: string;
+        compute?: string;
+    };
+}
 interface LiveEvidence {
     schemaVersion: 1;
     kind: 'databricks-live-suite';
@@ -216,6 +234,7 @@ interface LiveEvidence {
     success: boolean;
     required: string[];
     results: LiveCheckResult[];
+    targetPack?: TargetPackEvidenceMetadata;
 }
 interface LiveSuiteSpec {
     checks: readonly LiveCheck[];
@@ -223,6 +242,7 @@ interface LiveSuiteSpec {
     evidencePath?: string;
     junitPath?: string;
     env?: Record<string, string | undefined>;
+    targetPack?: TargetPackEvidenceMetadata;
 }
 interface LiveSuiteRuntime {
     warehouse?: ExecutionContext;
@@ -350,4 +370,223 @@ declare function serverlessComputeCheck(): LiveCheck;
 /** Launch a disposable classic job cluster and require the shared notebook probe to succeed. */
 declare function classicComputeCheck(): LiveCheck;
 
-export { type AppHealthCheckOptions, type AutoLoaderCheckOptions, type CreateContextOptions, type DefinedLiveSuite, type DeltaColumnContract, type DuckDbConnectionLike, type DuckDbContextOptions, type EphemeralLakebaseBranch, type ExecutionContext, type LakebaseBranchOptions, type LakebaseCheckOptions, type LakebaseControlClient, type LiveCheck, type LiveCheckContext, type LiveCheckResult, type LiveCheckStatus, type LiveEvidence, type LiveSuiteRuntime, type LiveSuiteSpec, type MockDatabricksClient, type PollOptions, type RecordedCall, type SecretRotationCheckOptions, TableFixture, type TestProfile, type VolumeIOCheckOptions, type WorkspaceClientLike, type WorkspaceContextOptions, appHealthCheck, assertDeltaContract, autoLoaderIngestionCheck, backupRestoreCheck, classicComputeCheck, compareToGolden, createClientFromEnv, createDuckDbContext, createEphemeralLakebaseBranch, createExecutionContext, createLakebaseTestProvider, createMockDatabricksClient, createWorkspaceContext, customLiveCheck, dbtBuildCheck, defineLiveSuite, deleteEphemeralLakebaseBranch, deleteVolumeFile, deltaContractCheck, ensureVolumeDirectory, expectQueryToMatchGolden, expectTable, failureRecoveryCheck, jobRunCheck, lakebaseCredentialCheck, lakebaseRoundTripCheck, normalizeRow, normalizeVolumeRoot, notebookSubmitCheck, parseStatementRows, performanceBudgetCheck, pipelineRefreshCheck, renderJUnit, resolveLakebaseProject, resolveProfile, resolveTokenProvider, restrictedPrincipalCheck, rollbackCheck, runLiveSuite, secretRotationCheck, secretScopeCheck, serverlessComputeCheck, sqlRoundTripCheck, toLakebaseBranchId, toNamedParameters, unityCatalogAccessCheck, uploadVolumeFile, volumeIOCheck, waitForPipelineUpdate };
+interface TargetPackRequirement {
+    id: string;
+    description: string;
+    /** At least one named environment variable must be present. */
+    anyOf: readonly string[];
+    required?: boolean;
+    secret?: boolean;
+}
+interface TargetPackSpec {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    maturity: TargetPackMaturity;
+    capabilities: readonly string[];
+    checks: readonly LiveCheck[] | (() => readonly LiveCheck[]);
+    requiredChecks?: readonly string[];
+    requirements?: readonly TargetPackRequirement[];
+    docsUrl?: string;
+    certificationScopes?: readonly string[];
+}
+interface TargetPack extends Omit<TargetPackSpec, 'checks'> {
+    checks(): readonly LiveCheck[];
+}
+interface TargetPackDoctorRequirement {
+    id: string;
+    description: string;
+    satisfied: boolean;
+    required: boolean;
+    variables: string[];
+}
+interface TargetPackDoctorCheck {
+    id: string;
+    description: string;
+    configured: boolean;
+    required: boolean;
+}
+interface TargetPackDoctorResult {
+    pack: Pick<TargetPack, 'id' | 'name' | 'version' | 'maturity'>;
+    ready: boolean;
+    requirements: TargetPackDoctorRequirement[];
+    checks: TargetPackDoctorCheck[];
+    missingRequirements: string[];
+    missingRequiredChecks: string[];
+}
+interface RunTargetPackOptions {
+    env?: Record<string, string | undefined>;
+    requiredChecks?: readonly string[];
+    evidencePath?: string;
+    junitPath?: string;
+}
+interface DefinedTargetPackRun {
+    pack: TargetPack;
+    run(runtime?: LiveSuiteRuntime): Promise<LiveEvidence | undefined>;
+}
+declare function defineTargetPack(spec: TargetPackSpec): TargetPack;
+declare function createTargetPackRegistry(packs: readonly TargetPack[]): ReadonlyMap<string, TargetPack>;
+declare function doctorTargetPack(pack: TargetPack, env?: Record<string, string | undefined>, requiredChecks?: readonly string[]): TargetPackDoctorResult;
+declare function defineTargetPackRun(pack: TargetPack, options?: RunTargetPackOptions): DefinedTargetPackRun;
+declare function runTargetPack(pack: TargetPack, options?: RunTargetPackOptions, runtime?: LiveSuiteRuntime): Promise<LiveEvidence | undefined>;
+
+declare function createSqlDeltaFoundationPack(): TargetPack;
+declare function createLakeflowFoundationPack(): TargetPack;
+declare function createJobsCodeFoundationPack(): TargetPack;
+declare function createUnityStorageFoundationPack(): TargetPack;
+declare function createAppsOperationalFoundationPack(): TargetPack;
+declare function createFoundationTargetPacks(): readonly TargetPack[];
+declare const foundationTargetPacks: readonly TargetPack[];
+
+interface JobTaskDependency {
+    task_key: string;
+    outcome?: string;
+}
+interface JobTaskBase {
+    task_key: string;
+    depends_on?: JobTaskDependency[];
+    run_if?: 'ALL_SUCCESS' | 'AT_LEAST_ONE_SUCCESS' | 'NONE_FAILED' | 'ALL_DONE' | 'AT_LEAST_ONE_FAILED' | 'ALL_FAILED';
+    timeout_seconds?: number;
+    max_retries?: number;
+    min_retry_interval_millis?: number;
+    retry_on_timeout?: boolean;
+    existing_cluster_id?: string;
+    job_cluster_key?: string;
+    environment_key?: string;
+}
+interface NotebookJobTask extends JobTaskBase {
+    notebook_task: {
+        notebook_path: string;
+        base_parameters?: Record<string, string>;
+        source?: 'WORKSPACE' | 'GIT';
+    };
+}
+interface PythonWheelJobTask extends JobTaskBase {
+    python_wheel_task: {
+        package_name: string;
+        entry_point: string;
+        parameters?: string[];
+        named_parameters?: Record<string, string>;
+    };
+}
+interface SparkJarJobTask extends JobTaskBase {
+    spark_jar_task: {
+        main_class_name: string;
+        parameters?: string[];
+    };
+}
+interface SparkPythonJobTask extends JobTaskBase {
+    spark_python_task: {
+        python_file: string;
+        parameters?: string[];
+        source?: 'WORKSPACE' | 'GIT';
+    };
+}
+interface SparkSubmitJobTask extends JobTaskBase {
+    spark_submit_task: {
+        parameters: string[];
+    };
+}
+interface PipelineJobTask extends JobTaskBase {
+    pipeline_task: {
+        pipeline_id: string;
+        full_refresh?: boolean;
+    };
+}
+interface SqlJobTask extends JobTaskBase {
+    sql_task: Record<string, unknown> & {
+        warehouse_id: string;
+    };
+}
+interface DbtJobTask extends JobTaskBase {
+    dbt_task: Record<string, unknown> & {
+        commands: string[];
+    };
+}
+interface RunJobTask extends JobTaskBase {
+    run_job_task: {
+        job_id: number;
+        job_parameters?: Record<string, string>;
+    };
+}
+interface ConditionJobTask extends JobTaskBase {
+    condition_task: {
+        left: string;
+        op: 'EQUAL_TO' | 'NOT_EQUAL' | 'GREATER_THAN' | 'GREATER_THAN_OR_EQUAL' | 'LESS_THAN' | 'LESS_THAN_OR_EQUAL';
+        right: string;
+    };
+}
+interface ForEachJobTask extends JobTaskBase {
+    for_each_task: {
+        inputs: string;
+        concurrency?: number;
+        task: Exclude<DatabricksJobTask, ForEachJobTask>;
+    };
+}
+type DatabricksJobTask = NotebookJobTask | PythonWheelJobTask | SparkJarJobTask | SparkPythonJobTask | SparkSubmitJobTask | PipelineJobTask | SqlJobTask | DbtJobTask | RunJobTask | ConditionJobTask | ForEachJobTask;
+interface JobsSubmitRequest {
+    run_name: string;
+    tasks: DatabricksJobTask[];
+    parameters?: Array<{
+        name: string;
+        default: string;
+    }>;
+    job_clusters?: Array<Record<string, unknown> & {
+        job_cluster_key: string;
+    }>;
+    environments?: Array<Record<string, unknown> & {
+        environment_key: string;
+    }>;
+    git_source?: Record<string, unknown>;
+    timeout_seconds?: number;
+    idempotency_token?: string;
+}
+interface JobTaskRunState {
+    taskKey: string;
+    runId?: number;
+    lifeCycleState: string;
+    resultState: string;
+    stateMessage?: string;
+}
+interface JobOrchestrationRun {
+    runId: number;
+    lifeCycleState: string;
+    resultState: string;
+    tasks: JobTaskRunState[];
+    raw: Record<string, unknown>;
+}
+interface JobWaitOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}
+interface JobRepairOptions {
+    rerunTasks?: string[];
+    latestRepairId?: number;
+}
+interface JobOrchestrationLiveSpec {
+    request: JobsSubmitRequest;
+    expectedResult?: string;
+    expectedTasks?: Record<string, string>;
+    repairFailedTasks?: boolean;
+}
+declare class DatabricksJobsAdapter {
+    private readonly client;
+    constructor(client: WorkspaceClientLike);
+    submit(request: JobsSubmitRequest): Promise<number>;
+    get(runId: number): Promise<JobOrchestrationRun>;
+    wait(runId: number, options?: JobWaitOptions): Promise<JobOrchestrationRun>;
+    cancel(runId: number): Promise<void>;
+    repair(runId: number, options?: JobRepairOptions): Promise<number>;
+}
+declare function validateJobGraph(tasks: readonly DatabricksJobTask[]): void;
+declare function jobsOrchestrationCheck(): LiveCheck;
+declare function parseJobOrchestrationLiveSpec(value: string): JobOrchestrationLiveSpec;
+declare function normalizeJobRun(fallbackRunId: number, raw: Record<string, unknown>): JobOrchestrationRun;
+
+declare function createLakeflowJobsTargetPack(): TargetPack;
+
+declare function createBuiltinTargetPacks(): readonly TargetPack[];
+declare const builtinTargetPacks: readonly TargetPack[];
+
+export { type AppHealthCheckOptions, type AutoLoaderCheckOptions, type ConditionJobTask, type CreateContextOptions, type DatabricksJobTask, DatabricksJobsAdapter, type DbtJobTask, type DefinedLiveSuite, type DefinedTargetPackRun, type DeltaColumnContract, type DuckDbConnectionLike, type DuckDbContextOptions, type EphemeralLakebaseBranch, type ExecutionContext, type ForEachJobTask, type JobOrchestrationLiveSpec, type JobOrchestrationRun, type JobRepairOptions, type JobTaskBase, type JobTaskDependency, type JobTaskRunState, type JobWaitOptions, type JobsSubmitRequest, type LakebaseBranchOptions, type LakebaseCheckOptions, type LakebaseControlClient, type LiveCheck, type LiveCheckContext, type LiveCheckResult, type LiveCheckStatus, type LiveEvidence, type LiveSuiteRuntime, type LiveSuiteSpec, type MockDatabricksClient, type NotebookJobTask, type PipelineJobTask, type PollOptions, type PythonWheelJobTask, type RecordedCall, type RunJobTask, type RunTargetPackOptions, type SecretRotationCheckOptions, type SparkJarJobTask, type SparkPythonJobTask, type SparkSubmitJobTask, type SqlJobTask, TableFixture, type TargetPack, type TargetPackDoctorCheck, type TargetPackDoctorRequirement, type TargetPackDoctorResult, type TargetPackEvidenceMetadata, type TargetPackMaturity, type TargetPackRequirement, type TargetPackSpec, type TestProfile, type VolumeIOCheckOptions, type WorkspaceClientLike, type WorkspaceContextOptions, appHealthCheck, assertDeltaContract, autoLoaderIngestionCheck, backupRestoreCheck, builtinTargetPacks, classicComputeCheck, compareToGolden, createAppsOperationalFoundationPack, createBuiltinTargetPacks, createClientFromEnv, createDuckDbContext, createEphemeralLakebaseBranch, createExecutionContext, createFoundationTargetPacks, createJobsCodeFoundationPack, createLakebaseTestProvider, createLakeflowFoundationPack, createLakeflowJobsTargetPack, createMockDatabricksClient, createSqlDeltaFoundationPack, createTargetPackRegistry, createUnityStorageFoundationPack, createWorkspaceContext, customLiveCheck, dbtBuildCheck, defineLiveSuite, defineTargetPack, defineTargetPackRun, deleteEphemeralLakebaseBranch, deleteVolumeFile, deltaContractCheck, doctorTargetPack, ensureVolumeDirectory, expectQueryToMatchGolden, expectTable, failureRecoveryCheck, foundationTargetPacks, jobRunCheck, jobsOrchestrationCheck, lakebaseCredentialCheck, lakebaseRoundTripCheck, normalizeJobRun, normalizeRow, normalizeVolumeRoot, notebookSubmitCheck, parseJobOrchestrationLiveSpec, parseStatementRows, performanceBudgetCheck, pipelineRefreshCheck, renderJUnit, resolveLakebaseProject, resolveProfile, resolveTokenProvider, restrictedPrincipalCheck, rollbackCheck, runLiveSuite, runTargetPack, secretRotationCheck, secretScopeCheck, serverlessComputeCheck, sqlRoundTripCheck, toLakebaseBranchId, toNamedParameters, unityCatalogAccessCheck, uploadVolumeFile, validateJobGraph, volumeIOCheck, waitForPipelineUpdate };

package/dist/index.d.ts

@@ -131,7 +131,8 @@ declare function toNamedParameters(sql: string, params: readonly unknown[]): {
 declare function parseStatementRows(response: StatementResponse): Record<string, unknown>[];
 /**
  * Auth precedence (ADR-0006): DATABRICKS_BEARER (pre-minted, CI) →
- * DATABRICKS_CLIENT_ID/SECRET (OAuth M2M) → DATABRICKS_TOKEN (PAT).
+ * explicit env/file OIDC federation → DATABRICKS_CLIENT_ID/SECRET (OAuth
+ * M2M) → DATABRICKS_TOKEN (legacy PAT).
  */
 declare function createClientFromEnv(env: Record<string, string | undefined>, fetchImpl?: typeof fetch): DatabricksRestClient;
 declare function resolveTokenProvider(host: string, env: Record<string, string | undefined>, fetchImpl?: typeof fetch): string | (() => Promise<string>);
@@ -208,6 +209,23 @@ interface LiveCheckResult {
     details?: unknown;
     error?: string;
 }
+type TargetPackMaturity = 'proposed' | 'building' | 'shipped' | 'live-gated' | 'certifying' | 'certified';
+interface TargetPackEvidenceMetadata {
+    id: string;
+    name: string;
+    version: string;
+    maturity: TargetPackMaturity;
+    capabilities: string[];
+    docsUrl?: string;
+    certificationScopes: string[];
+    target: {
+        cloud?: string;
+        region?: string;
+        workspace?: string;
+        runtime?: string;
+        compute?: string;
+    };
+}
 interface LiveEvidence {
     schemaVersion: 1;
     kind: 'databricks-live-suite';
@@ -216,6 +234,7 @@ interface LiveEvidence {
     success: boolean;
     required: string[];
     results: LiveCheckResult[];
+    targetPack?: TargetPackEvidenceMetadata;
 }
 interface LiveSuiteSpec {
     checks: readonly LiveCheck[];
@@ -223,6 +242,7 @@ interface LiveSuiteSpec {
     evidencePath?: string;
     junitPath?: string;
     env?: Record<string, string | undefined>;
+    targetPack?: TargetPackEvidenceMetadata;
 }
 interface LiveSuiteRuntime {
     warehouse?: ExecutionContext;
@@ -350,4 +370,223 @@ declare function serverlessComputeCheck(): LiveCheck;
 /** Launch a disposable classic job cluster and require the shared notebook probe to succeed. */
 declare function classicComputeCheck(): LiveCheck;
 
-export { type AppHealthCheckOptions, type AutoLoaderCheckOptions, type CreateContextOptions, type DefinedLiveSuite, type DeltaColumnContract, type DuckDbConnectionLike, type DuckDbContextOptions, type EphemeralLakebaseBranch, type ExecutionContext, type LakebaseBranchOptions, type LakebaseCheckOptions, type LakebaseControlClient, type LiveCheck, type LiveCheckContext, type LiveCheckResult, type LiveCheckStatus, type LiveEvidence, type LiveSuiteRuntime, type LiveSuiteSpec, type MockDatabricksClient, type PollOptions, type RecordedCall, type SecretRotationCheckOptions, TableFixture, type TestProfile, type VolumeIOCheckOptions, type WorkspaceClientLike, type WorkspaceContextOptions, appHealthCheck, assertDeltaContract, autoLoaderIngestionCheck, backupRestoreCheck, classicComputeCheck, compareToGolden, createClientFromEnv, createDuckDbContext, createEphemeralLakebaseBranch, createExecutionContext, createLakebaseTestProvider, createMockDatabricksClient, createWorkspaceContext, customLiveCheck, dbtBuildCheck, defineLiveSuite, deleteEphemeralLakebaseBranch, deleteVolumeFile, deltaContractCheck, ensureVolumeDirectory, expectQueryToMatchGolden, expectTable, failureRecoveryCheck, jobRunCheck, lakebaseCredentialCheck, lakebaseRoundTripCheck, normalizeRow, normalizeVolumeRoot, notebookSubmitCheck, parseStatementRows, performanceBudgetCheck, pipelineRefreshCheck, renderJUnit, resolveLakebaseProject, resolveProfile, resolveTokenProvider, restrictedPrincipalCheck, rollbackCheck, runLiveSuite, secretRotationCheck, secretScopeCheck, serverlessComputeCheck, sqlRoundTripCheck, toLakebaseBranchId, toNamedParameters, unityCatalogAccessCheck, uploadVolumeFile, volumeIOCheck, waitForPipelineUpdate };
+interface TargetPackRequirement {
+    id: string;
+    description: string;
+    /** At least one named environment variable must be present. */
+    anyOf: readonly string[];
+    required?: boolean;
+    secret?: boolean;
+}
+interface TargetPackSpec {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    maturity: TargetPackMaturity;
+    capabilities: readonly string[];
+    checks: readonly LiveCheck[] | (() => readonly LiveCheck[]);
+    requiredChecks?: readonly string[];
+    requirements?: readonly TargetPackRequirement[];
+    docsUrl?: string;
+    certificationScopes?: readonly string[];
+}
+interface TargetPack extends Omit<TargetPackSpec, 'checks'> {
+    checks(): readonly LiveCheck[];
+}
+interface TargetPackDoctorRequirement {
+    id: string;
+    description: string;
+    satisfied: boolean;
+    required: boolean;
+    variables: string[];
+}
+interface TargetPackDoctorCheck {
+    id: string;
+    description: string;
+    configured: boolean;
+    required: boolean;
+}
+interface TargetPackDoctorResult {
+    pack: Pick<TargetPack, 'id' | 'name' | 'version' | 'maturity'>;
+    ready: boolean;
+    requirements: TargetPackDoctorRequirement[];
+    checks: TargetPackDoctorCheck[];
+    missingRequirements: string[];
+    missingRequiredChecks: string[];
+}
+interface RunTargetPackOptions {
+    env?: Record<string, string | undefined>;
+    requiredChecks?: readonly string[];
+    evidencePath?: string;
+    junitPath?: string;
+}
+interface DefinedTargetPackRun {
+    pack: TargetPack;
+    run(runtime?: LiveSuiteRuntime): Promise<LiveEvidence | undefined>;
+}
+declare function defineTargetPack(spec: TargetPackSpec): TargetPack;
+declare function createTargetPackRegistry(packs: readonly TargetPack[]): ReadonlyMap<string, TargetPack>;
+declare function doctorTargetPack(pack: TargetPack, env?: Record<string, string | undefined>, requiredChecks?: readonly string[]): TargetPackDoctorResult;
+declare function defineTargetPackRun(pack: TargetPack, options?: RunTargetPackOptions): DefinedTargetPackRun;
+declare function runTargetPack(pack: TargetPack, options?: RunTargetPackOptions, runtime?: LiveSuiteRuntime): Promise<LiveEvidence | undefined>;
+
+declare function createSqlDeltaFoundationPack(): TargetPack;
+declare function createLakeflowFoundationPack(): TargetPack;
+declare function createJobsCodeFoundationPack(): TargetPack;
+declare function createUnityStorageFoundationPack(): TargetPack;
+declare function createAppsOperationalFoundationPack(): TargetPack;
+declare function createFoundationTargetPacks(): readonly TargetPack[];
+declare const foundationTargetPacks: readonly TargetPack[];
+
+interface JobTaskDependency {
+    task_key: string;
+    outcome?: string;
+}
+interface JobTaskBase {
+    task_key: string;
+    depends_on?: JobTaskDependency[];
+    run_if?: 'ALL_SUCCESS' | 'AT_LEAST_ONE_SUCCESS' | 'NONE_FAILED' | 'ALL_DONE' | 'AT_LEAST_ONE_FAILED' | 'ALL_FAILED';
+    timeout_seconds?: number;
+    max_retries?: number;
+    min_retry_interval_millis?: number;
+    retry_on_timeout?: boolean;
+    existing_cluster_id?: string;
+    job_cluster_key?: string;
+    environment_key?: string;
+}
+interface NotebookJobTask extends JobTaskBase {
+    notebook_task: {
+        notebook_path: string;
+        base_parameters?: Record<string, string>;
+        source?: 'WORKSPACE' | 'GIT';
+    };
+}
+interface PythonWheelJobTask extends JobTaskBase {
+    python_wheel_task: {
+        package_name: string;
+        entry_point: string;
+        parameters?: string[];
+        named_parameters?: Record<string, string>;
+    };
+}
+interface SparkJarJobTask extends JobTaskBase {
+    spark_jar_task: {
+        main_class_name: string;
+        parameters?: string[];
+    };
+}
+interface SparkPythonJobTask extends JobTaskBase {
+    spark_python_task: {
+        python_file: string;
+        parameters?: string[];
+        source?: 'WORKSPACE' | 'GIT';
+    };
+}
+interface SparkSubmitJobTask extends JobTaskBase {
+    spark_submit_task: {
+        parameters: string[];
+    };
+}
+interface PipelineJobTask extends JobTaskBase {
+    pipeline_task: {
+        pipeline_id: string;
+        full_refresh?: boolean;
+    };
+}
+interface SqlJobTask extends JobTaskBase {
+    sql_task: Record<string, unknown> & {
+        warehouse_id: string;
+    };
+}
+interface DbtJobTask extends JobTaskBase {
+    dbt_task: Record<string, unknown> & {
+        commands: string[];
+    };
+}
+interface RunJobTask extends JobTaskBase {
+    run_job_task: {
+        job_id: number;
+        job_parameters?: Record<string, string>;
+    };
+}
+interface ConditionJobTask extends JobTaskBase {
+    condition_task: {
+        left: string;
+        op: 'EQUAL_TO' | 'NOT_EQUAL' | 'GREATER_THAN' | 'GREATER_THAN_OR_EQUAL' | 'LESS_THAN' | 'LESS_THAN_OR_EQUAL';
+        right: string;
+    };
+}
+interface ForEachJobTask extends JobTaskBase {
+    for_each_task: {
+        inputs: string;
+        concurrency?: number;
+        task: Exclude<DatabricksJobTask, ForEachJobTask>;
+    };
+}
+type DatabricksJobTask = NotebookJobTask | PythonWheelJobTask | SparkJarJobTask | SparkPythonJobTask | SparkSubmitJobTask | PipelineJobTask | SqlJobTask | DbtJobTask | RunJobTask | ConditionJobTask | ForEachJobTask;
+interface JobsSubmitRequest {
+    run_name: string;
+    tasks: DatabricksJobTask[];
+    parameters?: Array<{
+        name: string;
+        default: string;
+    }>;
+    job_clusters?: Array<Record<string, unknown> & {
+        job_cluster_key: string;
+    }>;
+    environments?: Array<Record<string, unknown> & {
+        environment_key: string;
+    }>;
+    git_source?: Record<string, unknown>;
+    timeout_seconds?: number;
+    idempotency_token?: string;
+}
+interface JobTaskRunState {
+    taskKey: string;
+    runId?: number;
+    lifeCycleState: string;
+    resultState: string;
+    stateMessage?: string;
+}
+interface JobOrchestrationRun {
+    runId: number;
+    lifeCycleState: string;
+    resultState: string;
+    tasks: JobTaskRunState[];
+    raw: Record<string, unknown>;
+}
+interface JobWaitOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}
+interface JobRepairOptions {
+    rerunTasks?: string[];
+    latestRepairId?: number;
+}
+interface JobOrchestrationLiveSpec {
+    request: JobsSubmitRequest;
+    expectedResult?: string;
+    expectedTasks?: Record<string, string>;
+    repairFailedTasks?: boolean;
+}
+declare class DatabricksJobsAdapter {
+    private readonly client;
+    constructor(client: WorkspaceClientLike);
+    submit(request: JobsSubmitRequest): Promise<number>;
+    get(runId: number): Promise<JobOrchestrationRun>;
+    wait(runId: number, options?: JobWaitOptions): Promise<JobOrchestrationRun>;
+    cancel(runId: number): Promise<void>;
+    repair(runId: number, options?: JobRepairOptions): Promise<number>;
+}
+declare function validateJobGraph(tasks: readonly DatabricksJobTask[]): void;
+declare function jobsOrchestrationCheck(): LiveCheck;
+declare function parseJobOrchestrationLiveSpec(value: string): JobOrchestrationLiveSpec;
+declare function normalizeJobRun(fallbackRunId: number, raw: Record<string, unknown>): JobOrchestrationRun;
+
+declare function createLakeflowJobsTargetPack(): TargetPack;
+
+declare function createBuiltinTargetPacks(): readonly TargetPack[];
+declare const builtinTargetPacks: readonly TargetPack[];
+
+export { type AppHealthCheckOptions, type AutoLoaderCheckOptions, type ConditionJobTask, type CreateContextOptions, type DatabricksJobTask, DatabricksJobsAdapter, type DbtJobTask, type DefinedLiveSuite, type DefinedTargetPackRun, type DeltaColumnContract, type DuckDbConnectionLike, type DuckDbContextOptions, type EphemeralLakebaseBranch, type ExecutionContext, type ForEachJobTask, type JobOrchestrationLiveSpec, type JobOrchestrationRun, type JobRepairOptions, type JobTaskBase, type JobTaskDependency, type JobTaskRunState, type JobWaitOptions, type JobsSubmitRequest, type LakebaseBranchOptions, type LakebaseCheckOptions, type LakebaseControlClient, type LiveCheck, type LiveCheckContext, type LiveCheckResult, type LiveCheckStatus, type LiveEvidence, type LiveSuiteRuntime, type LiveSuiteSpec, type MockDatabricksClient, type NotebookJobTask, type PipelineJobTask, type PollOptions, type PythonWheelJobTask, type RecordedCall, type RunJobTask, type RunTargetPackOptions, type SecretRotationCheckOptions, type SparkJarJobTask, type SparkPythonJobTask, type SparkSubmitJobTask, type SqlJobTask, TableFixture, type TargetPack, type TargetPackDoctorCheck, type TargetPackDoctorRequirement, type TargetPackDoctorResult, type TargetPackEvidenceMetadata, type TargetPackMaturity, type TargetPackRequirement, type TargetPackSpec, type TestProfile, type VolumeIOCheckOptions, type WorkspaceClientLike, type WorkspaceContextOptions, appHealthCheck, assertDeltaContract, autoLoaderIngestionCheck, backupRestoreCheck, builtinTargetPacks, classicComputeCheck, compareToGolden, createAppsOperationalFoundationPack, createBuiltinTargetPacks, createClientFromEnv, createDuckDbContext, createEphemeralLakebaseBranch, createExecutionContext, createFoundationTargetPacks, createJobsCodeFoundationPack, createLakebaseTestProvider, createLakeflowFoundationPack, createLakeflowJobsTargetPack, createMockDatabricksClient, createSqlDeltaFoundationPack, createTargetPackRegistry, createUnityStorageFoundationPack, createWorkspaceContext, customLiveCheck, dbtBuildCheck, defineLiveSuite, defineTargetPack, defineTargetPackRun, deleteEphemeralLakebaseBranch, deleteVolumeFile, deltaContractCheck, doctorTargetPack, ensureVolumeDirectory, expectQueryToMatchGolden, expectTable, failureRecoveryCheck, foundationTargetPacks, jobRunCheck, jobsOrchestrationCheck, lakebaseCredentialCheck, lakebaseRoundTripCheck, normalizeJobRun, normalizeRow, normalizeVolumeRoot, notebookSubmitCheck, parseJobOrchestrationLiveSpec, parseStatementRows, performanceBudgetCheck, pipelineRefreshCheck, renderJUnit, resolveLakebaseProject, resolveProfile, resolveTokenProvider, restrictedPrincipalCheck, rollbackCheck, runLiveSuite, runTargetPack, secretRotationCheck, secretScopeCheck, serverlessComputeCheck, sqlRoundTripCheck, toLakebaseBranchId, toNamedParameters, unityCatalogAccessCheck, uploadVolumeFile, validateJobGraph, volumeIOCheck, waitForPipelineUpdate };