Skip to content

feat(appkit): migrate jobs to modular @databricks/sdk-jobs - #647

Draft
MarioCadenas wants to merge 1 commit into
feat/modular-geniefrom
feat/modular-jobs
Draft

MarioCadenas wants to merge 1 commit into
feat/modular-geniefrom
feat/modular-jobs

Conversation

@MarioCadenas

Copy link
Copy Markdown
Collaborator

Part of the migration off @databricks/sdk-experimental onto the modular @databricks/sdk-* SDK (see #562). Base: analytics-migration-sdk.

Changes

feat(appkit): migrate jobs to modular @databricks/sdk-jobs

Route the facade's jobs accessor to a lazily built JobsClient (Jobs API
2.2) and move the jobs connector onto it:

  • submit/get/listRuns -> submitRun/getJob/listRunsIter; signal passed as
    CallOptions, legacy Context adapter removed.
  • Translate camelCase/bigint models back to the snake_case/number wire
    shape at the connector boundary, so the plugin's HTTP, SSE and cache
    output is unchanged (bigint would make JSON.stringify throw).
    Record<string, string> fields keep user keys verbatim.
  • Rebuild runNow's response from the waiter's runId (number_in_job is
    documented as equal to run_id).
  • Surface the modular ApiError's httpStatusCode as statusCode so upstream
    4xx keep mapping to the right HTTP status.

The CLI's jobs calls stay on the legacy client via toLegacyWorkspaceClient.

Draft: implemented by an agent; needs review and a deployed SP + OBO check before it's marked ready.

This pull request and its description were written by Isaac.

Route the facade's `jobs` accessor to a lazily built JobsClient (Jobs API
2.2) and move the jobs connector onto it:
- submit/get/listRuns -> submitRun/getJob/listRunsIter; signal passed as
  CallOptions, legacy Context adapter removed.
- Translate camelCase/bigint models back to the snake_case/number wire
  shape at the connector boundary, so the plugin's HTTP, SSE and cache
  output is unchanged (bigint would make JSON.stringify throw).
  Record<string, string> fields keep user keys verbatim.
- Rebuild runNow's response from the waiter's runId (number_in_job is
  documented as equal to run_id).
- Surface the modular ApiError's httpStatusCode as statusCode so upstream
  4xx keep mapping to the right HTTP status.

The CLI's jobs calls stay on the legacy client via toLegacyWorkspaceClient.

Co-authored-by: Isaac <no-reply@databricks.com>
Signed-off-by: MarioCadenas <MarioCadenas@users.noreply.github.com>

# Conflicts:
#	knip.json
#	packages/appkit/package.json
#	packages/shared/package.json
#	packages/shared/src/workspace-client/client.ts
#	packages/shared/src/workspace-client/modular.ts
#	packages/shared/src/workspace-client/types.ts
#	pnpm-lock.yaml
@MarioCadenas
MarioCadenas changed the base branch from analytics-migration-sdk to feat/modular-genie October 8, 2026 14:37
@MarioCadenas
MarioCadenas added this pull request to stack #636 October 8, 2026 14:38
@github-actions

github-actions Bot commented Oct 8, 2026

Copy link
Copy Markdown
Contributor

📦 Bundle size report

Compared against bundle-size-baseline.json (main).

@databricks/appkit

npm tarball (packed): 1.2 MB (+17 KB) — gzipped download (dist + bin; excludes release-only docs/NOTICE).

dist raw gzip
JS (runtime) 1.2 MB (+17 KB) 454 KB (+6.5 KB)
Type declarations 459 KB (+3.4 KB) 167 KB (+1.3 KB)
Source maps 2.5 MB (+33 KB) 848 KB (+11 KB)
Other 11 KB 3.7 KB
Total 4.2 MB (+53 KB) 1.4 MB (+19 KB)
Per-entry composition (own code — deps external (as shipped))
Entry Initial (gz) Lazy (gz) Total (gz) node_modules (min) Own code (min)
. 104 KB (+1.7 KB) 2.5 KB (+1 B) 106 KB (+1.7 KB) external 336 KB (+4.9 KB)
./beta 100 KB (+1.1 KB) 483 B (-1 B) 100 KB (+1.1 KB) external 300 KB (+2.8 KB)
./testing 43 KB (+1.1 KB) 32 KB 75 KB (+1.1 KB) external 218 KB (+3.3 KB)
./tsdown 520 B 0 B 520 B external 813 B
./type-generator 24 KB (+1.1 KB) 0 B 24 KB (+1.1 KB) external 70 KB (+3.1 KB)

Chunks:

Entry Chunk Load Size (gz)
. index.js initial 99 KB
. utils.js initial 4.6 KB
. remote-tunnel-manager.js lazy 2.5 KB
./beta beta.js initial 81 KB
./beta stream-manager.js initial 5.9 KB
./beta modular.js initial 4.4 KB
./beta service-context.js initial 4.2 KB
./beta databricks.js initial 3.3 KB
./beta client.js initial 594 B
./beta index.js initial 20 B
./beta supervisor-api.js lazy 192 B
./beta databricks.js lazy 176 B
./beta index.js lazy 115 B
./testing manifest.js initial 30 KB
./testing index.js initial 10 KB
./testing wide-event-emitter.js initial 2.9 KB
./testing index.js lazy 28 KB
./testing remote-tunnel-manager.js lazy 2.5 KB
./testing utils.js lazy 1.8 KB
./tsdown index.js initial 520 B
./type-generator index.js initial 24 KB

@databricks/appkit-ui

npm tarball (packed): 397 KB (+100 B) — gzipped download (dist + bin; excludes release-only docs/NOTICE).

dist raw gzip
JS (runtime) 428 KB 146 KB
Type declarations 266 KB (+185 B) 98 KB (+108 B)
Source maps 852 KB 285 KB
CSS 16 KB 3.2 KB
Total 1.5 MB (+185 B) 533 KB (+108 B)
Per-entry composition (consumer bundle — deps bundled, peerDeps external)
Entry Initial (gz) Lazy (gz) Total (gz) node_modules (min) Own code (min)
./js 5.3 KB 49 KB 55 KB 208 KB 14 KB
./js/beta 2.1 KB 0 B 2.1 KB 0 B 5.0 KB
./react 433 KB 49 KB 481 KB 1.3 MB 177 KB
./react/beta 4.9 KB 0 B 4.9 KB 0 B 12 KB

Chunks:

Entry Chunk Load Size (gz)
./js index.js initial 5.2 KB
./js chunk initial 120 B
./js apache-arrow lazy 49 KB
./js/beta beta.js initial 2.1 KB
./react index.js initial 431 KB
./react tslib initial 2.1 KB
./react apache-arrow lazy 49 KB
./react/beta beta.js initial 4.9 KB

@github-actions

github-actions Bot commented Oct 8, 2026

Copy link
Copy Markdown
Contributor

🤖 AppKit PR bot

🔬 Run evals

Start an eval for this PR from the evals-monitor app: Go to Evals Monitor →

📦 Try this PR's app template

Scaffolds a new app from this PR's SDK build. Run it in any folder (requires the GitHub CLI — gh auth login — and the Databricks CLI):

gh run download 37794005542 -R databricks/appkit -n appkit-template-0.87.0-pr.4c950c1-feat-modular-jobs-647 -D appkit-pr-647 \
  && unzip -o "appkit-pr-647/appkit-template-0.87.0-pr.4c950c1-feat-modular-jobs-647.zip" -d "appkit-pr-647" \
  && databricks apps init --template "appkit-pr-647"

The template pins @databricks/appkit and @databricks/appkit-ui to tarballs built from this branch, so the scaffolded app runs against this PR's code.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant