cdk-local 0.94.0 → 0.95.0

package/dist/{local-studio-MTJUk4NF.js → local-studio-Dd271q0Z.js}

@@ -28024,6 +28024,160 @@ 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
+	}
+};
+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
 /**
@@ -28407,6 +28561,20 @@ const STUDIO_CSS = `
   .pair-add { align-self: flex-start; background: #1d1d1d; color: #7bd88f; border: 1px solid #2f4030;
     border-radius: 3px; cursor: pointer; padding: 3px 9px; font: 12px ui-monospace, monospace; }
   .pair-add:hover { background: #243024; }
+  details.all-options { margin: 8px 0; border-top: 1px solid #2a2a2a; padding-top: 6px; }
+  details.all-options > summary { color: #8a8a8a; font-size: 12px; cursor: pointer; user-select: none; }
+  details.all-options > summary:hover { color: #bbb; }
+  .all-options .opt-row { display: flex; flex-direction: column; align-items: stretch; gap: 4px; margin: 6px 0; }
+  .all-options input.raw-args {
+    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.raw-args:focus { outline: none; border-color: #4ec97a; }
+  .opt-hint { color: #777; 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; }
   .envkv-modes { display: flex; gap: 0; }
   .envkv-mode { background: #1a1a1a; color: #999; border: 1px solid #333; cursor: pointer;
     padding: 3px 12px; font: 11px ui-monospace, monospace; }
@@ -28447,9 +28615,14 @@ const STUDIO_SCRIPT = `
 
   function buildOptions(kind) {
     const specs = OPTION_SPECS[kind] || [];
-    if (!specs.length) return { node: null, collect: function () { return undefined; } };
+    // The composer always shows an "All options" section (raw extra args + the
+    // auto-derived flag reference), even for kinds with no curated controls.
+    const wrap = el('div', 'options-wrap');
     const sec = el('div', 'section options');
-    sec.appendChild(el('h3', null, 'Options'));
+    if (specs.length) {
+      sec.appendChild(el('h3', null, 'Options'));
+      wrap.appendChild(sec);
+    }
     const getters = [];
     const bools = {};
 
@@ -28565,12 +28738,62 @@ const STUDIO_SCRIPT = `
       }
       sec.appendChild(row);
     });
+    const allOpts = buildAllOptions(kind);
+    wrap.appendChild(allOpts.node);
     return {
-      node: sec,
+      node: wrap,
       collect: function () {
         const out = {};
         getters.forEach(function (g) { const kv = g(); out[kv[0]] = kv[1]; });
-        return out;
+        // Omit-when-empty: a kind with no curated controls (e.g. api) collects
+        // nothing, so return undefined rather than {} to keep the run/serve
+        // body identical to before this section existed.
+        return Object.keys(out).length ? out : undefined;
+      },
+      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).
+  const FLAG_CATALOG = window.__FLAG_CATALOG__ || {};
+
+  function buildAllOptions(kind) {
+    const cat = FLAG_CATALOG[kind] || { command: '', flags: [] };
+    const det = el('details', 'all-options');
+    det.appendChild(el('summary', null, 'All options'));
+
+    const rawRow = el('div', 'opt-row opt-col');
+    rawRow.appendChild(el('span', 'opt-label', 'Raw extra args'));
+    const rawIn = el('input', 'raw-args');
+    rawIn.placeholder = '--flag value --other "with spaces"';
+    rawRow.appendChild(rawIn);
+    const hint = cat.command
+      ? 'Appended verbatim to the spawned ' + cat.command + ' command. Quote values with spaces.'
+      : 'Appended verbatim to the spawned command. Quote values with spaces.';
+    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,
+      collectRaw: function () {
+        const v = rawIn.value.trim();
+        return v === '' ? undefined : v;
       },
     };
   }
@@ -28696,7 +28919,7 @@ const STUDIO_SCRIPT = `
     }
   }
 
-  async function startServe(id, options) {
+  async function startServe(id, options, rawArgs) {
     // 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);
@@ -28706,6 +28929,7 @@ const STUDIO_SCRIPT = `
     try {
       const body = { targetId: id, kind };
       if (options) body.options = options;
+      if (rawArgs) body.rawArgs = rawArgs;
       const res = await fetch('/api/run', {
         method: 'POST',
         headers: { 'content-type': 'application/json' },
@@ -28762,7 +28986,8 @@ const STUDIO_SCRIPT = `
       : el('button', null, starting ? 'Starting…' : 'Start');
     // Per-run options are only set before a start; collected on the Start click.
     let collectOpts = function () { return undefined; };
-    btn.onclick = () => { if (running || starting) stopServe(id); else startServe(id, collectOpts()); };
+    let collectRaw = function () { return undefined; };
+    btn.onclick = () => { if (running || starting) stopServe(id); else startServe(id, collectOpts(), collectRaw()); };
     head.appendChild(btn);
     if (errMsg) {
       const m = el('div', 'err', errMsg);
@@ -28774,6 +28999,7 @@ const STUDIO_SCRIPT = `
       const opt = buildOptions(kind);
       if (opt.node) ws.appendChild(opt.node);
       collectOpts = opt.collect;
+      collectRaw = opt.collectRaw;
     }
 
     const isEcs = meta && meta.kind === 'ecs';
@@ -28973,7 +29199,7 @@ const STUDIO_SCRIPT = `
     ws.appendChild(composer);
     ws.appendChild(result);
 
-    active = { id, kind, ta, btn, msg, result, collectOpts: opt.collect };
+    active = { id, kind, ta, btn, msg, result, collectOpts: opt.collect, collectRaw: opt.collectRaw };
     btn.onclick = () => runInvoke();
     shownInvId = null;
     shownDetailId = null;
@@ -28998,6 +29224,8 @@ const STUDIO_SCRIPT = `
       const body = { targetId: id, kind, event };
       const options = active.collectOpts ? active.collectOpts() : undefined;
       if (options) body.options = options;
+      const rawArgs = active.collectRaw ? active.collectRaw() : undefined;
+      if (rawArgs) body.rawArgs = rawArgs;
       const res = await fetch('/api/run', {
         method: 'POST',
         headers: { 'content-type': 'application/json' },
@@ -29396,6 +29624,7 @@ function renderStudioHtml(appLabel, cliName) {
   </section>
 </main>
 <script>window.__OPTION_SPECS__ = ${JSON.stringify(OPTION_SPECS).replace(/</g, "\\u003c")};<\/script>
+<script>window.__FLAG_CATALOG__ = ${JSON.stringify(buildFlagCatalog()).replace(/</g, "\\u003c")};<\/script>
 <script>${STUDIO_SCRIPT}<\/script>
 </body>
 </html>`;
@@ -29815,6 +30044,7 @@ function createStudioDispatcher(config) {
 				writeFileSync(envFile, JSON.stringify(envVars));
 				args.push("--env-vars", envFile);
 			}
+			args.push(...tokenizeRawArgs(req.rawArgs));
 			const { code, stdout, stderr } = await runChild(spawnFn, nodeBin, [config.cliEntry, ...args], config.cwd ?? process.cwd(), invocationId, req.targetId, config.bus, clock);
 			const durationMs = clock() - startedAt;
 			const ok = code === 0;
@@ -30300,7 +30530,8 @@ function createStudioServeManager(config) {
 			...spec.portArgs,
 			...buildSharedChildArgs(config),
 			...buildPerRunArgs(req.kind, req.options),
-			...config.watch === true ? ["--watch"] : []
+			...config.watch === true ? ["--watch"] : [],
+			...tokenizeRawArgs(req.rawArgs)
 		];
 	}
 	async function start(req) {
@@ -30521,7 +30752,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 } = body;
+	const { targetId, kind, event, options, rawArgs } = 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;
@@ -30531,11 +30762,18 @@ function coerceRunRequest(body) {
 		buildPerRunArgs(kind, runOptions);
 		resolveEnvVars(kind, runOptions);
 	}
+	let runRawArgs;
+	if (rawArgs !== void 0) {
+		if (typeof rawArgs !== "string") throw new Error("Request body \"rawArgs\" must be a string.");
+		tokenizeRawArgs(rawArgs);
+		runRawArgs = rawArgs;
+	}
 	return {
 		targetId,
 		kind,
 		event,
-		...runOptions !== void 0 ? { options: runOptions } : {}
+		...runOptions !== void 0 ? { options: runOptions } : {},
+		...runRawArgs !== void 0 ? { rawArgs: runRawArgs } : {}
 	};
 }
 /**
@@ -30747,4 +30985,4 @@ function addStudioSpecificOptions(cmd) {
 
 //#endregion
 export { SOFT_RELOAD_COMPLETION_LOG_SUFFIX as $, listTargets as $n, buildMethodArn as $t, addCommonEcsServiceOptions as A, architectureToPlatform as An, createWatchPredicates as At, ImageOverrideError as B, LocalStateSourceError as Bn, filterRoutesByApiIdentifiers as Bt, resolveAlbFrontDoor as C, ConnectionRegistry as Cn, resolveProfileCredentials as Cr, renderCodeDockerfile as Ct, addRunTaskSpecificOptions as D, buildConnectEvent as Dn, createLocalInvokeCommand as Dt, serviceStrategy as E, parseConnectionsPath as En, addInvokeSpecificOptions as Et, parseMaxTasks as F, EcsTaskResolutionError as Fn, buildStageMap as Ft, resolveImageOverrides as G, resolveCfnRegion as Gn, resolveServiceIntegrationParameters as Gt, enforceImageOverrideOrphans as H, isCfnFlagPresent as Hn, readMtlsMaterialsFromDisk as Ht, parseRestartPolicy as I, substituteAgainstState as In, materializeLayerFromArn as It, isLocalCdkAssetImage as J, collectSsmParameterRefs as Jn, buildJwksUrlFromIssuer as Jt, runImageOverrideBuilds as K, resolveCfnStackName as Kn, defaultCredentialsLoader as Kt, resolveEcsAssumeRoleOption as L, substituteAgainstStateAsync as Ln, resolveEnvVars$1 as Lt, addImageOverrideOptions as M, resolveRuntimeCodeMountPath as Mn, createAuthorizerCache as Mt, buildEcsImageResolutionContext$1 as N, resolveRuntimeFileExtension as Nn, createFileWatcher as Nt, createLocalRunTaskCommand as O, buildDisconnectEvent as On, addStartApiSpecificOptions as Ot, ecsClusterOption as P, resolveRuntimeImage as Pn, attachStageContext as Pt, DEFAULT_SHADOW_READY_TIMEOUT_MS as Q, countTargets as Qn, verifyJwtViaDiscovery as Qt, resolveSharedSidecarCredentials as R, substituteEnvVarsFromState as Rn, availableApiIdentifiers as Rt, isApplicationLoadBalancer as S, bufferToBody as Sn, buildStsClientConfig as Sr, computeCodeImageTag as St, createLocalStartServiceCommand as T, handleConnectionsRequest as Tn, classifySourceChange as Tt, mergeForService as U, rejectExplicitCfnStackWithMultipleStacks as Un, startApiServer as Ut, buildImageOverrideTag as V, createLocalStateProvider as Vn, groupRoutesByServer as Vt, parseImageOverrideFlags as W, resolveCfnFallbackRegion as Wn, resolveSelectionExpression as Wt, buildCloudMapIndex as X, resolveWatchConfig as Xn, verifyCognitoJwt as Xt, listPinnedTargets as Y, resolveSsmParameters as Yn, createJwksCache as Yt, CloudMapRegistry as Z, resolveSingleTarget as Zn, verifyJwtAuthorizer as Zt, addAlbSpecificOptions as _, selectIntegrationResponse as _n, derivePseudoParametersFromRegion as _r, invokeAgentCore as _t, createStudioServeManager as a, applyCorsResponseHeaders as an, webSocketApiMatchesIdentifier as ar, invokeAgentCoreWs as at, parseLbPortOverrides as b, HOST_GATEWAY_MIN_VERSION as bn, tryResolveImageFnJoin as br, SUPPORTED_CODE_RUNTIMES as bt, filterStudioTargetGroups as c, isFunctionUrlOacFronted as cn, resolveLambdaArnIntrinsic as cr, a2aInvokeOnce as ct, renderStudioHtml as d, translateLambdaResponse as dn, AGENTCORE_HTTP_PROTOCOL as dr, MCP_PROTOCOL_VERSION as dt, computeRequestIdentityHash as en, availableWebSocketApiIdentifiers as er, setShadowReadyTimeoutMs as et, createStudioStore as f, applyAuthorizerOverlay as fn, AGENTCORE_MCP_PROTOCOL as fr, mcpInvokeOnce as ft, formatTargetListing as g, pickResponseTemplate as gn, resolveAgentCoreTarget as gr, AGENTCORE_SESSION_ID_HEADER as gt, createLocalListCommand as h, evaluateResponseParameters as hn, pickAgentCoreCandidateStack as hr, signAgentCoreInvocation as ht, createLocalStudioCommand as i, attachAuthorizers as in, parseSelectionExpressionPath as ir, createLocalInvokeAgentCoreCommand as it, addEcsAssumeRoleOptions as j, buildContainerImage as jn, resolveApiTargetSubset as jt, MAX_TASKS_SUBNET_RANGE_CAP as k, buildMessageEvent as kn, createLocalStartApiCommand as kt, startStudioServer as l, matchPreflight as ln, AGENTCORE_A2A_PROTOCOL as lr, MCP_CONTAINER_PORT as lt, addListSpecificOptions as m, buildRestV1Event as mn, AgentCoreResolutionError as mr, AGENTCORE_SIGV4_SERVICE as mt, coerceRunRequest as n, invokeRequestAuthorizer as nn, discoverWebSocketApisOrThrow as nr, attachContainerLogStreamer as nt, startStudioProxy as o, buildCorsConfigByApiId as on, discoverRoutes as or, A2A_CONTAINER_PORT as ot, StudioEventBus as p, buildHttpApiV2Event as pn, AGENTCORE_RUNTIME_TYPE as pr, parseSseForJsonRpc as pt, describePinnedImageUri as q, CfnLocalStateProvider as qn, buildCognitoJwksUrl as qt, coerceStopRequest as r, invokeTokenAuthorizer as rn, filterWebSocketApisByIdentifiers as rr, addInvokeAgentCoreSpecificOptions as rt, createStudioDispatcher as s, buildCorsConfigFromCloudFrontChain as sn, pickRefLogicalId as sr, A2A_PATH as st, addStudioSpecificOptions as t, evaluateCachedLambdaPolicy as tn, discoverWebSocketApis as tr, getContainerNetworkIp as tt, toStudioTargetGroups as u, matchRoute as un, AGENTCORE_AGUI_PROTOCOL as ur, MCP_PATH as ut, albStrategy as v, tryParseStatus as vn, formatStateRemedy as vr, waitForAgentCorePing as vt, addStartServiceSpecificOptions as w, buildMgmtEndpointEnvUrl as wn, toCmdArgv as wt, resolveAlbTarget as x, probeHostGatewaySupport as xn, LocalInvokeBuildError as xr, buildAgentCoreCodeImage as xt, createLocalStartAlbCommand as y, VtlEvaluationError as yn, substituteImagePlaceholders as yr, downloadAndExtractS3Bundle as yt, runEcsServiceEmulator as z, substituteEnvVarsFromStateAsync as zn, filterRoutesByApiIdentifier as zt };
-//# sourceMappingURL=local-studio-MTJUk4NF.js.map
+//# sourceMappingURL=local-studio-Dd271q0Z.js.map