@metabase/cli 0.5.2 → 0.5.4

package/dist/{run-BBRnFayr.mjs → run-JYNbEO_V.mjs}

@@ -1,8 +1,9 @@
-import { Ct as FailedResultError, c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
-import { t as parseId } from "./parse-id-5BZGQ9Vd.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Cmes70jO.mjs";
-import { c as TransformRunResult, p as isTransformRunFailed } from "./transform-DiW7bREn.mjs";
-import { i as waitFlags, n as parseWaitFlags } from "./wait-flags-BnZ-dfE2.mjs";
+import { s as FailedResultError } from "./predicates-0C0TsWcJ.mjs";
+import { it as connectionFlags, l as renderSummary, lt as outputFlags, ut as profileFlag } from "./cli.mjs";
+import { t as parseId } from "./parse-id-EXZan40V.mjs";
+import { t as defineMetabaseCommand } from "./runtime-iIsqiOwO.mjs";
+import { c as TransformRunResult, p as isTransformRunFailed } from "./transform-B62craFM.mjs";
+import { i as waitFlags, n as parseWaitFlags } from "./wait-flags-C3cu_O0w.mjs";
 //#region src/commands/transform/run.ts
 const transformRunResultView = {
 	compactPick: TransformRunResult,

package/dist/{run-DXXD-CnS.mjs → run-Q7fHux1F.mjs}

@@ -1,7 +1,8 @@
-import { Ct as FailedResultError, St as ConfigError, ct as outputFlags, l as renderSummaryWithinMaxBytes, lt as profileFlag, rt as connectionFlags, t as interruptSignal } from "./cli.mjs";
-import { t as parseId } from "./parse-id-5BZGQ9Vd.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Cmes70jO.mjs";
-import { t as DEFAULT_TIMEOUT_MS } from "./transport-Ck4anhoc.mjs";
+import { o as ConfigError, s as FailedResultError } from "./predicates-0C0TsWcJ.mjs";
+import { it as connectionFlags, lt as outputFlags, t as interruptSignal, u as renderSummaryWithinMaxBytes, ut as profileFlag } from "./cli.mjs";
+import { t as parseId } from "./parse-id-EXZan40V.mjs";
+import { t as defineMetabaseCommand } from "./runtime-iIsqiOwO.mjs";
+import { t as DEFAULT_TIMEOUT_MS } from "./transport-DZSxmmtY.mjs";
 import { i as TransformTestRunResult } from "./transform-test-Bexa_K89.mjs";
 import { t as transformTestRunResultView } from "./transform-test-C49ZTK7M.mjs";
 //#region src/commands/transform-test/run.ts

package/dist/{runs-CovgMSwy.mjs → runs-GQD6FO2k.mjs}

@@ -1,9 +1,9 @@
-import { ct as outputFlags, lt as profileFlag, mt as listEnvelopeSchema, o as renderList, ot as listFlags, rt as connectionFlags } from "./cli.mjs";
-import { t as parseId } from "./parse-id-5BZGQ9Vd.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Cmes70jO.mjs";
-import { t as collectForOutput } from "./window-CfK_j6m1.mjs";
-import { s as TransformRunCompact } from "./transform-DiW7bREn.mjs";
-import { t as transformRunView } from "./transform-CWGJB8N_.mjs";
+import { gt as listEnvelopeSchema, it as connectionFlags, lt as outputFlags, s as renderList, st as listFlags, ut as profileFlag } from "./cli.mjs";
+import { t as parseId } from "./parse-id-EXZan40V.mjs";
+import { t as defineMetabaseCommand } from "./runtime-iIsqiOwO.mjs";
+import { t as collectForOutput } from "./window-D1w7B0vh.mjs";
+import { s as TransformRunCompact } from "./transform-B62craFM.mjs";
+import { t as transformRunView } from "./transform-DKPtUV54.mjs";
 //#region src/commands/transform/runs.ts
 const TransformRunListEnvelope = listEnvelopeSchema(TransformRunCompact);
 var runs_default = defineMetabaseCommand({

package/dist/{runtime-Cmes70jO.mjs → runtime-iIsqiOwO.mjs}

@@ -1,4 +1,5 @@
-import { $ as parseJsonResult, A as ENV_URL, B as Features, C as preflightUncheckedNotice, E as ENV_DISABLE_KEYRING, Et as NetworkError, Ft as isNonInterruptFailure, It as KNOWN_RANGE, K as isRetryableStatus, M as readEnv, Mt as errorMessage, N as ProfileRefreshedError, Ot as ResponseShapeError, Pt as isFileNotFoundError, S as preflightSkippedNotice, St as ConfigError, T as ENV_API_KEY, U as ruleGap, V as evaluateFeatures, W as HttpError, X as JSON_CONTENT_TYPE, _t as givenFlagKeys, dt as resolveOutputFormat, et as setMetabaseAugment, gt as assertArgv, i as reportError, j as consumeLegacyEnvWarnings, jt as ValidationError, kt as TimeoutError, nt as version, r as methodRequirements, t as interruptSignal, ut as resolveCommonFlags, w as warn, z as FEATURE_RULES } from "./cli.mjs";
+import { f as ResponseShapeError, g as errorMessage, h as ValidationError, o as ConfigError, p as TimeoutError, u as NetworkError, v as isFileNotFoundError, x as KNOWN_RANGE, y as isNonInterruptFailure } from "./predicates-0C0TsWcJ.mjs";
+import { B as FEATURE_RULES, C as preflightSkippedNotice, D as ENV_DISABLE_KEYRING, E as ENV_API_KEY, G as ruleGap, H as evaluateFeatures, J as isRetryableStatus, K as HttpError, M as consumeLegacyEnvWarnings, N as readEnv, P as ProfileRefreshedError, Q as parseJsonResult, T as warn, V as Features, X as parseJson, Y as JSON_CONTENT_TYPE, a as reportError, ft as resolveCommonFlags, i as methodRequirements, j as ENV_URL, pt as resolveOutputFormat, rt as version, t as interruptSignal, tt as setMetabaseAugment, vt as assertArgv, w as preflightUncheckedNotice, yt as givenFlagKeys } from "./cli.mjs";
 import { defineCommand } from "citty";
 import { z } from "zod";
 import { readFile } from "node:fs/promises";
@@ -1171,9 +1172,9 @@ async function readCachedProbe(profileName, url) {
 	const hit = await lookupCachedProbe(profileName, url);
 	return hit.kind === "found" ? hit.probe : null;
 }
-async function readCachedServerProfile(profileName) {
-	const envUrl = readEnvCredentials().url;
-	const hit = await lookupCachedProbe(profileName, envUrl === null ? null : normalizeUrl(envUrl));
+async function readCachedServerProfile(profileName, urlFlag) {
+	const url = urlFlag ?? readEnvCredentials().url;
+	const hit = await lookupCachedProbe(profileName, url === null ? null : normalizeUrl(url));
 	if (hit.kind !== "found") return hit;
 	return {
 		kind: "found",
@@ -1182,6 +1183,19 @@ async function readCachedServerProfile(profileName) {
 	};
 }
 //#endregion
+//#region src/runtime/body.ts
+async function readJsonBody(sources, schema) {
+	assertSingleSource(sources);
+	return parseJson(await readInput(sources), schema, { source: sources.source ?? "request body" });
+}
+function assertSingleSource(sources) {
+	const provided = [];
+	if (givenValue(sources.flag) !== null) provided.push(DEFAULT_FLAG_NAME);
+	if (givenValue(sources.file) !== null) provided.push("--file");
+	if (givenValue(sources.positional) !== null) provided.push("positional");
+	if (provided.length > 1) throw new ConfigError(`multiple body sources given (${provided.join(", ")}); pass exactly one`);
+}
+//#endregion
 //#region src/commands/runtime.ts
 function defineMetabaseCommand(def) {
 	const requirements = def.requires === null ? null : deriveRequirements(def.requires);
@@ -1212,7 +1226,7 @@ function defineMetabaseCommand(def) {
 					const probe = await readCachedProbe(resolved.profile, resolved.url);
 					const server = probe === null ? null : createServerProfile(probe);
 					const saveProbe = probe === null ? null : createProbeSaver(resolved.profile, probe);
-					const { createClient } = await import("./client-D-Aw6JLk.mjs").then((n) => n.t);
+					const { createClient } = await import("./client-DvWllzKd.mjs").then((n) => n.t);
 					const client = createClient({
 						url: resolved.url,
 						credential: resolved.credential
@@ -1235,12 +1249,12 @@ function defineMetabaseCommand(def) {
 					return client;
 				};
 				try {
-					await def.run({
+					await runCommandBody(def, {
 						args,
 						ctx,
 						getClient,
 						getResolvedConfig
-					});
+					}, args["skip-validate"] === true);
 				} catch (error) {
 					throw await diagnoseFailure(error, run);
 				} finally {
@@ -1256,12 +1270,40 @@ function defineMetabaseCommand(def) {
 		examples: def.examples ?? [],
 		details: def.details ? def.details : null,
 		skills: def.skills ?? [],
-		inputSchema: def.inputSchema ?? null,
+		input: inputContract(def),
 		outputSchema: def.outputSchema ?? null,
 		requires: requirements
 	});
 	return cmd;
 }
+function runCommandBody(def, context, skip) {
+	if (def.inputSchema === void 0) return def.run(context);
+	return def.run({
+		...context,
+		readBody: (sources) => readDeclaredBody(def, sources, skip)
+	});
+}
+async function readDeclaredBody(body, sources, skip) {
+	const parsed = await readJsonBody(sources, body.inputSchema);
+	const embedded = body.embeddedDocuments ?? [];
+	if (embedded.length > 0) {
+		const { preflightEmbeddedQuery } = await import("./validate-query-Bf5FhhMI.mjs");
+		for (const query of embedded) preflightEmbeddedQuery(parsed, query, { skip });
+	}
+	return parsed;
+}
+function inputContract(body) {
+	if (body.inputDocuments !== void 0) return {
+		kind: "documents",
+		source: body.inputDocuments
+	};
+	if (body.inputSchema === void 0) return null;
+	return {
+		kind: "zod",
+		schema: body.inputSchema,
+		embedded: body.embeddedDocuments ?? []
+	};
+}
 function deriveRequirements(methods) {
 	return {
 		methods,
@@ -1382,4 +1424,4 @@ function buildConfigFlags(ctx) {
 	return flags;
 }
 //#endregion
-export { featureGap as $, revokeOAuthCredential as A, probeServer as B, profileAuthMethod as C, fileNotFoundError as D, DEFAULT_FLAG_NAME as E, tryDiscoverMetadata as F, credentialSecrets as G, serverInfoFromProperties as H, buildNetworkError as I, normalizeUrl as J, oauthCredentialFromTokens as K, isConnectionClosed as L, discoverLoginMetadata as M, exchangeCode as N, givenValue as O, registerClient as P, createServerProfile as Q, PROBE_PATH as R, ProfileLastFailure as S, USER_AGENT as T, assertCredentialHeaderSafe as U, profileFromProperties as V, credentialAuthHeader as W, summarizeServer as X, ServerSummary as Y, Skew as Z, writeProbeFailure as _, readEnvCredentials as a, ProbedUser as b, clearProfile as c, keyringFallbackWarning as d, describeVersion as et, listProfileRecords as f, writeOAuthProfile as g, resolveRecordCredential as h, explicitProfileName as i, OAUTH_SCOPE as j, readInput as k, consumeKeychainResidualWarning as l, readProfileRecord as m, readCachedServerProfile as n, resolveProfileName as o, readProfileCredential as p, displayUrl as q, createCredentialRefresher as r, DEFAULT_PROFILE as s, defineMetabaseCommand as t, SessionProperties as tt, consumeKeyringDowngradeWarning as u, writeProbeResult as v, OAUTH_CLIENT_NAME as w, ProfileAuthMethod as x, writeProfile as y, probeBudget as z };
+export { featureGap as $, revokeOAuthCredential as A, probeServer as B, ProfileLastFailure as C, fileNotFoundError as D, USER_AGENT as E, tryDiscoverMetadata as F, credentialSecrets as G, serverInfoFromProperties as H, buildNetworkError as I, normalizeUrl as J, oauthCredentialFromTokens as K, isConnectionClosed as L, discoverLoginMetadata as M, exchangeCode as N, givenValue as O, registerClient as P, createServerProfile as Q, PROBE_PATH as R, ProfileAuthMethod as S, OAUTH_CLIENT_NAME as T, assertCredentialHeaderSafe as U, profileFromProperties as V, credentialAuthHeader as W, summarizeServer as X, ServerSummary as Y, Skew as Z, writeOAuthProfile as _, explicitProfileName as a, writeProfile as b, DEFAULT_PROFILE as c, consumeKeyringDowngradeWarning as d, describeVersion as et, keyringFallbackWarning as f, resolveRecordCredential as g, readProfileRecord as h, createCredentialRefresher as i, OAUTH_SCOPE as j, readInput as k, clearProfile as l, readProfileCredential as m, readJsonBody as n, readEnvCredentials as o, listProfileRecords as p, displayUrl as q, readCachedServerProfile as r, resolveProfileName as s, defineMetabaseCommand as t, SessionProperties as tt, consumeKeychainResidualWarning as u, writeProbeFailure as v, profileAuthMethod as w, ProbedUser as x, writeProbeResult as y, probeBudget as z };

package/dist/scaffold-CJo9l-2p.mjs

@@ -0,0 +1,50 @@
+import { l as renderSummary, lt as outputFlags } from "./cli.mjs";
+import { t as defineMetabaseCommand } from "./runtime-iIsqiOwO.mjs";
+import { n as findSkillByName, r as loadAllSkills } from "./skills-BY3MCR8i.mjs";
+import { r as scaffoldDataAppProject } from "./data-app-project-DjDDWgUF.mjs";
+import { z } from "zod";
+import { join } from "node:path";
+//#region src/commands/data-app/scaffold.ts
+const TEMPLATE_SKILL = "data-app";
+const TEMPLATE_DIR = "template";
+const ScaffoldResult = z.object({ dir: z.string() });
+const scaffoldResultView = {
+	compactPick: ScaffoldResult,
+	tableColumns: [{
+		key: "dir",
+		label: "Directory"
+	}]
+};
+var scaffold_default = defineMetabaseCommand({
+	meta: {
+		name: "scaffold",
+		description: "Copy the data app project template into a directory"
+	},
+	details: "Copies the Vite + React + TypeScript template into <dir> (the current directory by default), which must be missing or empty, and names the package after the directory (lowercase, dashes). It doesn't reach Metabase: create the app with `mb data-app create` and fetch its queries and actions with `mb data-app typed-schema <slug> --out src/metabase.ts`. Before `npm install`, install the SDK's beta tag for the instance's version, e.g. `npm install @metabase/embedding-sdk-react@66-beta` for v1.66.x: the template's `*` installs `latest`, which may not build the app.",
+	skills: [{
+		skill: "data-app",
+		purpose: "the steps after scaffolding"
+	}],
+	requires: null,
+	args: {
+		...outputFlags,
+		dir: {
+			type: "positional",
+			description: "Project directory",
+			required: false,
+			default: "."
+		}
+	},
+	outputSchema: ScaffoldResult,
+	examples: ["mb data-app scaffold sales-overview", "mb data-app scaffold ."],
+	async run({ args, ctx }) {
+		const templateDir = join(findSkillByName(loadAllSkills(), TEMPLATE_SKILL).dir, TEMPLATE_DIR);
+		await scaffoldDataAppProject({
+			dir: args.dir,
+			templateDir
+		});
+		renderSummary({ dir: args.dir }, scaffoldResultView, `Scaffolded a data app project in ${args.dir}.`, ctx);
+	}
+});
+//#endregion
+export { scaffold_default as default };

package/dist/schema-2JhmK8FM.mjs

@@ -0,0 +1,283 @@
+import { C as unescapeJsonPointerSegment, o as ConfigError } from "./predicates-0C0TsWcJ.mjs";
+import { $ as main, Ct as resolveCitty, U as featureAvailability, at as formatFlags, dt as urlFlag, et as getMetabaseAugment, f as writeJson, n as resolveCommandPath, ut as profileFlag } from "./cli.mjs";
+import { r as readCachedServerProfile, s as resolveProfileName, t as defineMetabaseCommand } from "./runtime-iIsqiOwO.mjs";
+import { n as inputGatesOf } from "./input-gate-registry-Dh8QjKgW.mjs";
+import { c as FieldSemanticType, r as FieldBaseType } from "./field-C2qOViFZ.mjs";
+import { n as ParameterMapping, r as ParameterTarget, t as Parameter } from "./parameter-Bucz3cLJ.mjs";
+import { m as CollectionTreeNode } from "./collection-Cz2qLX2m.mjs";
+import { f as Dashcard, u as DashboardTab } from "./dashboard-Cwsf-e9T.mjs";
+import { a as TipTapNode } from "./document-BHOQq2T_.mjs";
+import { t as QuerySchemaBundle } from "./validate-moGYlHxB.mjs";
+import { z } from "zod";
+//#region src/runtime/json-schema.ts
+const OPTIONALITY = {
+	input: "optin",
+	output: "optout"
+};
+const REFINED_PREFIX = "refined: ";
+const LOCAL_DEFS_PREFIX = "#/$defs/";
+const ALTERNATIVE_KEYWORDS = [
+	"anyOf",
+	"oneOf",
+	"allOf"
+];
+const CUSTOM_CHECK = "custom";
+const UNREPORTED_ISSUE = {
+	code: "custom",
+	input: void 0
+};
+function toJsonSchema(schema, params) {
+	const { io } = params;
+	return z.toJSONSchema(schema, {
+		...params,
+		override: ({ zodSchema, jsonSchema }) => {
+			if (zodSchema instanceof z.core.$ZodTuple) restoreArity(zodSchema, jsonSchema, io);
+			noteRefinements(zodSchema, jsonSchema);
+		}
+	});
+}
+function restoreArity(tuple, json, io) {
+	if (json.prefixItems === void 0) return;
+	const { items, rest } = tuple._zod.def;
+	const required = items.findLastIndex((item) => item._zod[OPTIONALITY[io]] !== "optional") + 1;
+	json.minItems = json.minItems === void 0 ? required : Math.max(json.minItems, required);
+	if (rest === null) json.items = false;
+}
+function noteRefinements(schema, json) {
+	const notes = refinementMessages(schema, json).map((message) => `${REFINED_PREFIX}${message}`);
+	if (notes.length === 0) return;
+	json.description = [...json.description === void 0 ? [] : [json.description], ...notes].join("; ");
+}
+function refinementMessages(schema, json) {
+	const { checks } = schema._zod.def;
+	if (checks === void 0) return [];
+	const inherited = json.$ref === void 0 ? [] : schema._zod.parent?._zod.def.checks ?? [];
+	return checks.filter((check) => check._zod.def.check === CUSTOM_CHECK && !inherited.includes(check)).map((check) => refinementMessage(schema, check));
+}
+function refinementMessage(schema, check) {
+	const message = check instanceof z.core.$ZodCustom ? reportedMessage(check._zod.def.error?.(UNREPORTED_ISSUE)) : null;
+	if (message === null) throw new Error(`a refinement on a ${schema._zod.def.type} schema has no static message to note`);
+	return message;
+}
+function reportedMessage(reported) {
+	if (typeof reported === "string") return reported;
+	return reported?.message ?? null;
+}
+function notePaths(root, notes) {
+	return notes.reduce((noted, { path, note }) => {
+		const reached = notePath(noted, path, note, noted.$defs);
+		if (reached === null) throw new Error(`no member at "${path.join(".")}" to note`);
+		return reached;
+	}, root);
+}
+function notePath(schema, path, note, defs) {
+	if (typeof schema === "boolean") return null;
+	const [key, ...rest] = path;
+	if (key === void 0) {
+		const description = schema.description === void 0 ? [] : [schema.description];
+		return {
+			...schema,
+			description: [...description, note].join("; ")
+		};
+	}
+	if (schema.$ref !== void 0) return noteThroughRef(schema, schema.$ref, path, note, defs);
+	const noted = { ...schema };
+	let reached = false;
+	const property = schema.properties?.[key];
+	const notedProperty = property === void 0 ? null : notePath(property, rest, note, defs);
+	if (notedProperty !== null) {
+		noted.properties = {
+			...schema.properties,
+			[key]: notedProperty
+		};
+		reached = true;
+	}
+	for (const keyword of ALTERNATIVE_KEYWORDS) {
+		const alternatives = schema[keyword];
+		const notedAlternatives = alternatives === void 0 ? null : noteAlternatives(alternatives, path, note, defs);
+		if (notedAlternatives !== null) {
+			noted[keyword] = notedAlternatives;
+			reached = true;
+		}
+	}
+	return reached ? noted : null;
+}
+function noteAlternatives(alternatives, path, note, defs) {
+	const noted = alternatives.map((alternative) => notePath(alternative, path, note, defs));
+	if (noted.every((alternative) => alternative === null)) return null;
+	return alternatives.map((alternative, index) => noted[index] ?? alternative);
+}
+function noteThroughRef(schema, ref, path, note, defs) {
+	if (!ref.startsWith(LOCAL_DEFS_PREFIX)) throw new Error(`cannot note "${path.join(".")}" through $ref "${ref}"`);
+	const target = defs?.[unescapeJsonPointerSegment(ref.slice(8))];
+	if (target === void 0) throw new Error(`$ref "${ref}" points at no $defs entry`);
+	const notedTarget = notePath(target, path, note, defs);
+	if (notedTarget === null) return null;
+	const { $ref: _inlined, ...siblings } = schema;
+	return {
+		...siblings,
+		allOf: [...siblings.allOf ?? [], notedTarget]
+	};
+}
+//#endregion
+//#region src/commands/schema.ts
+const NAMED_SCHEMAS = {
+	Parameter,
+	ParameterMapping,
+	ParameterTarget,
+	Dashcard,
+	DashboardTab,
+	CollectionTreeNode,
+	TipTapNode,
+	FieldBaseType,
+	FieldSemanticType
+};
+var SchemaNames = class extends z.core.$ZodRegistry {
+	#ids;
+	#gateNotes;
+	constructor(named, gateNotes) {
+		super();
+		this.#ids = new Map(Object.entries(named).map(([id, schema]) => [schema, id]));
+		this.#gateNotes = gateNotes;
+	}
+	get(schema) {
+		const described = z.globalRegistry.get(schema);
+		const id = this.#ids.get(schema);
+		const named = id === void 0 ? described : {
+			...described,
+			id
+		};
+		const gates = inputGatesOf(schema);
+		if (this.#gateNotes === null || gates === null) return named;
+		const { server } = this.#gateNotes;
+		const prior = described?.description === void 0 ? [] : [described.description];
+		const notes = gates.map((gate) => gateNote(gate, server));
+		return {
+			...named,
+			description: [...prior, ...notes].join("; ")
+		};
+	}
+};
+const SCHEMA_NAMES = new SchemaNames(NAMED_SCHEMAS, null);
+const GATE_EFFECT_TEXT = {
+	needs: {
+		claim: "needs",
+		verdict: "this server lacks it"
+	},
+	supersededBy: {
+		claim: "read differently under",
+		verdict: "this server reads it differently"
+	},
+	droppedBy: {
+		claim: "dropped by",
+		verdict: "this server ignores it"
+	}
+};
+function gateNote(gate, server) {
+	const text = GATE_EFFECT_TEXT[gate.effect];
+	const feature = `${gate.feature} (${featureAvailability(gate.feature)})`;
+	const trigger = triggerText(gate.when);
+	const claim = `${text.claim} ${feature}`;
+	const note = trigger === null ? claim : `${claim} ${trigger}`;
+	return server !== null && serverActsOnGate(gate, server) ? `${note}; ${text.verdict}` : note;
+}
+function triggerText(when) {
+	switch (when.kind) {
+		case "present": return null;
+		case "values": return `for ${when.values.map((value) => JSON.stringify(value)).join(", ")}`;
+		case "nonEmpty": return "when non-empty";
+	}
+}
+function serverActsOnGate(gate, server) {
+	const holds = server.features[gate.feature];
+	return gate.effect === "needs" ? !holds : holds;
+}
+const PrintedSchema = z.union([z.object({ $schema: z.string() }).loose(), QuerySchemaBundle]).describe("The JSON Schema (draft 2020-12) of the command's body or output; for query's body, the MBQL 5 schema documents");
+var schema_default = defineMetabaseCommand({
+	meta: {
+		name: "schema",
+		description: "Print the schema of a command's JSON body or output"
+	},
+	details: "Names another command and prints the JSON Schema of the JSON body it accepts, or with --output of the JSON it prints. A body field only some servers take says in its description the feature it needs, as `needs fieldDataSensitivity (v64+)`. Those notes are judged against the server the profile last probed, read from its cache with no request: `this server lacks it` follows a field that server lacks the feature for, which the client refuses there, `this server reads it differently` a value it would take as another, and `this server ignores it` a field it drops unread. A field holding an MBQL 5 query names `mb schema query`, which prints the MBQL 5 query schema that query, card, transform, segment, measure and data-action bodies are checked against.",
+	requires: null,
+	args: {
+		...formatFlags,
+		...profileFlag,
+		...urlFlag,
+		output: {
+			type: "boolean",
+			description: "Print the schema of the command's output instead of its body"
+		},
+		command: {
+			type: "positional",
+			required: true,
+			description: "The command, or the group holding it (card, query, …)"
+		},
+		subcommand: {
+			type: "positional",
+			required: false,
+			description: "The command within that group (create, get, …)"
+		}
+	},
+	outputSchema: PrintedSchema,
+	examples: [
+		"mb schema card create",
+		"mb schema dashboard get --output",
+		"mb schema query"
+	],
+	async run({ args }) {
+		if (args.format === "text") throw new ConfigError("schema output is JSON-only; --format text is not supported");
+		const path = args.subcommand === void 0 ? [args.command] : [args.command, args.subcommand];
+		const side = args.output === true ? "output" : "input";
+		writeJson(await schemaJson(path, side, { server: side === "input" ? await cachedServer(args.profile, args.url) : null }));
+	}
+});
+async function cachedServer(profile, url) {
+	const cached = await readCachedServerProfile(resolveProfileName(profile), url);
+	return cached.kind === "found" ? cached.profile : null;
+}
+async function schemaJson(path, side, gateNotes) {
+	return contractJson(await resolveContract(path, side), side, gateNotes);
+}
+async function resolveContract(path, side) {
+	const contract = readContract(getMetabaseAugment(await resolveLeaf(path)), side);
+	if (contract === null) throw missingSchema(path.join(" "), side);
+	return contract;
+}
+async function resolveLeaf(path) {
+	const command = await resolveCommandPath(main, path);
+	const subCommands = await resolveCitty(command.subCommands);
+	if (subCommands === void 0) return command;
+	throw new ConfigError(`${path.join(" ")} is a command group; name one of its commands: ${Object.keys(subCommands).join(", ")}`);
+}
+function readContract(augment, side) {
+	if (augment === null) return null;
+	if (side === "input") return augment.input;
+	if (augment.outputSchema === null) return null;
+	return {
+		kind: "zod",
+		schema: augment.outputSchema,
+		embedded: []
+	};
+}
+function missingSchema(command, side) {
+	if (side === "output") return new ConfigError(`${command} declares no output schema`);
+	return new ConfigError(`${command} takes no JSON body, so it has no input schema; pass --output for the schema of what it prints`);
+}
+function contractJson(contract, side, gateNotes) {
+	if (contract.kind === "documents") return contract.source.bundle;
+	const names = side === "input" ? new SchemaNames(NAMED_SCHEMAS, gateNotes) : SCHEMA_NAMES;
+	return notePaths(toJsonSchema(contract.schema, {
+		io: side,
+		reused: "ref",
+		metadata: names
+	}), embeddedQueryNotes(contract.embedded));
+}
+function embeddedQueryNotes(embedded) {
+	return embedded.map(({ path, documents }) => ({
+		path,
+		note: `${documents.title} checked against \`mb schema ${documents.command.join(" ")}\``
+	}));
+}
+//#endregion
+export { schema_default as default };

package/dist/{schema-tables-CjKl8jr5.mjs → schema-tables-CarGLayY.mjs}

@@ -1,9 +1,9 @@
-import { ct as outputFlags, lt as profileFlag, mt as listEnvelopeSchema, o as renderList, ot as listFlags, rt as connectionFlags } from "./cli.mjs";
-import { t as parseId } from "./parse-id-5BZGQ9Vd.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Cmes70jO.mjs";
-import { n as windowList } from "./window-CfK_j6m1.mjs";
-import { a as TableCompact } from "./table-CF7zW9cI.mjs";
-import { u as tableView } from "./table-BDsqRU7a.mjs";
+import { gt as listEnvelopeSchema, it as connectionFlags, lt as outputFlags, s as renderList, st as listFlags, ut as profileFlag } from "./cli.mjs";
+import { t as parseId } from "./parse-id-EXZan40V.mjs";
+import { t as defineMetabaseCommand } from "./runtime-iIsqiOwO.mjs";
+import { n as windowList } from "./window-D1w7B0vh.mjs";
+import { l as TableCompact } from "./table-hgrX1i-R.mjs";
+import { u as tableView } from "./table-BNA9Or05.mjs";
 //#region src/commands/db/schema-tables.ts
 const DatabaseSchemaTablesEnvelope = listEnvelopeSchema(TableCompact);
 var schema_tables_default = defineMetabaseCommand({

package/dist/{schemas-CAGvBAD_.mjs → schemas-oSjtuQ4G.mjs}

@@ -1,7 +1,7 @@
-import { ct as outputFlags, lt as profileFlag, mt as listEnvelopeSchema, o as renderList, ot as listFlags, rt as connectionFlags } from "./cli.mjs";
-import { t as parseId } from "./parse-id-5BZGQ9Vd.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Cmes70jO.mjs";
-import { n as windowList } from "./window-CfK_j6m1.mjs";
+import { gt as listEnvelopeSchema, it as connectionFlags, lt as outputFlags, s as renderList, st as listFlags, ut as profileFlag } from "./cli.mjs";
+import { t as parseId } from "./parse-id-EXZan40V.mjs";
+import { t as defineMetabaseCommand } from "./runtime-iIsqiOwO.mjs";
+import { n as windowList } from "./window-D1w7B0vh.mjs";
 import { z } from "zod";
 //#region src/commands/db/schemas.ts
 const SchemaName = z.object({ name: z.string() });

package/dist/{search-DFU6FHRd.mjs → search-Ca0sIr28.mjs}

@@ -1,9 +1,10 @@
-import { St as ConfigError, ct as outputFlags, lt as profileFlag, mt as listEnvelopeSchema, o as renderList, ot as listFlags, rt as connectionFlags } from "./cli.mjs";
-import { t as parseId } from "./parse-id-5BZGQ9Vd.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Cmes70jO.mjs";
-import { t as collectForOutput } from "./window-CfK_j6m1.mjs";
-import { n as parseText } from "./parse-text-FgX60vIg.mjs";
-import { n as FieldValueLabel, o as fieldValueLabelView, u as toValueLabel } from "./field-BVz4AS3f.mjs";
+import { o as ConfigError } from "./predicates-0C0TsWcJ.mjs";
+import { gt as listEnvelopeSchema, it as connectionFlags, lt as outputFlags, s as renderList, st as listFlags, ut as profileFlag } from "./cli.mjs";
+import { t as parseId } from "./parse-id-EXZan40V.mjs";
+import { t as defineMetabaseCommand } from "./runtime-iIsqiOwO.mjs";
+import { t as collectForOutput } from "./window-D1w7B0vh.mjs";
+import { n as parseText } from "./parse-text-C4LYzIFa.mjs";
+import { n as FieldValueLabel, o as fieldValueLabelView, u as toValueLabel } from "./field-CT4r6b92.mjs";
 //#region src/commands/field/search.ts
 const FieldSearchListEnvelope = listEnvelopeSchema(FieldValueLabel);
 function fieldSearchValue(value, limit) {

package/dist/{search-OpYS2Ub4.mjs → search-CvGEL2h-.mjs}

@@ -1,9 +1,10 @@
-import { St as ConfigError, at as listFlag, bt as parseEnumCsv, ct as outputFlags, lt as profileFlag, mt as listEnvelopeSchema, o as renderList, rt as connectionFlags, st as listFlagsWithDefaultLimit } from "./cli.mjs";
-import { n as parseIdCsv, t as parseId } from "./parse-id-5BZGQ9Vd.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Cmes70jO.mjs";
-import { r as windowServerPage } from "./window-CfK_j6m1.mjs";
+import { o as ConfigError } from "./predicates-0C0TsWcJ.mjs";
+import { St as parseEnumCsv, ct as listFlagsWithDefaultLimit, gt as listEnvelopeSchema, it as connectionFlags, lt as outputFlags, ot as listFlag, s as renderList, ut as profileFlag } from "./cli.mjs";
+import { n as parseIdCsv, t as parseId } from "./parse-id-EXZan40V.mjs";
+import { t as defineMetabaseCommand } from "./runtime-iIsqiOwO.mjs";
+import { r as windowServerPage } from "./window-D1w7B0vh.mjs";
 import { i as SearchResultCompact, n as SearchModel, t as SEARCH_MODELS } from "./search-1et9tv_s.mjs";
-import { t as parseOptionalText } from "./parse-text-FgX60vIg.mjs";
+import { t as parseOptionalText } from "./parse-text-C4LYzIFa.mjs";
 //#region src/output/views/search.ts
 function searchLocation(row) {
 	const tableName = row.table_name;

package/dist/{segment-D-SKpFzF.mjs → segment-BJCEJwNY.mjs}

@@ -1,4 +1,4 @@
-import { t as defineCommandGroup } from "./group-81zoQcEP.mjs";
+import { t as defineCommandGroup } from "./group--6adAsqG.mjs";
 //#region src/commands/segment/index.ts
 var segment_default = defineCommandGroup({
 	name: "segment",
@@ -11,11 +11,11 @@ var segment_default = defineCommandGroup({
 		purpose: "define reusable segments"
 	}],
 	subCommands: {
-		list: () => import("./list-jT5ndEGr.mjs").then((mod) => mod.default),
-		get: () => import("./get-CmxYFUuR.mjs").then((mod) => mod.default),
-		create: () => import("./create-qtTB8rIE.mjs").then((mod) => mod.default),
-		update: () => import("./update-6sfqiInZ.mjs").then((mod) => mod.default),
-		archive: () => import("./archive-CpvpGZlz.mjs").then((mod) => mod.default)
+		list: () => import("./list-HI7Mpoy-.mjs").then((mod) => mod.default),
+		get: () => import("./get-BSKpQJVB.mjs").then((mod) => mod.default),
+		create: () => import("./create-DJg0Ohj5.mjs").then((mod) => mod.default),
+		update: () => import("./update-BVz0oIwS.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-F5hoWW7f.mjs").then((mod) => mod.default)
 	}
 });
 //#endregion

package/dist/{segment-C_gl5ag6.mjs → segment-CWVASaM1.mjs}

@@ -1,4 +1,4 @@
-import { n as SegmentCompact } from "./segment-OsrbUDzw.mjs";
+import { n as SegmentCompact } from "./segment-Cf-DrdjE.mjs";
 //#region src/output/views/segment.ts
 const segmentView = {
 	compactPick: SegmentCompact,

package/dist/{segment-OsrbUDzw.mjs → segment-Cf-DrdjE.mjs}

@@ -1,3 +1,5 @@
+import { t as gateInput } from "./input-gate-registry-Dh8QjKgW.mjs";
+import { i as TABLE_FROM_DEFINITION_GATE } from "./table-hgrX1i-R.mjs";
 import { z } from "zod";
 //#region ../client/src/domain/segment.ts
 const Segment = z.object({
@@ -26,7 +28,7 @@ const SegmentCompact = Segment.pick({
 const SegmentDefinition = z.record(z.string(), z.unknown()).describe("MBQL query holding the filter");
 const SegmentCreateInput = z.object({
 	name: z.string().min(1),
-	table_id: z.number().int().positive(),
+	table_id: gateInput(z.number().int().positive(), TABLE_FROM_DEFINITION_GATE),
 	definition: SegmentDefinition,
 	description: z.string().nullable().optional()
 }).loose();

package/dist/{send-DNu83_3E.mjs → send-B4nZI6CU.mjs}

@@ -1,6 +1,6 @@
-import { c as renderSummary, ct as outputFlags, lt as profileFlag, rt as connectionFlags } from "./cli.mjs";
-import { t as parseId } from "./parse-id-5BZGQ9Vd.mjs";
-import { t as defineMetabaseCommand } from "./runtime-Cmes70jO.mjs";
+import { it as connectionFlags, l as renderSummary, lt as outputFlags, ut as profileFlag } from "./cli.mjs";
+import { t as parseId } from "./parse-id-EXZan40V.mjs";
+import { t as defineMetabaseCommand } from "./runtime-iIsqiOwO.mjs";
 import { z } from "zod";
 //#region src/commands/alert/send.ts
 const AlertSendResult = z.object({