@dbx-tools/core 0.6.88 → 0.6.89

package/README.md

@@ -107,17 +107,11 @@ targets, resources, and paths, so reading one as a process setting resolves name
 the deployed App never sees. Reference a variable from `config.env` to make it
 one.
 
-Because validation is a process spawn, it is gated on this being an AppKit
-project at all, in three steps. `@databricks/appkit` must be RESOLVABLE - it is
-an optional peer, the probe resolves the path without evaluating the module, and
-a consumer that never installed it never spawns the CLI. The bundle must then
-describe exactly ONE app carrying `config.env`, since nothing in this package
-says which of several apps a process is. Finally AppKit's execution context
-confirms the process really is that app; that context does not exist until AppKit
-boots, so only the affirmative is remembered and a lookup during boot still
-resolves from the bundle instead of being permanently denied. Setting
-`DBX_TOOLS_CONFIG_BUNDLE=true` skips this gate for a tool that wants the bundle
-without being the App.
+Bundle lookup is not coupled to AppKit installation or execution context. If
+earlier sources miss during local development, the configured working directory
+contains a bundle, and bundle reads are enabled, validation runs. This keeps
+pre-boot callers such as `@dbx-tools/appkit` auto-configuration on the same
+deterministic path as CLIs and ordinary Node consumers.
 
 Deployed Apps skip dotenv and bundle lookup after `isDatabricksAppEnv()`
 recognizes the required App name, HTTP(S) host, and valid port. Set
@@ -132,9 +126,10 @@ the default: read files outside an App and skip them inside one. Bundle reads
 also default off when `NODE_ENV=production`; set
 `DBX_TOOLS_CONFIG_BUNDLE=true` to opt into bundle validation there.
 
-Use `config.string()`, `boolean()`, `positiveNumber()`, `positiveInt()`, and
-`list()` to normalize typed options and text-based configuration through one
-rule. `config.ENV_ONLY` disables file fallbacks for exact environment reads.
+Use `config.string()`, `boolean()`, `positiveNumber()`, `positiveInt()`,
+`port()`, and `list()` to normalize typed options and text-based configuration
+through one rule. `config.port()` accepts only TCP ports from 1 through 65535;
+`config.ENV_ONLY` disables file fallbacks for exact environment reads.
 
 ## Run Commands
 

package/index.ts

@@ -13,8 +13,7 @@ export * as project from "./src/project.ts";
 export type { BinContext, BinSelectionContext, BinSelector, BinVersionOutput, BinVersionParser, BinOptions, BinUrl } from "./src/bin.ts";
 export { BrandContextSchema, defaultBrandContext, parseBrandContext, brandContextJsonSchema, brandContextPrompt } from "./src/brand.ts";
 export type { BrandContext, BrandContextInput } from "./src/brand.ts";
-export { MAX_TCP_PORT, DATABRICKS_APP_ENV_KEY, CONFIG_DOTENV_KEY, CONFIG_BUNDLE_KEY, ENV_ONLY, bundleValue, bundleResourceSchema, bundleEnvEntrySchema, bundleAppSchema } from "./src/config.ts";
-export type { ConfigKey, ConfigSource, ConfigOptions, ConfigFile } from "./src/config.ts";
+export { MAX_TCP_PORT, ENV_ONLY, valueSchema, bundleResourceSchema, bundleEnvEntrySchema, bundleAppSchema } from "./src/config.ts";
 export { COMMAND_NOT_FOUND_EXIT_CODE } from "./src/exec.ts";
 export type { ExecStdio, LineHandler, StdioOption, ExecResult, ChildProcessResult, ExecOptions, SyncExecStdio, SyncExecOptions, SpawnArgs } from "./src/exec.ts";
 export type { FileLockBackend, FileLockAcquisition, FileLockOptions } from "./src/file-lock.ts";

package/lib/index.d.ts

@@ -9,8 +9,7 @@ export * as project from "./src/project.ts";
 export type { BinContext, BinSelectionContext, BinSelector, BinVersionOutput, BinVersionParser, BinOptions, BinUrl } from "./src/bin.ts";
 export { BrandContextSchema, defaultBrandContext, parseBrandContext, brandContextJsonSchema, brandContextPrompt } from "./src/brand.ts";
 export type { BrandContext, BrandContextInput } from "./src/brand.ts";
-export { MAX_TCP_PORT, DATABRICKS_APP_ENV_KEY, CONFIG_DOTENV_KEY, CONFIG_BUNDLE_KEY, ENV_ONLY, bundleValue, bundleResourceSchema, bundleEnvEntrySchema, bundleAppSchema } from "./src/config.ts";
-export type { ConfigKey, ConfigSource, ConfigOptions, ConfigFile } from "./src/config.ts";
+export { MAX_TCP_PORT, ENV_ONLY, valueSchema, bundleResourceSchema, bundleEnvEntrySchema, bundleAppSchema } from "./src/config.ts";
 export { COMMAND_NOT_FOUND_EXIT_CODE } from "./src/exec.ts";
 export type { ExecStdio, LineHandler, StdioOption, ExecResult, ChildProcessResult, ExecOptions, SyncExecStdio, SyncExecOptions, SpawnArgs } from "./src/exec.ts";
 export type { FileLockBackend, FileLockAcquisition, FileLockOptions } from "./src/file-lock.ts";

package/lib/index.js

@@ -10,6 +10,6 @@ export * as fileLock from "./src/file-lock.js";
 export * as processLock from "./src/process-lock.js";
 export * as project from "./src/project.js";
 export { BrandContextSchema, defaultBrandContext, parseBrandContext, brandContextJsonSchema, brandContextPrompt } from "./src/brand.js";
-export { MAX_TCP_PORT, DATABRICKS_APP_ENV_KEY, CONFIG_DOTENV_KEY, CONFIG_BUNDLE_KEY, ENV_ONLY, bundleValue, bundleResourceSchema, bundleEnvEntrySchema, bundleAppSchema } from "./src/config.js";
+export { MAX_TCP_PORT, ENV_ONLY, valueSchema, bundleResourceSchema, bundleEnvEntrySchema, bundleAppSchema } from "./src/config.js";
 export { COMMAND_NOT_FOUND_EXIT_CODE } from "./src/exec.js";
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwyQ0FBMkM7QUFDM0MsbURBQW1EO0FBQ25ELHdFQUF3RTtBQUV4RSxPQUFPLEtBQUssR0FBRyxNQUFNLGNBQWMsQ0FBQztBQUNwQyxPQUFPLEtBQUssS0FBSyxNQUFNLGdCQUFnQixDQUFDO0FBQ3hDLE9BQU8sS0FBSyxNQUFNLE1BQU0saUJBQWlCLENBQUM7QUFDMUMsT0FBTyxLQUFLLElBQUksTUFBTSxlQUFlLENBQUM7QUFDdEMsT0FBTyxLQUFLLElBQUksTUFBTSxlQUFlLENBQUM7QUFDdEMsT0FBTyxLQUFLLFFBQVEsTUFBTSxvQkFBb0IsQ0FBQztBQUMvQyxPQUFPLEtBQUssV0FBVyxNQUFNLHVCQUF1QixDQUFDO0FBQ3JELE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFFNUMsT0FBTyxFQUFFLGtCQUFrQixFQUFFLG1CQUFtQixFQUFFLGlCQUFpQixFQUFFLHNCQUFzQixFQUFFLGtCQUFrQixFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFFeEksT0FBTyxFQUFFLFlBQVksRUFBRSxzQkFBc0IsRUFBRSxpQkFBaUIsRUFBRSxpQkFBaUIsRUFBRSxRQUFRLEVBQUUsV0FBVyxFQUFFLG9CQUFvQixFQUFFLG9CQUFvQixFQUFFLGVBQWUsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBRWpNLE9BQU8sRUFBRSwyQkFBMkIsRUFBRSxNQUFNLGVBQWUsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIEdFTkVSQVRFRCBieSBwcm9qZW4gd2F0Y2ggLSBETyBOT1QgRURJVC5cbi8vIFJlZ2VuZXJhdGVkIGZyb20gdGhlIGV4cG9ydGluZyBtb2R1bGVzIGluIC4vc3JjLlxuLy8gSGFuZCBlZGl0cyBhcmUgb3ZlcndyaXR0ZW4gb24gdGhlIG5leHQgd2F0Y2g7IHRoaXMgZmlsZSBpcyByZWFkLW9ubHkuXG5cbmV4cG9ydCAqIGFzIGJpbiBmcm9tIFwiLi9zcmMvYmluLnRzXCI7XG5leHBvcnQgKiBhcyBicmFuZCBmcm9tIFwiLi9zcmMvYnJhbmQudHNcIjtcbmV4cG9ydCAqIGFzIGNvbmZpZyBmcm9tIFwiLi9zcmMvY29uZmlnLnRzXCI7XG5leHBvcnQgKiBhcyBleGVjIGZyb20gXCIuL3NyYy9leGVjLnRzXCI7XG5leHBvcnQgKiBhcyBmaWxlIGZyb20gXCIuL3NyYy9maWxlLnRzXCI7XG5leHBvcnQgKiBhcyBmaWxlTG9jayBmcm9tIFwiLi9zcmMvZmlsZS1sb2NrLnRzXCI7XG5leHBvcnQgKiBhcyBwcm9jZXNzTG9jayBmcm9tIFwiLi9zcmMvcHJvY2Vzcy1sb2NrLnRzXCI7XG5leHBvcnQgKiBhcyBwcm9qZWN0IGZyb20gXCIuL3NyYy9wcm9qZWN0LnRzXCI7XG5leHBvcnQgdHlwZSB7IEJpbkNvbnRleHQsIEJpblNlbGVjdGlvbkNvbnRleHQsIEJpblNlbGVjdG9yLCBCaW5WZXJzaW9uT3V0cHV0LCBCaW5WZXJzaW9uUGFyc2VyLCBCaW5PcHRpb25zLCBCaW5VcmwgfSBmcm9tIFwiLi9zcmMvYmluLnRzXCI7XG5leHBvcnQgeyBCcmFuZENvbnRleHRTY2hlbWEsIGRlZmF1bHRCcmFuZENvbnRleHQsIHBhcnNlQnJhbmRDb250ZXh0LCBicmFuZENvbnRleHRKc29uU2NoZW1hLCBicmFuZENvbnRleHRQcm9tcHQgfSBmcm9tIFwiLi9zcmMvYnJhbmQudHNcIjtcbmV4cG9ydCB0eXBlIHsgQnJhbmRDb250ZXh0LCBCcmFuZENvbnRleHRJbnB1dCB9IGZyb20gXCIuL3NyYy9icmFuZC50c1wiO1xuZXhwb3J0IHsgTUFYX1RDUF9QT1JULCBEQVRBQlJJQ0tTX0FQUF9FTlZfS0VZLCBDT05GSUdfRE9URU5WX0tFWSwgQ09ORklHX0JVTkRMRV9LRVksIEVOVl9PTkxZLCBidW5kbGVWYWx1ZSwgYnVuZGxlUmVzb3VyY2VTY2hlbWEsIGJ1bmRsZUVudkVudHJ5U2NoZW1hLCBidW5kbGVBcHBTY2hlbWEgfSBmcm9tIFwiLi9zcmMvY29uZmlnLnRzXCI7XG5leHBvcnQgdHlwZSB7IENvbmZpZ0tleSwgQ29uZmlnU291cmNlLCBDb25maWdPcHRpb25zLCBDb25maWdGaWxlIH0gZnJvbSBcIi4vc3JjL2NvbmZpZy50c1wiO1xuZXhwb3J0IHsgQ09NTUFORF9OT1RfRk9VTkRfRVhJVF9DT0RFIH0gZnJvbSBcIi4vc3JjL2V4ZWMudHNcIjtcbmV4cG9ydCB0eXBlIHsgRXhlY1N0ZGlvLCBMaW5lSGFuZGxlciwgU3RkaW9PcHRpb24sIEV4ZWNSZXN1bHQsIENoaWxkUHJvY2Vzc1Jlc3VsdCwgRXhlY09wdGlvbnMsIFN5bmNFeGVjU3RkaW8sIFN5bmNFeGVjT3B0aW9ucywgU3Bhd25BcmdzIH0gZnJvbSBcIi4vc3JjL2V4ZWMudHNcIjtcbmV4cG9ydCB0eXBlIHsgRmlsZUxvY2tCYWNrZW5kLCBGaWxlTG9ja0FjcXVpc2l0aW9uLCBGaWxlTG9ja09wdGlvbnMgfSBmcm9tIFwiLi9zcmMvZmlsZS1sb2NrLnRzXCI7XG5leHBvcnQgdHlwZSB7IFByb2plY3RDb250ZXh0IH0gZnJvbSBcIi4vc3JjL3Byb2plY3QudHNcIjtcbiJdfQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwyQ0FBMkM7QUFDM0MsbURBQW1EO0FBQ25ELHdFQUF3RTtBQUV4RSxPQUFPLEtBQUssR0FBRyxNQUFNLGNBQWMsQ0FBQztBQUNwQyxPQUFPLEtBQUssS0FBSyxNQUFNLGdCQUFnQixDQUFDO0FBQ3hDLE9BQU8sS0FBSyxNQUFNLE1BQU0saUJBQWlCLENBQUM7QUFDMUMsT0FBTyxLQUFLLElBQUksTUFBTSxlQUFlLENBQUM7QUFDdEMsT0FBTyxLQUFLLElBQUksTUFBTSxlQUFlLENBQUM7QUFDdEMsT0FBTyxLQUFLLFFBQVEsTUFBTSxvQkFBb0IsQ0FBQztBQUMvQyxPQUFPLEtBQUssV0FBVyxNQUFNLHVCQUF1QixDQUFDO0FBQ3JELE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFFNUMsT0FBTyxFQUFFLGtCQUFrQixFQUFFLG1CQUFtQixFQUFFLGlCQUFpQixFQUFFLHNCQUFzQixFQUFFLGtCQUFrQixFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFFeEksT0FBTyxFQUFFLFlBQVksRUFBRSxRQUFRLEVBQUUsV0FBVyxFQUFFLG9CQUFvQixFQUFFLG9CQUFvQixFQUFFLGVBQWUsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBQ25JLE9BQU8sRUFBRSwyQkFBMkIsRUFBRSxNQUFNLGVBQWUsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIEdFTkVSQVRFRCBieSBwcm9qZW4gd2F0Y2ggLSBETyBOT1QgRURJVC5cbi8vIFJlZ2VuZXJhdGVkIGZyb20gdGhlIGV4cG9ydGluZyBtb2R1bGVzIGluIC4vc3JjLlxuLy8gSGFuZCBlZGl0cyBhcmUgb3ZlcndyaXR0ZW4gb24gdGhlIG5leHQgd2F0Y2g7IHRoaXMgZmlsZSBpcyByZWFkLW9ubHkuXG5cbmV4cG9ydCAqIGFzIGJpbiBmcm9tIFwiLi9zcmMvYmluLnRzXCI7XG5leHBvcnQgKiBhcyBicmFuZCBmcm9tIFwiLi9zcmMvYnJhbmQudHNcIjtcbmV4cG9ydCAqIGFzIGNvbmZpZyBmcm9tIFwiLi9zcmMvY29uZmlnLnRzXCI7XG5leHBvcnQgKiBhcyBleGVjIGZyb20gXCIuL3NyYy9leGVjLnRzXCI7XG5leHBvcnQgKiBhcyBmaWxlIGZyb20gXCIuL3NyYy9maWxlLnRzXCI7XG5leHBvcnQgKiBhcyBmaWxlTG9jayBmcm9tIFwiLi9zcmMvZmlsZS1sb2NrLnRzXCI7XG5leHBvcnQgKiBhcyBwcm9jZXNzTG9jayBmcm9tIFwiLi9zcmMvcHJvY2Vzcy1sb2NrLnRzXCI7XG5leHBvcnQgKiBhcyBwcm9qZWN0IGZyb20gXCIuL3NyYy9wcm9qZWN0LnRzXCI7XG5leHBvcnQgdHlwZSB7IEJpbkNvbnRleHQsIEJpblNlbGVjdGlvbkNvbnRleHQsIEJpblNlbGVjdG9yLCBCaW5WZXJzaW9uT3V0cHV0LCBCaW5WZXJzaW9uUGFyc2VyLCBCaW5PcHRpb25zLCBCaW5VcmwgfSBmcm9tIFwiLi9zcmMvYmluLnRzXCI7XG5leHBvcnQgeyBCcmFuZENvbnRleHRTY2hlbWEsIGRlZmF1bHRCcmFuZENvbnRleHQsIHBhcnNlQnJhbmRDb250ZXh0LCBicmFuZENvbnRleHRKc29uU2NoZW1hLCBicmFuZENvbnRleHRQcm9tcHQgfSBmcm9tIFwiLi9zcmMvYnJhbmQudHNcIjtcbmV4cG9ydCB0eXBlIHsgQnJhbmRDb250ZXh0LCBCcmFuZENvbnRleHRJbnB1dCB9IGZyb20gXCIuL3NyYy9icmFuZC50c1wiO1xuZXhwb3J0IHsgTUFYX1RDUF9QT1JULCBFTlZfT05MWSwgdmFsdWVTY2hlbWEsIGJ1bmRsZVJlc291cmNlU2NoZW1hLCBidW5kbGVFbnZFbnRyeVNjaGVtYSwgYnVuZGxlQXBwU2NoZW1hIH0gZnJvbSBcIi4vc3JjL2NvbmZpZy50c1wiO1xuZXhwb3J0IHsgQ09NTUFORF9OT1RfRk9VTkRfRVhJVF9DT0RFIH0gZnJvbSBcIi4vc3JjL2V4ZWMudHNcIjtcbmV4cG9ydCB0eXBlIHsgRXhlY1N0ZGlvLCBMaW5lSGFuZGxlciwgU3RkaW9PcHRpb24sIEV4ZWNSZXN1bHQsIENoaWxkUHJvY2Vzc1Jlc3VsdCwgRXhlY09wdGlvbnMsIFN5bmNFeGVjU3RkaW8sIFN5bmNFeGVjT3B0aW9ucywgU3Bhd25BcmdzIH0gZnJvbSBcIi4vc3JjL2V4ZWMudHNcIjtcbmV4cG9ydCB0eXBlIHsgRmlsZUxvY2tCYWNrZW5kLCBGaWxlTG9ja0FjcXVpc2l0aW9uLCBGaWxlTG9ja09wdGlvbnMgfSBmcm9tIFwiLi9zcmMvZmlsZS1sb2NrLnRzXCI7XG5leHBvcnQgdHlwZSB7IFByb2plY3RDb250ZXh0IH0gZnJvbSBcIi4vc3JjL3Byb2plY3QudHNcIjtcbiJdfQ==

package/lib/src/config.d.ts

@@ -3,8 +3,8 @@
  *
  * Every package resolves settings the same way: take the caller's value, else
  * an environment variable, else a default. Local development adds two fallback
- * locations: `.env` files and `resources.apps.<app>.config.env` or root
- * `variables` in `databricks.yml`.
+ * locations: `.env` files and one App's `resources.apps.<app>.config.env` in
+ * `databricks.yml`.
  *
  * Two things make it cheap to call from a hot path:
  *
@@ -20,24 +20,6 @@
  * CLI is not on the image. Boolean environment overrides can force either file
  * source on or off when a tool needs different behavior.
  *
- * The bundle is gated on this being an AppKit project at all. `databricks bundle
- * validate` is a process spawn measured in seconds, and a plain library or CLI
- * consumer has no bundle to find, so the gate runs in three steps before the
- * spawn is allowed - see {@link bundleFile}:
- *
- *   1. `@databricks/appkit` is resolved WITHOUT evaluating it. It is an optional
- *      peer, so a consumer that never installed it is not an AppKit project and
- *      the bundle is never loaded. The probe is cached, so this costs one
- *      resolution for the life of the process.
- *   2. The bundle is read (once per context) and must describe EXACTLY ONE app
- *      with `config.env`. Nothing here says which of several apps this process
- *      is, so an ambiguous bundle contributes nothing rather than a guess.
- *   3. AppKit's execution context confirms this process really is that app. The
- *      context does not exist until AppKit boots and `getExecutionContext()`
- *      THROWS until then, so the probe is caught and only the affirmative is
- *      remembered - a lookup before boot still resolves, and re-confirms later
- *      once the context is available.
- *
  * Only the single app's `config.env` is consulted. Root bundle `variables` are
  * not: they are authoring inputs for the bundle itself (interpolated into
  * targets, resources, and paths), so treating one as a process setting resolves
@@ -48,40 +30,34 @@
  * @module
  */
 import { z } from "zod";
-export type ConfigKey = string | readonly string[];
+type ConfigKey = string | readonly string[];
 /** Where a value may come from, consulted in the order given. */
-export type ConfigSource = "env" | "dotenv" | "bundle";
-export interface ConfigOptions {
+type ConfigSource = "env" | "dotenv" | "bundle";
+interface ConfigOptions {
     /**
      * Outermost namespaces tried before each key. Defaults to `DBX_TOOLS`.
      */
     scope?: string | readonly string[];
     /** Capability namespaces inserted after the scope and before each key. */
     prefix?: string | readonly string[];
-    /** Directory to resolve `.env` and the bundle from. Default: `process.cwd()`. */
-    cwd?: string;
     /** Sources in precedence order. Default: `env`, `dotenv`, `bundle`. */
     sources?: ConfigSource | readonly ConfigSource[];
+    /** Directory to resolve `.env` and the bundle from. Default: `process.cwd()`. */
+    cwd?: string;
 }
 /** A config file found on disk, with its parsed contents. */
-export interface ConfigFile {
+interface ConfigFile {
     path: string;
     data: Record<string, unknown>;
 }
 /** Highest valid TCP port number. */
 export declare const MAX_TCP_PORT = 65535;
-/** Boolean environment override for {@link isDatabricksAppEnv}. */
-export declare const DATABRICKS_APP_ENV_KEY = "DBX_TOOLS_DATABRICKS_APP_ENV";
-/** Boolean environment override for project `.env` reads. */
-export declare const CONFIG_DOTENV_KEY = "DBX_TOOLS_CONFIG_DOTENV";
-/** Boolean environment override for Databricks bundle reads. */
-export declare const CONFIG_BUNDLE_KEY = "DBX_TOOLS_CONFIG_BUNDLE";
 /** Exact process-environment lookup for callers that do not read local config files. */
 export declare const ENV_ONLY: {
     scope: readonly [];
     sources: "env";
 };
-export declare const bundleValue: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+export declare const valueSchema: z.ZodString;
 /**
  * The GENERIC shape of a bundle resource: a name, and whatever else the resource
  * type carries. Deliberately unopinionated and `passthrough()` - the concrete
@@ -90,25 +66,24 @@ export declare const bundleValue: z.ZodPipe<z.ZodString, z.ZodTransform<string,
  * node-appkit `.extend()`s this rather than this module knowing about them.
  */
 export declare const bundleResourceSchema: z.ZodObject<{
-    name: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    name: z.ZodOptional<z.ZodString>;
 }, z.core.$loose>;
 export declare const bundleEnvEntrySchema: z.ZodObject<{
-    name: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    name: z.ZodOptional<z.ZodString>;
     value: z.ZodOptional<z.ZodString>;
-    value_from: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    value_from: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const bundleAppSchema: z.ZodObject<{
-    name: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
-    source_code_path: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
     config: z.ZodOptional<z.ZodObject<{
         env: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            name: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+            name: z.ZodOptional<z.ZodString>;
             value: z.ZodOptional<z.ZodString>;
-            value_from: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+            value_from: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
     resources: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        name: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+        name: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>>;
 }, z.core.$strip>;
 /**
@@ -162,6 +137,12 @@ export declare function positiveNumber(configured: unknown, input: ConfigKey, fa
  * these are ceilings where a sane default beats a boot failure.
  */
 export declare function positiveInt(configured: unknown, input: ConfigKey, fallback: number, options?: ConfigOptions): number;
+/**
+ * Resolve a TCP port between 1 and {@link MAX_TCP_PORT}. Invalid configured or
+ * sourced values fall back to the caller's default, which may be a sentinel
+ * such as `0` when the caller uses one.
+ */
+export declare function port(configured: unknown, input: ConfigKey, fallback: number, options?: ConfigOptions): number;
 /**
  * Resolve a list through `string.parseList`, so an array from typed config and a
  * `"a, b c"` string normalize identically. `[]` when neither source has entries.
@@ -171,16 +152,9 @@ export declare function list(configured: string | readonly string[] | undefined
  * The Databricks bundle output for `cwd` - `databricks bundle validate --output
  * json` run from the directory holding `databricks.yml`, with the config file's
  * path. A non-zero validation may still return partial JSON with usable App
- * config. `undefined` when bundle reads are disabled, this is not an AppKit
- * project, the bundle does not describe exactly one app with `config.env`, there
- * is no bundle, or the CLI produces no JSON.
- *
- * The spawn is guarded because it is expensive and usually pointless. In order:
- * `@databricks/appkit` must be RESOLVABLE (no AppKit, no bundle - and the probe
- * never evaluates the module); the bundle must describe exactly ONE app carrying
- * `config.env`; and AppKit's execution context must confirm this process is that
- * app. Only the confirmation is remembered, so a lookup during boot - before any
- * context exists - still resolves from the bundle and re-confirms later.
+ * config. `undefined` when bundle reads are disabled, the process is production
+ * or a deployed App without an explicit override, there is no bundle, or the
+ * CLI produces no JSON.
  *
  * Cached once per resolved working-directory context and
  * `DATABRICKS_CONFIG_PROFILE` through {@link context.cached}, so repeated
@@ -188,3 +162,4 @@ export declare function list(configured: string | readonly string[] | undefined
  * context's bundle.
  */
 export declare function bundleFile(cwd?: string | null): ConfigFile | undefined;
+export {};