cdk-local 0.140.0 → 0.142.0

package/dist/{local-studio-BeiTYBHR.js → local-studio-CJ9NTLcC.js}

@@ -30769,6 +30769,20 @@ function warnUnsupported(distribution) {
 	else if (origin.kind === "s3-unresolved") logger.warn(`Origin '${origin.originId}' is an S3 origin with no resolvable local source (no BucketDeployment found, or its source could not be located in the cloud assembly). Pass --from-cfn-stack to serve the deployed bucket from real S3 on demand, or point it at a local directory with --origin ${origin.originId}=<dir>. Requests routed to it return 502.`);
 }
 /**
+* WARN once at boot when `--cache-origin` is set but `--from-cfn-stack` is not.
+* `--cache-origin` only feeds the deployed-S3 read-through reader, which is built
+* exclusively under `--from-cfn-stack` (see {@link resolveDeployedS3Origins}); a
+* local-BucketDeployment / `--origin <id>=<dir>` distribution serves from disk and
+* never caches. So without the state flag the flag is a silent no-op — surface that
+* (loud-but-non-fatal, like the ECR-pin / intrinsic-env-drop WARNs) so the user is
+* not misled into thinking caching is active. Not an error: `--cache-origin` is
+* harmless on its own, and in `cdkl studio` the `--from-cfn-stack` binding is
+* editable per-session, so a hard failure here would be brittle.
+*/
+function warnUnusedCacheOrigin(options) {
+	if (options.cacheOrigin === true && !isCfnFlagPresent(options)) getLogger().warn("--cache-origin has no effect without --from-cfn-stack: it caches a deployed-S3 read-through origin, which is only built under --from-cfn-stack. A local BucketDeployment / --origin <id>=<dir> origin serves from disk and is not cached. Pass --from-cfn-stack to enable the deployed-S3 origin (then --cache-origin applies), or drop --cache-origin.");
+}
+/**
 * Promote each S3 origin with no local BucketDeployment source (`s3-unresolved`)
 * to a deployed-S3 read-through origin (issue #405), building one
 * {@link S3OriginReader} per origin. This is the front/back-split path: the CDK
@@ -30897,6 +30911,7 @@ async function localStartCloudFrontCommand(target, options, extraStateProviders)
 	const profileCredentials = options.profile ? await resolveProfileCredentials(options.profile) : void 0;
 	const deployedS3 = await resolveDeployedS3Origins(initial.distribution, initial.stacks, options, profileCredentials, logger, extraStateProviders);
 	warnUnsupported(initial.distribution);
+	warnUnusedCacheOrigin(options);
 	const envOptions = {
 		...options.fromCfnStack !== void 0 && { fromCfnStack: options.fromCfnStack },
 		...options.assumeRole !== void 0 && { assumeRole: options.assumeRole },
@@ -31977,172 +31992,6 @@ function createStudioStore(bus, options = {}) {
 	};
 }
 
-//#endregion
-//#region src/local/studio-option-catalog.ts
-/**
-* Auto-derived full-flag catalog for `cdkl studio` (issue #301).
-*
-* The per-target {@link OPTION_SPECS} in `studio-option-specs.ts` is a
-* CURATED subset — the handful of flags worth a rich control (a checkbox, a
-* KV editor, an add-row list). But a command like `cdkl start-api` accepts
-* many more flags than studio renders a control for, and hiding them makes
-* the UI strictly less capable than the headless CLI.
-*
-* This module closes that gap by INTROSPECTING each runnable kind's Commander
-* command factory and emitting the complete flag list (name + description).
-* The studio UI serializes it into the page and renders, inside a collapsed
-* "All options" section, (a) the full catalog as a read-only reference and
-* (b) a raw extra-args input (see {@link tokenizeRawArgs}) so any flag the
-* curated controls don't expose can still be passed verbatim. Auto-derivation
-* means the catalog can never drift from the command's real option set.
-*
-* Session-global flags (handled by the studio Session bar / `studio-child-args`)
-* and the auto-added `--help` / `--version` are excluded — passing them per-run
-* would conflict with the session-wide wiring.
-*/
-/**
-* Long flag names handled by the session bar / `studio-child-args` (forwarded
-* to every spawned child once, session-wide). Excluded from the per-target
-* catalog so a user does not re-specify them per-run and collide with the
-* session-wide value. Plus the Commander-managed `--help` / `--version`.
-*/
-const CATALOG_EXCLUDED_FLAGS = new Set([
-	"--app",
-	"--profile",
-	"--region",
-	"--context",
-	"--from-cfn-stack",
-	"--assume-role",
-	"--help",
-	"--version"
-]);
-const KIND_FACTORIES = {
-	lambda: {
-		command: "invoke",
-		factory: createLocalInvokeCommand
-	},
-	agentcore: {
-		command: "invoke-agentcore",
-		factory: createLocalInvokeAgentCoreCommand
-	},
-	api: {
-		command: "start-api",
-		factory: createLocalStartApiCommand
-	},
-	alb: {
-		command: "start-alb",
-		factory: createLocalStartAlbCommand
-	},
-	ecs: {
-		command: "start-service",
-		factory: createLocalStartServiceCommand
-	},
-	"ecs-task": {
-		command: "run-task",
-		factory: createLocalRunTaskCommand
-	},
-	cloudfront: {
-		command: "start-cloudfront",
-		factory: createLocalStartCloudFrontCommand
-	},
-	"agentcore-ws": {
-		command: "start-agentcore",
-		factory: createLocalStartAgentCoreCommand
-	}
-};
-let cached;
-/**
-* Build (and memoize) the full per-kind flag catalog by introspecting each
-* runnable kind's Commander command factory.
-*
-* Each factory calls `setEmbedConfig(opts.embedConfig)` at construction — with
-* no opts that resets the active embed config to cdk-local defaults, which
-* would wipe a host CLI's branding. So the active config is snapshotted and
-* each factory is re-handed it: branding is preserved AND the derived flag
-* descriptions reflect the host's active branding. The `finally` restore is a
-* belt-and-suspenders against a factory that ignores the passed config.
-* Memoized: the factories are instantiated exactly once per process, not per
-* page render.
-*/
-function buildFlagCatalog() {
-	if (cached) return cached;
-	const savedEmbedConfig = getEmbedConfig();
-	try {
-		const out = {};
-		for (const kind of Object.keys(KIND_FACTORIES)) {
-			const { command, factory } = KIND_FACTORIES[kind];
-			const cmd = factory({ embedConfig: savedEmbedConfig });
-			const flags = [];
-			for (const opt of cmd.options) {
-				if (opt.hidden) continue;
-				if (opt.long && CATALOG_EXCLUDED_FLAGS.has(opt.long)) continue;
-				flags.push({
-					flags: opt.flags,
-					description: opt.description ?? ""
-				});
-			}
-			out[kind] = {
-				command,
-				flags
-			};
-		}
-		cached = out;
-		return out;
-	} finally {
-		setEmbedConfig(savedEmbedConfig);
-	}
-}
-/**
-* Tokenize a raw extra-args string into discrete argv elements, honoring
-* single / double quotes and backslash escaping so values with spaces survive
-* (`--name "two words"` -> `['--name', 'two words']`). studio spawns children
-* WITHOUT a shell (argv array), so the tokens are appended verbatim — there is
-* no shell-injection surface; the child command still validates each arg.
-*
-* Returns `[]` for an empty / whitespace-only input. Throws on an unterminated
-* quote so a malformed raw-args string fails as a clean boundary error rather
-* than spawning a child with a mis-split argv.
-*/
-function tokenizeRawArgs(raw) {
-	if (raw === void 0) return [];
-	const tokens = [];
-	let current = "";
-	let inToken = false;
-	let quote = null;
-	for (let i = 0; i < raw.length; i++) {
-		const ch = raw[i];
-		if (quote) {
-			if (ch === "\\" && quote === "\"" && i + 1 < raw.length) current += raw[++i];
-			else if (ch === quote) quote = null;
-			else current += ch;
-			continue;
-		}
-		if (ch === "\"" || ch === "'") {
-			quote = ch;
-			inToken = true;
-			continue;
-		}
-		if (ch === "\\" && i + 1 < raw.length) {
-			current += raw[++i];
-			inToken = true;
-			continue;
-		}
-		if (ch === " " || ch === "	" || ch === "\n" || ch === "\r") {
-			if (inToken) {
-				tokens.push(current);
-				current = "";
-				inToken = false;
-			}
-			continue;
-		}
-		current += ch;
-		inToken = true;
-	}
-	if (quote) throw new Error(`Raw extra args have an unterminated ${quote} quote.`);
-	if (inToken) tokens.push(current);
-	return tokens;
-}
-
 //#endregion
 //#region src/local/studio-option-specs.ts
 /**
@@ -32446,6 +32295,264 @@ function resolveEnvVars(kind, values) {
 	throw new Error(`Option '${spec.flag}' must be KEY/VALUE rows or a JSON object string.`);
 }
 
+//#endregion
+//#region src/local/studio-option-catalog.ts
+/**
+* Auto-derived full-flag catalog for `cdkl studio` (issue #301).
+*
+* The per-target {@link OPTION_SPECS} in `studio-option-specs.ts` is a
+* CURATED subset — the handful of flags worth a rich control (a checkbox, a
+* KV editor, an add-row list). But a command like `cdkl start-api` accepts
+* many more flags than studio renders a control for, and hiding them makes
+* the UI strictly less capable than the headless CLI.
+*
+* This module closes that gap by INTROSPECTING each runnable kind's Commander
+* command factory and emitting the complete flag list (name + description).
+* The studio UI serializes it into the page and renders, inside a collapsed
+* "All options" section, (a) the full catalog as a read-only reference and
+* (b) a raw extra-args input (see {@link tokenizeRawArgs}) so any flag the
+* curated controls don't expose can still be passed verbatim. Auto-derivation
+* means the catalog can never drift from the command's real option set.
+*
+* Session-global flags (handled by the studio Session bar / `studio-child-args`)
+* and the auto-added `--help` / `--version` are excluded — passing them per-run
+* would conflict with the session-wide wiring.
+*/
+/**
+* Long flag names handled by the session bar / `studio-child-args` (forwarded
+* to every spawned child once, session-wide). Excluded from the per-target
+* catalog so a user does not re-specify them per-run and collide with the
+* session-wide value. Plus the Commander-managed `--help` / `--version`.
+*/
+const CATALOG_EXCLUDED_FLAGS = new Set([
+	"--app",
+	"--profile",
+	"--region",
+	"--context",
+	"--from-cfn-stack",
+	"--assume-role",
+	"--help",
+	"--version"
+]);
+/**
+* Long flags studio INJECTS or binds itself per run, so the "All options"
+* section must NOT auto-render an editable control for them (a user-set value
+* would collide with — or break — studio's own wiring). They still appear in
+* the catalog (so it stays a complete reference), just `renderable: false`; a
+* power user can still force one via the raw extra-args input, which is
+* appended last.
+*
+* - `--event` / `--response-file`: studio writes the composed event /
+*   response-capture file and passes these itself (the invoke kinds).
+* - `--host` / `--port`: the serve-manager binds the listen host/port and the
+*   capture proxy fronts it; a user override would desync the proxy URL.
+* - `--watch`: the session-global Session-bar toggle (appended by the
+*   serve-manager from the mutable config), not a per-run flag.
+* - the `--image-*` override family: handled by the dedicated Dockerfile
+*   picker (a partial control here would produce a half-wired override).
+*/
+const CATALOG_MANAGED_FLAGS = new Set([
+	"--event",
+	"--response-file",
+	"--host",
+	"--port",
+	"--watch",
+	"--image-override",
+	"--image-build-arg",
+	"--image-build-secret",
+	"--image-target",
+	"--no-interactive-overrides",
+	"--strict-overrides"
+]);
+const KIND_FACTORIES = {
+	lambda: {
+		command: "invoke",
+		factory: createLocalInvokeCommand
+	},
+	agentcore: {
+		command: "invoke-agentcore",
+		factory: createLocalInvokeAgentCoreCommand
+	},
+	api: {
+		command: "start-api",
+		factory: createLocalStartApiCommand
+	},
+	alb: {
+		command: "start-alb",
+		factory: createLocalStartAlbCommand
+	},
+	ecs: {
+		command: "start-service",
+		factory: createLocalStartServiceCommand
+	},
+	"ecs-task": {
+		command: "run-task",
+		factory: createLocalRunTaskCommand
+	},
+	cloudfront: {
+		command: "start-cloudfront",
+		factory: createLocalStartCloudFrontCommand
+	},
+	"agentcore-ws": {
+		command: "start-agentcore",
+		factory: createLocalStartAgentCoreCommand
+	}
+};
+let cached;
+/**
+* Parse the value-token placeholder out of a Commander flags string for a
+* value-taking option: `-e, --event <file>` -> `file`,
+* `--platform <platform>` -> `platform`, `--lb-port <listener=host>` ->
+* `listener=host`. The trailing `...` of a variadic token is dropped. Returns
+* undefined for a boolean flag (no `<...>` / `[...]` token), so the input
+* placeholder falls back to a generic hint.
+*/
+function parseFlagPlaceholder(flags) {
+	const m = /[<[]([^>\]]+)[>\]]/.exec(flags);
+	if (!m || m[1] === void 0) return void 0;
+	return m[1].replace(/\.\.\.$/, "").trim() || void 0;
+}
+/**
+* Build (and memoize) the full per-kind flag catalog by introspecting each
+* runnable kind's Commander command factory.
+*
+* Each factory calls `setEmbedConfig(opts.embedConfig)` at construction — with
+* no opts that resets the active embed config to cdk-local defaults, which
+* would wipe a host CLI's branding. So the active config is snapshotted and
+* each factory is re-handed it: branding is preserved AND the derived flag
+* descriptions reflect the host's active branding. The `finally` restore is a
+* belt-and-suspenders against a factory that ignores the passed config.
+* Memoized: the factories are instantiated exactly once per process, not per
+* page render.
+*/
+function buildFlagCatalog() {
+	if (cached) return cached;
+	const savedEmbedConfig = getEmbedConfig();
+	try {
+		const out = {};
+		for (const kind of Object.keys(KIND_FACTORIES)) {
+			const { command, factory } = KIND_FACTORIES[kind];
+			const cmd = factory({ embedConfig: savedEmbedConfig });
+			const curated = new Set((OPTION_SPECS[kind] ?? []).map((s) => s.flag));
+			const flags = [];
+			for (const opt of cmd.options) {
+				if (opt.hidden) continue;
+				if (opt.long && CATALOG_EXCLUDED_FLAGS.has(opt.long)) continue;
+				const long = opt.long ?? "";
+				const takesValue = Boolean(opt.required || opt.optional);
+				const negate = Boolean(opt.negate);
+				const variadic = Boolean(opt.variadic);
+				const choices = Array.isArray(opt.argChoices) ? [...opt.argChoices] : void 0;
+				const placeholder = parseFlagPlaceholder(opt.flags);
+				const renderable = long !== "" && !curated.has(long) && !CATALOG_MANAGED_FLAGS.has(long);
+				const info = {
+					flags: opt.flags,
+					description: opt.description ?? "",
+					long,
+					takesValue,
+					negate,
+					variadic,
+					renderable
+				};
+				if (placeholder !== void 0) info.placeholder = placeholder;
+				if (choices) info.choices = choices;
+				flags.push(info);
+			}
+			out[kind] = {
+				command,
+				flags
+			};
+		}
+		cached = out;
+		return out;
+	} finally {
+		setEmbedConfig(savedEmbedConfig);
+	}
+}
+/**
+* Tokenize a raw extra-args string into discrete argv elements, honoring
+* single / double quotes and backslash escaping so values with spaces survive
+* (`--name "two words"` -> `['--name', 'two words']`). studio spawns children
+* WITHOUT a shell (argv array), so the tokens are appended verbatim — there is
+* no shell-injection surface; the child command still validates each arg.
+*
+* Returns `[]` for an empty / whitespace-only input. Throws on an unterminated
+* quote so a malformed raw-args string fails as a clean boundary error rather
+* than spawning a child with a mis-split argv.
+*/
+function tokenizeRawArgs(raw) {
+	if (raw === void 0) return [];
+	const tokens = [];
+	let current = "";
+	let inToken = false;
+	let quote = null;
+	for (let i = 0; i < raw.length; i++) {
+		const ch = raw[i];
+		if (quote) {
+			if (ch === "\\" && quote === "\"" && i + 1 < raw.length) current += raw[++i];
+			else if (ch === quote) quote = null;
+			else current += ch;
+			continue;
+		}
+		if (ch === "\"" || ch === "'") {
+			quote = ch;
+			inToken = true;
+			continue;
+		}
+		if (ch === "\\" && i + 1 < raw.length) {
+			current += raw[++i];
+			inToken = true;
+			continue;
+		}
+		if (ch === " " || ch === "	" || ch === "\n" || ch === "\r") {
+			if (inToken) {
+				tokens.push(current);
+				current = "";
+				inToken = false;
+			}
+			continue;
+		}
+		current += ch;
+		inToken = true;
+	}
+	if (quote) throw new Error(`Raw extra args have an unterminated ${quote} quote.`);
+	if (inToken) tokens.push(current);
+	return tokens;
+}
+/**
+* Build the argv fragment for the auto-rendered "All options" controls from the
+* UI-posted {@link CatalogValues}, validating each key against the kind's flag
+* catalog. Emits `--flag` for a checked boolean (bare/negate) flag and
+* `--flag <value>` for a non-empty value flag. Blank / false values are
+* omitted.
+*
+* Throws (→ a clean 400 at the `/api/run` boundary) on a key that is not a
+* RENDERABLE catalog flag for the kind — an unknown flag, a session-global /
+* studio-managed flag, or a curated flag (which belongs to the `options` path,
+* not here). The studio UI only ever posts renderable flags; the validation
+* guards a hand-rolled curl body. studio spawns children WITHOUT a shell, so
+* each emitted token is a discrete argv element with no injection surface.
+*/
+function buildCatalogArgs(kind, values) {
+	if (values === void 0) return [];
+	const catalog = buildFlagCatalog()[kind];
+	const byFlag = new Map((catalog?.flags ?? []).filter((f) => f.renderable).map((f) => [f.long, f]));
+	const args = [];
+	for (const [flag, value] of Object.entries(values)) {
+		const info = byFlag.get(flag);
+		if (!info) throw new Error(`Unknown / non-overridable option '${flag}' for target kind '${kind}'.`);
+		if (info.takesValue) {
+			if (typeof value !== "string") throw new Error(`Option '${flag}' must be a string value.`);
+			const trimmed = value.trim();
+			if (trimmed !== "") args.push(flag, trimmed);
+		} else {
+			if (typeof value !== "boolean") throw new Error(`Option '${flag}' must be a boolean.`);
+			if (value) args.push(flag);
+		}
+	}
+	return args;
+}
+
 //#endregion
 //#region src/local/studio-ui.ts
 /**
@@ -32781,10 +32888,18 @@ const STUDIO_CSS = `
      read — kept small as it is secondary. */
   .io-label { color: #d7dde5; font-weight: 500; overflow-wrap: anywhere; min-width: 0; }
   .io-hint { color: #e3b34a; font-size: 11px; }
-  .flag-catalog { margin-top: 8px; display: flex; flex-direction: column; gap: 2px; }
-  .flag-row { display: flex; gap: 8px; align-items: baseline; font-size: 11px; }
-  .flag-name { color: #7bd88f; font-family: ui-monospace, Menlo, monospace; white-space: nowrap; }
-  .flag-desc { color: #999; }
+  /* Auto-rendered controls for the residual (non-curated) command flags in the
+     "All options" section: one stacked row per flag (label + input/select +
+     description hint), styled to match the curated .options controls. */
+  .flag-controls { display: flex; flex-direction: column; gap: 6px; margin-bottom: 8px; }
+  .all-options input.flag-control, .all-options select.flag-control {
+    width: 100%; box-sizing: border-box; background: #111; color: #ddd; border: 1px solid #333;
+    border-radius: 3px; padding: 4px 6px; font: 12px ui-monospace, Menlo, monospace;
+  }
+  .all-options input.flag-control:focus, .all-options select.flag-control:focus {
+    outline: none; border-color: #4ec97a;
+  }
+  .all-options .opt-label { color: #9aa4ad; }
   .started-list { display: flex; flex-direction: column; gap: 3px; margin-top: 4px; }
   .started-flag { color: #7bd88f; font-family: ui-monospace, Menlo, monospace; font-size: 11px; white-space: pre-wrap; word-break: break-all; }
   .envkv-modes { display: flex; gap: 0; }
@@ -32878,7 +32993,7 @@ const STUDIO_SCRIPT = `
   // prefill (issue #398): the option map a stopped serve was last Started with
   // (serveApplied.options), so the re-rendered composer comes back filled.
   // rawPrefill is the raw-extra-args string (serveApplied.rawArgs).
-  function buildOptions(kind, prefill, rawPrefill) {
+  function buildOptions(kind, prefill, rawPrefill, catalogPrefill) {
     const specs = OPTION_SPECS[kind] || [];
     // The composer always shows an "All options" section (raw extra args + the
     // auto-derived flag reference), even for kinds with no curated controls.
@@ -33029,7 +33144,7 @@ const STUDIO_SCRIPT = `
       }
       sec.appendChild(row);
     });
-    const allOpts = buildAllOptions(kind, rawPrefill);
+    const allOpts = buildAllOptions(kind, rawPrefill, catalogPrefill);
     wrap.appendChild(allOpts.node);
     return {
       node: wrap,
@@ -33041,22 +33156,97 @@ const STUDIO_SCRIPT = `
         // body identical to before this section existed.
         return Object.keys(out).length ? out : undefined;
       },
+      collectCatalog: allOpts.collectCatalog,
       collectRaw: allOpts.collectRaw,
     };
   }
 
-  // The collapsed "All options" section: a raw extra-args input (appended
-  // verbatim to the spawned child) + the auto-derived, read-only catalog of
-  // every flag the underlying command accepts. The curated controls above
-  // cover the common flags with rich UI; this exposes the rest so the studio
-  // UI is never strictly less capable than the headless CLI (issue #301).
+  // The collapsed "All options" section. The curated controls above cover the
+  // common flags with rich UI; this section auto-renders a real control
+  // (checkbox / input / select) for EVERY other flag the underlying command
+  // accepts (the catalog's renderable flags), so the studio UI is never
+  // strictly less capable than the headless CLI AND a user does not have to
+  // hand-type "--flag value" for the long tail of simple flags. A raw
+  // extra-args input remains as the final escape hatch for anything the
+  // auto-render cannot express (issue #301 + the all-options-controls slice).
   const FLAG_CATALOG = window.__FLAG_CATALOG__ || {};
 
-  function buildAllOptions(kind, rawPrefill) {
+  function buildAllOptions(kind, rawPrefill, catalogPrefill) {
     const cat = FLAG_CATALOG[kind] || { command: '', flags: [] };
     const det = el('details', 'all-options');
     det.appendChild(el('summary', null, 'All options'));
 
+    // Auto-rendered controls for every renderable (non-curated, non-managed)
+    // flag. The collected value map is keyed by the long flag.
+    const catGetters = [];
+    const renderable = (cat.flags || []).filter(function (f) {
+      return f.renderable;
+    });
+    const preCat = function (flag) {
+      return catalogPrefill ? catalogPrefill[flag] : undefined;
+    };
+    if (renderable.length) {
+      const grid = el('div', 'flag-controls');
+      renderable.forEach(function (f) {
+        const row = el('div', 'opt-row opt-col');
+        if (!f.takesValue) {
+          // Boolean (bare / negate) flag -> checkbox; emits the bare flag.
+          const cb = el('input');
+          cb.type = 'checkbox';
+          if (preCat(f.long) === true) {
+            cb.checked = true;
+            det.open = true;
+          }
+          const lab = el('label', 'opt-bool');
+          lab.appendChild(cb);
+          lab.appendChild(document.createTextNode(' ' + f.long));
+          row.appendChild(lab);
+          catGetters.push(function () {
+            return [f.long, cb.checked];
+          });
+        } else if (f.choices && f.choices.length) {
+          // Value flag with a fixed choice set -> select (blank = unset).
+          row.appendChild(el('span', 'opt-label', f.long));
+          const sel = el('select', 'flag-control');
+          const none = el('option', null, '(default)');
+          none.value = '';
+          sel.appendChild(none);
+          f.choices.forEach(function (c) {
+            const o = el('option', null, c);
+            o.value = c;
+            sel.appendChild(o);
+          });
+          const pv = preCat(f.long);
+          if (pv != null && pv !== '') {
+            sel.value = String(pv);
+            det.open = true;
+          }
+          row.appendChild(sel);
+          catGetters.push(function () {
+            return [f.long, sel.value];
+          });
+        } else {
+          // Value flag -> text input. The placeholder is the flag's own value
+          // token (e.g. file, from the flags' angle-bracket token).
+          row.appendChild(el('span', 'opt-label', f.long));
+          const inp = el('input', 'flag-control');
+          inp.placeholder = f.placeholder || 'value';
+          const pv = preCat(f.long);
+          if (pv != null && pv !== '') {
+            inp.value = String(pv);
+            det.open = true;
+          }
+          row.appendChild(inp);
+          catGetters.push(function () {
+            return [f.long, inp.value];
+          });
+        }
+        if (f.description) row.appendChild(el('div', 'opt-hint', f.description));
+        grid.appendChild(row);
+      });
+      det.appendChild(grid);
+    }
+
     const rawRow = el('div', 'opt-row opt-col');
     rawRow.appendChild(el('span', 'opt-label', 'Raw extra args'));
     const rawIn = el('input', 'raw-args');
@@ -33073,20 +33263,25 @@ const STUDIO_SCRIPT = `
     rawRow.appendChild(el('div', 'opt-hint', hint));
     det.appendChild(rawRow);
 
-    if (cat.flags.length) {
-      const ref = el('div', 'flag-catalog');
-      ref.appendChild(el('div', 'opt-label', 'Available flags'));
-      cat.flags.forEach(function (f) {
-        const row = el('div', 'flag-row');
-        row.appendChild(el('code', 'flag-name', f.flags));
-        if (f.description) row.appendChild(el('span', 'flag-desc', f.description));
-        ref.appendChild(row);
-      });
-      det.appendChild(ref);
-    }
-
     return {
       node: det,
+      // Collect the auto-rendered control values, omitting unset ones (an
+      // unchecked checkbox / a blank input or select) so the posted map carries
+      // only flags the user actually set. Returns undefined when nothing is set.
+      collectCatalog: function () {
+        const out = {};
+        catGetters.forEach(function (g) {
+          const kv = g();
+          const flag = kv[0];
+          const val = kv[1];
+          if (typeof val === 'boolean') {
+            if (val) out[flag] = true;
+          } else if (typeof val === 'string' && val.trim() !== '') {
+            out[flag] = val.trim();
+          }
+        });
+        return Object.keys(out).length ? out : undefined;
+      },
       collectRaw: function () {
         const v = rawIn.value.trim();
         return v === '' ? undefined : v;
@@ -33505,6 +33700,16 @@ const STUDIO_SCRIPT = `
         }
       });
     }
+    // Auto-rendered "All options" controls (the catalog flags). Surface each
+    // set flag so the running view does not look like the picks vanished (the
+    // issue #356 contract): the bare flag for a checked boolean, flag + value
+    // otherwise.
+    if (applied && applied.catalogArgs) {
+      Object.keys(applied.catalogArgs).forEach(function (flag) {
+        const v = applied.catalogArgs[flag];
+        lines.push(v === true ? flag : flag + ' ' + v);
+      });
+    }
     if (applied && applied.imageOverride) {
       lines.push('--image-override ' + applied.imageOverride);
     }
@@ -33523,7 +33728,7 @@ const STUDIO_SCRIPT = `
     return lines;
   }
 
-  async function startServe(id, options, rawArgs, imageOverride, imageOverrides) {
+  async function startServe(id, options, catalogArgs, rawArgs, imageOverride, imageOverrides) {
     // The serve kind (api / alb / ecs) drives which headless command the
     // server spawns; it is recorded on the row when the target list loads.
     const meta = serveMeta.get(id);
@@ -33539,6 +33744,7 @@ const STUDIO_SCRIPT = `
     const watchEl = document.getElementById('sess-watch');
     serveApplied.set(id, {
       options: options,
+      catalogArgs: catalogArgs,
       rawArgs: rawArgs,
       imageOverride: imageOverride,
       imageOverrides: imageOverrides,
@@ -33553,6 +33759,7 @@ const STUDIO_SCRIPT = `
     try {
       const body = { targetId: id, kind };
       if (options) body.options = options;
+      if (catalogArgs) body.catalogArgs = catalogArgs;
       if (rawArgs) body.rawArgs = rawArgs;
       if (imageOverride) body.imageOverride = imageOverride;
       if (imageOverrides) body.imageOverrides = imageOverrides;
@@ -33659,6 +33866,7 @@ const STUDIO_SCRIPT = `
     }
     // Per-run options are only set before a start; collected on the Start click.
     let collectOpts = function () { return undefined; };
+    let collectCatalog = function () { return undefined; };
     let collectRaw = function () { return undefined; };
     let collectImageOverride = function () { return undefined; };
     let collectImageOverrides = function () { return undefined; };
@@ -33672,7 +33880,14 @@ const STUDIO_SCRIPT = `
         serveState.set(id, { status: 'stopped', endpoints: [] });
         renderServeWorkspace(id);
       } else {
-        startServe(id, collectOpts(), collectRaw(), collectImageOverride(), collectImageOverrides());
+        startServe(
+          id,
+          collectOpts(),
+          collectCatalog(),
+          collectRaw(),
+          collectImageOverride(),
+          collectImageOverrides()
+        );
       }
     };
     head.appendChild(btn);
@@ -33712,9 +33927,15 @@ const STUDIO_SCRIPT = `
         ws.appendChild(io.node);
         collectImageOverrides = io.collect;
       }
-      const opt = buildOptions(kind, applied && applied.options, applied && applied.rawArgs);
+      const opt = buildOptions(
+        kind,
+        applied && applied.options,
+        applied && applied.rawArgs,
+        applied && applied.catalogArgs
+      );
       if (opt.node) ws.appendChild(opt.node);
       collectOpts = opt.collect;
+      collectCatalog = opt.collectCatalog;
       collectRaw = opt.collectRaw;
     }
 
@@ -34333,7 +34554,7 @@ const STUDIO_SCRIPT = `
     // target; per-run options are not carried over, so the options section is
     // omitted (the payload is the thing being tweaked). A fresh invoke keeps
     // the per-run options (e.g. env vars) below the event, above Invoke.
-    let opt = { collect: undefined, collectRaw: undefined };
+    let opt = { collect: undefined, collectCatalog: undefined, collectRaw: undefined };
     if (reinvokeOf) {
       composer.appendChild(
         el('div', 'opt-hint', 'Re-invoke runs the edited event through the same target (per-run options use defaults).')
@@ -34361,6 +34582,7 @@ const STUDIO_SCRIPT = `
       msg,
       result,
       collectOpts: opt.collect,
+      collectCatalog: opt.collectCatalog,
       collectRaw: opt.collectRaw,
       reinvokeOf: reinvokeOf || null,
     };
@@ -34399,6 +34621,8 @@ const STUDIO_SCRIPT = `
         body = { targetId: id, kind, event };
         const options = active.collectOpts ? active.collectOpts() : undefined;
         if (options) body.options = options;
+        const catalogArgs = active.collectCatalog ? active.collectCatalog() : undefined;
+        if (catalogArgs) body.catalogArgs = catalogArgs;
         const rawArgs = active.collectRaw ? active.collectRaw() : undefined;
         if (rawArgs) body.rawArgs = rawArgs;
       }
@@ -35593,6 +35817,7 @@ function createStudioDispatcher(config) {
 				eventFile,
 				...buildSharedChildArgs(config, { preferAssembly: true }),
 				...buildPerRunArgs(req.kind, req.options),
+				...buildCatalogArgs(req.kind, req.catalogArgs),
 				...responseFilePath ? ["--response-file", responseFilePath] : []
 			];
 			const envVars = resolveEnvVars(req.kind, req.options);
@@ -36259,6 +36484,7 @@ function createStudioServeManager(config) {
 			...spec.portArgs,
 			...buildSharedChildArgs(config, { preferAssembly }),
 			...buildPerRunArgs(req.kind, req.options),
+			...buildCatalogArgs(req.kind, req.catalogArgs),
 			...envFile ? ["--env-vars", envFile] : [],
 			...req.imageOverride && req.imageOverride.trim() !== "" ? ["--image-override", req.targetId + "=" + req.imageOverride.trim()] : [],
 			...Object.entries(req.imageOverrides ?? {}).flatMap(([svc, df]) => df && df.trim() !== "" ? ["--image-override", svc + "=" + df.trim()] : []),
@@ -36525,7 +36751,7 @@ const STUDIO_TARGET_KINDS = [
 */
 function coerceRunRequest(body) {
 	if (typeof body !== "object" || body === null) throw new Error("Request body must be a JSON object.");
-	const { targetId, kind, event, options, rawArgs, imageOverride, imageOverrides } = body;
+	const { targetId, kind, event, options, catalogArgs, rawArgs, imageOverride, imageOverrides } = body;
 	if (typeof targetId !== "string" || targetId.trim() === "") throw new Error("Request body must include a non-empty \"targetId\" string.");
 	if (typeof kind !== "string" || !STUDIO_TARGET_KINDS.includes(kind)) throw new Error(`Request body "kind" must be one of: ${STUDIO_TARGET_KINDS.join(", ")}.`);
 	let runOptions;
@@ -36535,6 +36761,12 @@ function coerceRunRequest(body) {
 		buildPerRunArgs(kind, runOptions);
 		resolveEnvVars(kind, runOptions);
 	}
+	let runCatalogArgs;
+	if (catalogArgs !== void 0) {
+		if (typeof catalogArgs !== "object" || catalogArgs === null || Array.isArray(catalogArgs)) throw new Error("Request body \"catalogArgs\" must be a JSON object keyed by flag.");
+		runCatalogArgs = catalogArgs;
+		buildCatalogArgs(kind, runCatalogArgs);
+	}
 	let runRawArgs;
 	if (rawArgs !== void 0) {
 		if (typeof rawArgs !== "string") throw new Error("Request body \"rawArgs\" must be a string.");
@@ -36561,6 +36793,7 @@ function coerceRunRequest(body) {
 		kind,
 		event,
 		...runOptions !== void 0 ? { options: runOptions } : {},
+		...runCatalogArgs !== void 0 ? { catalogArgs: runCatalogArgs } : {},
 		...runRawArgs !== void 0 ? { rawArgs: runRawArgs } : {},
 		...runImageOverride !== void 0 ? { imageOverride: runImageOverride } : {},
 		...runImageOverrides !== void 0 ? { imageOverrides: runImageOverrides } : {}
@@ -37367,4 +37600,4 @@ function addStudioSpecificOptions(cmd) {
 
 //#endregion
 export { applyEdgeResponseResult as $, buildJwksUrlFromIssuer as $n, collectSsmParameterRefs as $r, buildCloudMapIndex as $t, startAgentCoreHttpServer as A, classifySourceChange as An, handleConnectionsRequest as Ar, addRunTaskSpecificOptions as At, idFromArn as B, buildStageMap as Bn, EcsTaskResolutionError as Br, resolveEcsAssumeRoleOption as Bt, addListSpecificOptions as C, formatStateRemedy as Ci, waitForAgentCorePing as Cn, tryParseStatus as Cr, parseLbPortOverrides as Ct, createLocalStartAgentCoreCommand as D, buildStsClientConfig as Di, computeCodeImageTag as Dn, bufferToBody as Dr, addStartServiceSpecificOptions as Dt, addStartAgentCoreSpecificOptions as E, LocalInvokeBuildError as Ei, buildAgentCoreCodeImage as En, probeHostGatewaySupport as Er, resolveAlbFrontDoor as Et, createLocalStartCloudFrontCommand as F, createWatchPredicates as Fn, architectureToPlatform as Fr, addImageOverrideOptions as Ft, classifyS3Error as G, filterRoutesByApiIdentifiers as Gn, LocalStateSourceError as Gr, enforceImageOverrideOrphans as Gt, createDeployedKvsDataSource as H, resolveEnvVars$1 as Hn, substituteAgainstStateAsync as Hr, runEcsServiceEmulator as Ht, normalizeKvsFileKeys as I, resolveApiTargetSubset as In, buildContainerImage as Ir, buildEcsImageResolutionContext$1 as It, startCloudFrontServer as J, startApiServer as Jn, rejectExplicitCfnStackWithMultipleStacks as Jr, resolveImageOverrides as Jt, createS3OriginReader as K, groupRoutesByServer as Kn, createLocalStateProvider as Kr, mergeForService as Kt, parseKvsFileOverrides as L, createAuthorizerCache as Ln, resolveRuntimeCodeMountPath as Lr, ecsClusterOption as Lt, startAgentCoreWsBridge as M, createLocalInvokeCommand as Mn, buildConnectEvent as Mr, MAX_TASKS_SUBNET_RANGE_CAP as Mt, LocalStartCloudFrontError as N, addStartApiSpecificOptions as Nn, buildDisconnectEvent as Nr, addCommonEcsServiceOptions as Nt, buildAgentCoreServeAuthCheck as O, resolveProfileCredentials as Oi, renderCodeDockerfile as On, ConnectionRegistry as Or, createLocalStartServiceCommand as Ot, addStartCloudFrontSpecificOptions as P, createLocalStartApiCommand as Pn, buildMessageEvent as Pr, addEcsAssumeRoleOptions as Pt, applyEdgeRequestResult as Q, buildCognitoJwksUrl as Qn, CfnLocalStateProvider as Qr, listPinnedTargets as Qt, parseOriginOverrides as R, createFileWatcher as Rn, resolveRuntimeFileExtension as Rr, parseMaxTasks as Rt, StudioEventBus as S, derivePseudoParametersFromRegion as Si, waitForAgentCoreHttpReady as Sn, selectIntegrationResponse as Sr, createLocalStartAlbCommand as St, formatTargetListing as T, tryResolveImageFnJoin as Ti, SUPPORTED_CODE_RUNTIMES as Tn, HOST_GATEWAY_MIN_VERSION as Tr, isApplicationLoadBalancer as Tt, resolveDeployedKvsArnByName as U, availableApiIdentifiers as Un, substituteEnvVarsFromState as Ur, ImageOverrideError as Ut, resolveKvsModulesForDistribution as V, materializeLayerFromArn as Vn, substituteAgainstState as Vr, resolveSharedSidecarCredentials as Vt, resolveDeployedOriginBucket as W, filterRoutesByApiIdentifier as Wn, substituteEnvVarsFromStateAsync as Wr, buildImageOverrideTag as Wt, serveFromStaticOrigin as X, resolveServiceIntegrationParameters as Xn, resolveCfnRegion as Xr, describePinnedImageUri as Xt, resolveErrorResponseCandidates as Y, resolveSelectionExpression as Yn, resolveCfnFallbackRegion as Yr, runImageOverrideBuilds as Yt, serveLambdaUrlOrigin as Z, defaultCredentialsLoader as Zn, resolveCfnStackName as Zr, isLocalCdkAssetImage as Zt, filterStudioTargetGroups as _, AGENTCORE_MCP_PROTOCOL as _i, parseSseForJsonRpc as _n, applyAuthorizerOverlay as _r, createCloudFrontModule as _t, createLocalStudioCommand as a, availableWebSocketApiIdentifiers as ai, attachContainerLogStreamer as an, computeRequestIdentityHash as ar, describeS3OriginDomain as at, renderStudioHtml as b, pickAgentCoreCandidateStack as bi, AGENTCORE_SESSION_ID_HEADER as bn, evaluateResponseParameters as br, addAlbSpecificOptions as bt, startStudioProxy as c, filterWebSocketApisByIdentifiers as ci, bridgeAgentCoreWs as cn, invokeTokenAuthorizer as cr, pickFunctionUrlLogicalIdFromOrigin as ct, createStudioDispatcher as d, discoverRoutes as di, A2A_PATH as dn, buildCorsConfigByApiId as dr, pickTargetFunctionLogicalId as dt, resolveSsmParameters as ei, CloudMapRegistry as en, createJwksCache as er, buildEdgeRequestEvent as et, filterStudioCustomResources as f, pickRefLogicalId as fi, a2aInvokeOnce as fn, buildCorsConfigFromCloudFrontChain as fr, resolveCloudFrontDistribution as ft, annotatePinnedEcsTargets as g, AGENTCORE_HTTP_PROTOCOL as gi, mcpInvokeOnce as gn, translateLambdaResponse as gr, stripCloudFrontImport as gt, annotateEcsTaskPinnedTargets as h, AGENTCORE_AGUI_PROTOCOL as hi, MCP_PROTOCOL_VERSION as hn, matchRoute as hr, runViewerResponse as ht, coerceStopRequest as i, listTargets as ii, getContainerNetworkIp as in, buildMethodArn as ir, CLOUDFRONT_DISTRIBUTION_TYPE as it, attachAgentCoreWsBridge as j, addInvokeSpecificOptions as jn, parseConnectionsPath as jr, createLocalRunTaskCommand as jt, selectServeInboundAuth as k, toCmdArgv as kn, buildMgmtEndpointEnvUrl as kr, serviceStrategy as kt, relayServeRequest as l, parseSelectionExpressionPath as li, invokeAgentCoreWs as ln, attachAuthorizers as lr, pickKvsLogicalIdFromArn as lt, annotateAlbPinnedBackingServices as m, AGENTCORE_A2A_PROTOCOL as mi, MCP_PATH as mn, matchPreflight as mr, runViewerRequest as mt, coerceRunRequest as n, resolveSingleTarget as ni, SOFT_RELOAD_COMPLETION_LOG_SUFFIX as nn, verifyJwtAuthorizer as nr, edgeHeadersToHttp as nt, resolveServeBaseUrl as o, discoverWebSocketApis as oi, addInvokeAgentCoreSpecificOptions as on, evaluateCachedLambdaPolicy as or, extractKvsAssociations as ot, isCustomResourceLambdaTarget as p, resolveLambdaArnIntrinsic as pi, MCP_CONTAINER_PORT as pn, isFunctionUrlOacFronted as pr, compileCloudFrontFunction as pt, matchBehavior as q, readMtlsMaterialsFromDisk as qn, isCfnFlagPresent as qr, parseImageOverrideFlags as qt, coerceServeRequest as r, countTargets as ri, setShadowReadyTimeoutMs as rn, verifyJwtViaDiscovery as rr, httpHeadersToEdge as rt, createStudioServeManager as s, discoverWebSocketApisOrThrow as si, createLocalInvokeAgentCoreCommand as sn, invokeRequestAuthorizer as sr, isCloudFrontDistribution as st, addStudioSpecificOptions as t, resolveWatchConfig as ti, DEFAULT_SHADOW_READY_TIMEOUT_MS as tn, verifyCognitoJwt as tr, buildEdgeResponseEvent as tt, reinvoke as u, webSocketApiMatchesIdentifier as ui, A2A_CONTAINER_PORT as un, applyCorsResponseHeaders as ur, pickLambdaEdgeFunctionLogicalId as ut, startStudioServer as v, AGENTCORE_RUNTIME_TYPE as vi, AGENTCORE_SIGV4_SERVICE as vn, buildHttpApiV2Event as vr, createLocalFileKvsDataSource as vt, createLocalListCommand as w, substituteImagePlaceholders as wi, downloadAndExtractS3Bundle as wn, VtlEvaluationError as wr, resolveAlbTarget as wt, createStudioStore as x, resolveAgentCoreTarget as xi, invokeAgentCore as xn, pickResponseTemplate as xr, albStrategy as xt, toStudioTargetGroups as y, AgentCoreResolutionError as yi, signAgentCoreInvocation as yn, buildRestV1Event as yr, createUnboundCloudFrontModule as yt, resolveCloudFrontTarget as z, attachStageContext as zn, resolveRuntimeImage as zr, parseRestartPolicy as zt };
-//# sourceMappingURL=local-studio-BeiTYBHR.js.map
+//# sourceMappingURL=local-studio-CJ9NTLcC.js.map