@metabase/cli 0.1.17 → 0.2.0

package/dist/{card-DEmcRlNO.mjs → card-B8G5jQQT.mjs}

@@ -1,5 +1,6 @@
-import { FieldBaseType, FieldSemanticType } from "./field-CMY_LWUe.mjs";
-import { Parameter, ParameterMapping } from "./parameter-CiJ4CwWE.mjs";
+import { EmbeddingParams } from "./embedding-CKdw8q7p.mjs";
+import { FieldBaseType, FieldSemanticType } from "./field-DsXTeqBy.mjs";
+import { Parameter, ParameterMapping } from "./parameter-BZ6y-Gfs.mjs";
 import { z } from "zod";
 
 //#region src/domain/card.ts
@@ -9,7 +10,7 @@ const CardType = z.enum([
 	"metric"
 ]);
 const CardQueryType = z.enum(["native", "query"]);
-const CardDatasetQuery = z.object({}).loose().refine((value) => "lib/type" in value || "type" in value, { message: "dataset_query must include \"lib/type\" (MBQL 5) or \"type\" (legacy MBQL/native); empty `{}` is rejected" });
+const CardDatasetQuery = z.object({}).loose().refine((value) => "lib/type" in value || "type" in value, { message: "dataset_query must include \"lib/type\" (MBQL 5) or \"type\" (legacy MBQL/native); empty `{}` is rejected" }).describe("MBQL 5, legacy MBQL, or native query — full MBQL 5 schema: mb query --print-schema");
 const Card = z.object({
 	id: z.number().int(),
 	name: z.string(),
@@ -70,38 +71,43 @@ const cardView = {
 		}
 	]
 };
+const CollectionIdOrEntityId = z.union([z.number().int().positive(), z.string().length(21).describe("collection entity_id (21-char NanoID)")]);
 const CardCreateInput = z.object({
 	name: z.string().min(1),
-	type: CardType.optional(),
+	type: CardType.nullable().optional(),
 	dataset_query: CardDatasetQuery,
 	display: z.string().min(1),
 	visualization_settings: z.record(z.string(), z.unknown()),
 	description: z.string().min(1).nullable().optional(),
-	collection_id: z.number().int().positive().nullable().optional(),
+	entity_id: z.string().min(1).nullable().optional(),
+	collection_id: CollectionIdOrEntityId.nullable().optional(),
 	collection_position: z.number().int().positive().nullable().optional(),
+	cache_ttl: z.number().int().positive().nullable().optional(),
 	dashboard_id: z.number().int().positive().nullable().optional(),
-	parameters: z.array(Parameter).optional(),
-	parameter_mappings: z.array(ParameterMapping).optional()
+	dashboard_tab_id: z.number().int().positive().nullable().optional(),
+	parameters: z.array(Parameter).nullable().optional(),
+	parameter_mappings: z.array(ParameterMapping).nullable().optional(),
+	result_metadata: z.array(z.unknown()).nullable().optional()
 }).loose();
 const CardUpdateInput = z.object({
-	name: z.string().min(1).optional(),
-	type: CardType.optional(),
+	name: z.string().min(1).nullable().optional(),
+	type: CardType.nullable().optional(),
 	dataset_query: CardDatasetQuery.optional(),
-	display: z.string().min(1).optional(),
-	visualization_settings: z.record(z.string(), z.unknown()).optional(),
+	display: z.string().min(1).nullable().optional(),
+	visualization_settings: z.record(z.string(), z.unknown()).nullable().optional(),
 	description: z.string().nullable().optional(),
-	archived: z.boolean().optional(),
-	enable_embedding: z.boolean().optional(),
-	embedding_type: z.string().optional(),
-	embedding_params: z.unknown().optional(),
+	archived: z.boolean().nullable().optional(),
+	enable_embedding: z.boolean().nullable().optional(),
+	embedding_type: z.string().nullable().optional(),
+	embedding_params: EmbeddingParams.nullable().optional(),
 	collection_id: z.number().int().positive().nullable().optional(),
 	collection_position: z.number().int().positive().nullable().optional(),
-	collection_preview: z.boolean().optional(),
+	collection_preview: z.boolean().nullable().optional(),
 	cache_ttl: z.number().int().positive().nullable().optional(),
 	dashboard_id: z.number().int().positive().nullable().optional(),
 	dashboard_tab_id: z.number().int().positive().nullable().optional(),
-	parameters: z.array(Parameter).optional(),
-	parameter_mappings: z.array(ParameterMapping).optional(),
+	parameters: z.array(Parameter).nullable().optional(),
+	parameter_mappings: z.array(ParameterMapping).nullable().optional(),
 	result_metadata: z.array(z.unknown()).nullable().optional()
 }).loose();
 const QueryColumn = z.object({

package/dist/card-DHCcmpgr.mjs

@@ -0,0 +1,26 @@
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineCommandGroup } from "./group-CILtQqCL.mjs";
+
+//#region src/commands/card/index.ts
+var card_default = defineCommandGroup({
+	name: "card",
+	description: "Manage Metabase cards (questions, models, metrics)",
+	skills: [{
+		skill: "mbql",
+		purpose: "author the dataset_query"
+	}, {
+		skill: "visualization",
+		purpose: "choose display and visualization_settings"
+	}],
+	subCommands: {
+		list: () => import("./list-D9FY30xH.mjs").then((mod) => mod.default),
+		get: () => import("./get-AvGH_oph.mjs").then((mod) => mod.default),
+		query: () => import("./query-DTASj9Zu.mjs").then((mod) => mod.default),
+		create: () => import("./create-C8ndg3g4.mjs").then((mod) => mod.default),
+		update: () => import("./update-HxYcvpSq.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-pHsa4dL0.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { card_default as default };

package/dist/{cards-CMgGA8OZ.mjs → cards-D0hvA13L.mjs}

@@ -1,11 +1,10 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, wrapList } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
-import { renderList } from "./capabilities-N0jo5U7S.mjs";
-import "./parameter-CiJ4CwWE.mjs";
-import { parseId } from "./parse-id-D4LeTUsP.mjs";
-import { DashboardDetail, DashcardCompact, dashcardView } from "./dashboard-DOplbKyQ.mjs";
+import { connectionFlags, listEnvelopeSchema, outputFlags, profileFlag, renderList, wrapList } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import "./embedding-CKdw8q7p.mjs";
+import "./parameter-BZ6y-Gfs.mjs";
+import { parseId } from "./parse-id-DfY0Lugw.mjs";
+import { DashboardDetail, DashcardCompact, dashcardView } from "./dashboard-B-MTpfeS.mjs";
 
 //#region src/commands/dashboard/cards.ts
 const DashcardListEnvelope = listEnvelopeSchema(DashcardCompact);

package/dist/cli.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { ConfigError, flagConsumesValue, normalizeFlag, resolveCitty, toAliasArray } from "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, package_default, profileFlag, reportError } from "./error-5H_tcfL8.mjs";
-import { getMetabaseAugment, setMetabaseAugment } from "./command-augment-DdZIfx1V.mjs";
+import { Capabilities, ConfigError, connectionFlags, flagConsumesValue, jsonLine, normalizeFlag, outputFlags, package_default, profileFlag, reportError, resolveCitty, toAliasArray } from "./capabilities-DrDJo_ng.mjs";
+import { getMetabaseAugment, setMetabaseAugment } from "./command-augment-D9pI9Vbh.mjs";
 import { defineCommand, renderUsage, runMain } from "citty";
+import { z } from "zod";
 
 //#region src/commands/global-flags.ts
 const ARGUMENT_SEPARATOR = "--";
@@ -59,31 +59,31 @@ const main = defineCommand({
 		description: package_default.description
 	},
 	subCommands: {
-		auth: () => import("./auth-Kv2MRkRk.mjs").then((mod) => mod.default),
-		db: () => import("./db-DWykmBOh.mjs").then((mod) => mod.default),
-		table: () => import("./table-B1iBqmNu.mjs").then((mod) => mod.default),
-		field: () => import("./field-CFt1-KDR.mjs").then((mod) => mod.default),
-		card: () => import("./card-Bp58WEUF.mjs").then((mod) => mod.default),
-		dashboard: () => import("./dashboard-C9pQCnX6.mjs").then((mod) => mod.default),
-		collection: () => import("./collection-D8TI20Ir.mjs").then((mod) => mod.default),
-		library: () => import("./library-B5AvpACG.mjs").then((mod) => mod.default),
-		document: () => import("./document-DNDm8_Py.mjs").then((mod) => mod.default),
-		transform: () => import("./transform-BuIooRQh.mjs").then((mod) => mod.default),
-		"transform-job": () => import("./transform-job-C3yz0krA.mjs").then((mod) => mod.default),
-		"transform-tag": () => import("./transform-tag-CJD6mJUe.mjs").then((mod) => mod.default),
-		setting: () => import("./setting-DHYO-W5g.mjs").then((mod) => mod.default),
-		search: () => import("./search-vaT5EwhG.mjs").then((mod) => mod.default),
-		"git-sync": () => import("./git-sync-ByvjqSiy.mjs").then((mod) => mod.default),
-		setup: () => import("./setup-D1de5Sbc.mjs").then((mod) => mod.default),
-		snippet: () => import("./snippet-DtLmHr2J.mjs").then((mod) => mod.default),
-		segment: () => import("./segment-BPC725mo.mjs").then((mod) => mod.default),
-		measure: () => import("./measure-CgFwtL1r.mjs").then((mod) => mod.default),
-		eid: () => import("./eid-p-zn_1RJ.mjs").then((mod) => mod.default),
-		query: () => import("./query-BWJ5h1g3.mjs").then((mod) => mod.default),
-		uuid: () => import("./uuid-D6JVJ-R1.mjs").then((mod) => mod.default),
-		upgrade: () => import("./upgrade-CBW8V9qZ.mjs").then((mod) => mod.default),
-		skills: () => import("./skills-NhgVypJ7.mjs").then((mod) => mod.default),
-		__manifest: () => import("./manifest-BVf8P4bl.mjs").then((mod) => mod.createManifestCommand(main))
+		auth: () => import("./auth-BrQtY0pO.mjs").then((mod) => mod.default),
+		db: () => import("./db-DBRijnh4.mjs").then((mod) => mod.default),
+		table: () => import("./table-CS2-2INi.mjs").then((mod) => mod.default),
+		field: () => import("./field-B1heFeCz.mjs").then((mod) => mod.default),
+		upload: () => import("./upload-CPzOhGeX.mjs").then((mod) => mod.default),
+		card: () => import("./card-DHCcmpgr.mjs").then((mod) => mod.default),
+		dashboard: () => import("./dashboard-BpSPoeAn.mjs").then((mod) => mod.default),
+		collection: () => import("./collection-D0O9gp3S.mjs").then((mod) => mod.default),
+		library: () => import("./library-DHWWa4Tt.mjs").then((mod) => mod.default),
+		document: () => import("./document-dZpuFu3I.mjs").then((mod) => mod.default),
+		transform: () => import("./transform-6hqM1DXA.mjs").then((mod) => mod.default),
+		"transform-job": () => import("./transform-job-DuERhLaj.mjs").then((mod) => mod.default),
+		"transform-tag": () => import("./transform-tag-DaNKreDj.mjs").then((mod) => mod.default),
+		setting: () => import("./setting-BZgjURQ_.mjs").then((mod) => mod.default),
+		search: () => import("./search-DjKxRXO5.mjs").then((mod) => mod.default),
+		"git-sync": () => import("./git-sync-JHa7bIyY.mjs").then((mod) => mod.default),
+		setup: () => import("./setup-D9joJYPb.mjs").then((mod) => mod.default),
+		snippet: () => import("./snippet-y_FzKxaQ.mjs").then((mod) => mod.default),
+		segment: () => import("./segment-CZkk0g79.mjs").then((mod) => mod.default),
+		measure: () => import("./measure-R3T20wnB.mjs").then((mod) => mod.default),
+		eid: () => import("./eid-XjkBbyb_.mjs").then((mod) => mod.default),
+		query: () => import("./query-DkZViD_3.mjs").then((mod) => mod.default),
+		uuid: () => import("./uuid-D_YeqDui.mjs").then((mod) => mod.default),
+		upgrade: () => import("./upgrade-BWl0VjMK.mjs").then((mod) => mod.default),
+		skills: () => import("./skills-D8NrJxjp.mjs").then((mod) => mod.default)
 	}
 });
 setMetabaseAugment(main, {
@@ -96,11 +96,128 @@ setMetabaseAugment(main, {
 		skill: "data-workflow",
 		purpose: "guided end-to-end: raw data → clean tables → metrics → answers → dashboards"
 	}],
+	inputSchema: null,
 	outputSchema: null,
 	capabilities: null
 });
 var main_default = main;
 
+//#endregion
+//#region src/runtime/command-help.ts
+const CommandHelpArg = z.object({
+	name: z.string(),
+	type: z.enum([
+		"string",
+		"boolean",
+		"positional",
+		"enum"
+	]),
+	required: z.boolean(),
+	description: z.string().optional(),
+	default: z.union([
+		z.string(),
+		z.boolean(),
+		z.number()
+	]).optional(),
+	alias: z.array(z.string()).optional(),
+	options: z.array(z.string()).optional()
+});
+const CommandHelpSkill = z.object({
+	skill: z.string(),
+	purpose: z.string()
+});
+const CommandHelpEntry = z.object({
+	command: z.string(),
+	description: z.string(),
+	details: z.string().optional(),
+	skills: z.array(CommandHelpSkill),
+	examples: z.array(z.string()),
+	args: z.array(CommandHelpArg),
+	inputSchema: z.unknown().nullable(),
+	outputSchema: z.unknown().nullable(),
+	capabilities: Capabilities.nullable()
+});
+const CommandIndexEntry = z.object({
+	command: z.string(),
+	description: z.string()
+});
+const CommandHelpIndex = z.object({ commands: z.array(CommandIndexEntry) });
+const EMPTY_AUGMENT = {
+	examples: [],
+	details: null,
+	skills: [],
+	inputSchema: null,
+	outputSchema: null,
+	capabilities: null
+};
+async function buildHelpEntry(cmd, path) {
+	const meta = await resolveCitty(cmd.meta);
+	const args = await resolveCitty(cmd.args) ?? {};
+	const augment = getMetabaseAugment(cmd) ?? EMPTY_AUGMENT;
+	const entry = {
+		command: path.join(" "),
+		description: readDescription(meta),
+		skills: Array.from(augment.skills),
+		examples: Array.from(augment.examples),
+		args: convertArgs(args),
+		inputSchema: augment.inputSchema ? z.toJSONSchema(augment.inputSchema) : null,
+		outputSchema: augment.outputSchema ? z.toJSONSchema(augment.outputSchema) : null,
+		capabilities: augment.capabilities
+	};
+	if (augment.details !== null) entry.details = augment.details;
+	return entry;
+}
+async function buildHelpIndex(cmd, path) {
+	return { commands: await walk(cmd, path) };
+}
+async function walk(cmd, path) {
+	const meta = await resolveCitty(cmd.meta);
+	if (meta?.hidden === true) return [];
+	const subCommands = await resolveCitty(cmd.subCommands);
+	if (subCommands && Object.keys(subCommands).length > 0) {
+		const groups = await Promise.all(Object.entries(subCommands).map(async ([name, lazy]) => {
+			const sub = await resolveCitty(lazy);
+			return sub ? walk(sub, [...path, name]) : [];
+		}));
+		return groups.flat();
+	}
+	return [{
+		command: path.join(" "),
+		description: readDescription(meta)
+	}];
+}
+function readDescription(meta) {
+	if (meta === void 0) return "";
+	return typeof meta.description === "string" ? meta.description : "";
+}
+function convertArgs(args) {
+	return Object.entries(args).map(([name, def]) => convertArg(name, def));
+}
+function convertArg(name, def) {
+	const arg = {
+		name,
+		type: def.type ?? "string",
+		required: def.required === true && def.default === void 0
+	};
+	if (def.description) arg.description = def.description;
+	if (isPrimitiveDefault(def.default)) arg.default = def.default;
+	const alias = readAlias(def);
+	if (alias.length > 0) arg.alias = alias;
+	const options = readOptions(def);
+	if (options.length > 0) arg.options = options;
+	return arg;
+}
+function readOptions(def) {
+	if (!("options" in def) || !Array.isArray(def.options)) return [];
+	return [...def.options];
+}
+function readAlias(def) {
+	return "alias" in def ? toAliasArray(def.alias) : [];
+}
+function isPrimitiveDefault(value) {
+	return typeof value === "string" || typeof value === "boolean" || typeof value === "number";
+}
+
 //#endregion
 //#region src/output/help.ts
 const ANSI_ESC = String.fromCharCode(27);
@@ -142,7 +259,30 @@ async function showUsage(cmd, parent, breadcrumb) {
 	if (examples.length > 0) sections.push(renderExamples(examples));
 	if (skills.length > 0) sections.push(renderSkillsSection(skills, isRoot));
 	if (isRoot) sections.push(GETTING_STARTED_HINT);
-	process.stdout.write(sections.join("\n\n") + "\n");
+	sections.push(machineHelpHint(breadcrumb ?? cittyName, hasSubCommands));
+	await writeUsage(sections.join("\n\n") + "\n");
+}
+async function showUsageJson(cmd, breadcrumb) {
+	const path = breadcrumbPath(breadcrumb);
+	const subCommands = await resolveCitty(cmd.subCommands);
+	const hasSubCommands = subCommands !== void 0 && Object.keys(subCommands).length > 0;
+	const payload = hasSubCommands ? await buildHelpIndex(cmd, path) : await buildHelpEntry(cmd, path);
+	await writeUsage(jsonLine(payload));
+}
+function writeUsage(text) {
+	return new Promise((resolve, reject) => {
+		process.stdout.write(text, (error) => error ? reject(error) : resolve());
+	});
+}
+function breadcrumbPath(breadcrumb) {
+	const segments = breadcrumb.split(" ").filter((segment) => segment.length > 0);
+	return segments[0] === CLI_NAME ? segments.slice(1) : segments;
+}
+const MACHINE_HELP_LEAF_LABEL = "Machine-readable help (flags, output schema):";
+const MACHINE_HELP_INDEX_LABEL = "Machine-readable command index:";
+function machineHelpHint(breadcrumb, hasSubCommands) {
+	const label = hasSubCommands ? MACHINE_HELP_INDEX_LABEL : MACHINE_HELP_LEAF_LABEL;
+	return `${label} ${breadcrumb} --help --json`;
 }
 function transformBody(lines, rewrite) {
 	const mapped = lines.map((line, index) => {
@@ -290,10 +430,16 @@ async function findSubCommand(subCommands, token) {
 //#endregion
 //#region src/cli.ts
 const HELP_FLAGS = new Set(["--help", "-h"]);
+const JSON_HELP_FLAG = "--json";
 async function run() {
 	const rawArgs = hoistGlobalFlags(process.argv.slice(2));
+	const wantsJsonHelp = rawArgs.includes(JSON_HELP_FLAG);
 	const showUsageWithBreadcrumb = async (cmd, parent) => {
 		const breadcrumb = await resolveBreadcrumb(main_default, rawArgs);
+		if (wantsJsonHelp) {
+			await showUsageJson(cmd, breadcrumb);
+			return;
+		}
 		await showUsage(cmd, parent, breadcrumb);
 	};
 	if (rawArgs.length === 0) {

package/dist/{collection-DrLpA1SO.mjs → collection-CFoLPrY5.mjs}

@@ -159,7 +159,7 @@ const CollectionTreeNodeBase = z.object({
 const CollectionTreeNode = CollectionTreeNodeBase.extend({ children: z.lazy(() => z.array(CollectionTreeNode)) });
 const CollectionCreateInput = z.object({
 	name: z.string().min(1),
-	description: z.string().nullable().optional(),
+	description: z.string().min(1).nullable().optional(),
 	parent_id: z.number().int().positive().nullable().optional(),
 	namespace: CollectionNamespace.nullable().optional(),
 	authority_level: CollectionAuthorityLevel.nullable().optional()

package/dist/collection-D0O9gp3S.mjs

@@ -0,0 +1,23 @@
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineCommandGroup } from "./group-CILtQqCL.mjs";
+
+//#region src/commands/collection/index.ts
+var collection_default = defineCommandGroup({
+	name: "collection",
+	description: "Manage Metabase collections",
+	skills: [{
+		skill: "core",
+		purpose: "collection ref forms and the transforms namespace"
+	}],
+	subCommands: {
+		list: () => import("./list-Cur_72xZ.mjs").then((mod) => mod.default),
+		get: () => import("./get-DWWmpQ87.mjs").then((mod) => mod.default),
+		items: () => import("./items-CEGDYWuF.mjs").then((mod) => mod.default),
+		tree: () => import("./tree-BIOphGVs.mjs").then((mod) => mod.default),
+		create: () => import("./create-C17Fh1_X.mjs").then((mod) => mod.default),
+		archive: () => import("./archive-CWtUzlHO.mjs").then((mod) => mod.default)
+	}
+});
+
+//#endregion
+export { collection_default as default };

package/dist/{collection-namespace-CsaxEqOb.mjs → collection-namespace-DqPNrCdQ.mjs}

@@ -1,5 +1,5 @@
-import { ConfigError } from "./notice-DyVl5aYB.mjs";
-import { HttpError } from "./runtime-BJtuxWM8.mjs";
+import { ConfigError } from "./capabilities-DrDJo_ng.mjs";
+import { HttpError } from "./runtime-B-c-Fc2i.mjs";
 
 //#region src/commands/transform/collection-namespace.ts
 const TRANSFORMS_NAMESPACE_HINT = "transforms can only be filed in a :transforms-namespace collection. Create one with `mb collection create --body '{\"name\":\"…\"}' --namespace transforms` and pass its id as collection_id, or omit collection_id to leave the transform uncollected.";

package/dist/{create-I5Cv-MBa.mjs → create-05rX4oL-.mjs}

@@ -1,14 +1,12 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
-import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import "./input-7Sj85_K7.mjs";
-import { readBody } from "./body-IcJ5kFtk.mjs";
-import { bodyInputFlags } from "./body-flags-DWTTxJpP.mjs";
-import "./validate-BqNW4Sk1.mjs";
-import { SEGMENT_DEFINITION_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-CcZVKYPV.mjs";
-import { Segment, SegmentCreateInput, segmentView } from "./segment-TXktTCfU.mjs";
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import "./input-m9ctfLxZ.mjs";
+import { readBody } from "./body-C1_AaTS4.mjs";
+import { bodyInputFlags } from "./body-flags-CgHgJBRC.mjs";
+import "./validate-clAWO3X-.mjs";
+import { SEGMENT_DEFINITION_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-CsK2_2_u.mjs";
+import { Segment, SegmentCreateInput, segmentView } from "./segment-BPb1H6DW.mjs";
 
 //#region src/commands/segment/create.ts
 var create_default = defineMetabaseCommand({
@@ -16,7 +14,7 @@ var create_default = defineMetabaseCommand({
 		name: "create",
 		description: "Create a segment (saved filter) from JSON"
 	},
-	details: "A segment is a reusable, saved row filter tied to a table. The JSON body needs `name`, `table_id`, and a `definition` (an MBQL query holding the filter). An MBQL 5 `definition` is checked against a bundled JSON Schema before sending; pass --skip-validate to bypass.",
+	details: "A segment is a reusable, saved row filter tied to a table. The JSON body needs `name`, `table_id`, and a `definition` (an MBQL query holding the filter). An MBQL 5 `definition` is checked against a bundled JSON Schema (print it with `mb query --print-schema`) before sending; pass --skip-validate to bypass.",
 	skills: [{
 		skill: "mbql",
 		purpose: "the definition filter clause"
@@ -29,6 +27,7 @@ var create_default = defineMetabaseCommand({
 		...bodyInputFlags,
 		...skipValidateFlag
 	},
+	inputSchema: SegmentCreateInput,
 	outputSchema: Segment,
 	examples: [
 		"cat segment.json | mb segment create",

package/dist/{create-B6LQutd0.mjs → create-BR7x66KW.mjs}

@@ -1,15 +1,13 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
-import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import "./input-7Sj85_K7.mjs";
-import { readBody } from "./body-IcJ5kFtk.mjs";
-import { bodyInputFlags } from "./body-flags-DWTTxJpP.mjs";
-import "./validate-BqNW4Sk1.mjs";
-import { TRANSFORM_SOURCE_QUERY_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-CcZVKYPV.mjs";
-import { Transform, TransformCreateInput, transformView } from "./transform-DEF38FWe.mjs";
-import { enrichTransformCollectionError } from "./collection-namespace-CsaxEqOb.mjs";
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import "./input-m9ctfLxZ.mjs";
+import { readBody } from "./body-C1_AaTS4.mjs";
+import { bodyInputFlags } from "./body-flags-CgHgJBRC.mjs";
+import "./validate-clAWO3X-.mjs";
+import { TRANSFORM_SOURCE_QUERY_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-CsK2_2_u.mjs";
+import { Transform, TransformCreateInput, transformView } from "./transform-JQel7e5H.mjs";
+import { enrichTransformCollectionError } from "./collection-namespace-DqPNrCdQ.mjs";
 
 //#region src/commands/transform/create.ts
 var create_default = defineMetabaseCommand({
@@ -17,7 +15,7 @@ var create_default = defineMetabaseCommand({
 		name: "create",
 		description: "Create a transform from JSON"
 	},
-	details: "The JSON body needs a `name`, a `source` (the query to run — native SQL or MBQL — under `source.query`), and a `target` (the warehouse table to write, with `database`/`schema`/`name`). When `source.query` is an MBQL 5 query it is checked against a bundled JSON Schema before sending; pass --skip-validate to bypass.",
+	details: "The JSON body needs a `name`, a `source` (the query to run — native SQL or MBQL — under `source.query`), and a `target` (the warehouse table to write, with `database`/`schema`/`name`). When `source.query` is an MBQL 5 query it is checked against a bundled JSON Schema (print it with `mb query --print-schema`) before sending; pass --skip-validate to bypass.",
 	skills: [{
 		skill: "mbql",
 		purpose: "MBQL source.query bodies"
@@ -30,6 +28,7 @@ var create_default = defineMetabaseCommand({
 		...bodyInputFlags,
 		...skipValidateFlag
 	},
+	inputSchema: TransformCreateInput,
 	outputSchema: Transform,
 	examples: [
 		"cat transform.json | mb transform create",

package/dist/{create-B79M8YpX.mjs → create-C17Fh1_X.mjs}

@@ -1,13 +1,11 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
-import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import "./input-7Sj85_K7.mjs";
-import { readBody } from "./body-IcJ5kFtk.mjs";
-import { bodyInputFlags } from "./body-flags-DWTTxJpP.mjs";
-import { parseEnumFlag } from "./parse-enum-BL9i_brN.mjs";
-import { Collection, CollectionCreateInput, CollectionNamespace, collectionView } from "./collection-DrLpA1SO.mjs";
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import "./input-m9ctfLxZ.mjs";
+import { readBody } from "./body-C1_AaTS4.mjs";
+import { bodyInputFlags } from "./body-flags-CgHgJBRC.mjs";
+import { parseEnumFlag } from "./parse-enum-Cfne2suT.mjs";
+import { Collection, CollectionCreateInput, CollectionNamespace, collectionView } from "./collection-CFoLPrY5.mjs";
 
 //#region src/commands/collection/create.ts
 var create_default = defineMetabaseCommand({
@@ -27,6 +25,7 @@ var create_default = defineMetabaseCommand({
 			description: `Collection namespace: ${CollectionNamespace.options.join("|")} (omit for a normal collection)`
 		}
 	},
+	inputSchema: CollectionCreateInput,
 	outputSchema: Collection,
 	examples: [
 		"cat collection.json | mb collection create",

package/dist/{create-FZOrCw5k.mjs → create-C8ndg3g4.mjs}

@@ -1,16 +1,15 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
-import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import "./input-7Sj85_K7.mjs";
-import "./field-CMY_LWUe.mjs";
-import "./parameter-CiJ4CwWE.mjs";
-import { Card, CardCreateInput, cardView } from "./card-DEmcRlNO.mjs";
-import { readBody } from "./body-IcJ5kFtk.mjs";
-import { bodyInputFlags } from "./body-flags-DWTTxJpP.mjs";
-import "./validate-BqNW4Sk1.mjs";
-import { CARD_DATASET_QUERY_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-CcZVKYPV.mjs";
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import "./input-m9ctfLxZ.mjs";
+import "./embedding-CKdw8q7p.mjs";
+import "./field-DsXTeqBy.mjs";
+import "./parameter-BZ6y-Gfs.mjs";
+import { Card, CardCreateInput, cardView } from "./card-B8G5jQQT.mjs";
+import { readBody } from "./body-C1_AaTS4.mjs";
+import { bodyInputFlags } from "./body-flags-CgHgJBRC.mjs";
+import "./validate-clAWO3X-.mjs";
+import { CARD_DATASET_QUERY_LABELS, preflightMbql5Query, skipValidateFlag } from "./validate-query-CsK2_2_u.mjs";
 
 //#region src/commands/card/create.ts
 var create_default = defineMetabaseCommand({
@@ -18,14 +17,21 @@ var create_default = defineMetabaseCommand({
 		name: "create",
 		description: "Create a card (question, model, or metric) from JSON"
 	},
-	details: "The JSON body needs `name`, `display` (the visualization — e.g. table, bar, scalar), `dataset_query` (the query powering the card), and `visualization_settings` (`{}` is fine). When `dataset_query` is an MBQL 5 query it is checked against a bundled JSON Schema before sending — fix the reported errors, or pass --skip-validate to send anyway. Native-SQL and legacy queries are sent unchecked.",
-	skills: [{
-		skill: "mbql",
-		purpose: "author the dataset_query"
-	}, {
-		skill: "visualization",
-		purpose: "choose display and visualization_settings"
-	}],
+	details: "The JSON body needs `name`, `display` (the visualization — e.g. table, bar, scalar), `dataset_query` (the query powering the card), and `visualization_settings` (`{}` is fine). When `dataset_query` is an MBQL 5 query it is checked against a bundled JSON Schema (print it with `mb query --print-schema`) before sending — fix the reported errors, or pass --skip-validate to send anyway. Native-SQL and legacy queries are sent unchecked.",
+	skills: [
+		{
+			skill: "mbql",
+			purpose: "author an MBQL dataset_query"
+		},
+		{
+			skill: "native-sql",
+			purpose: "author a native SQL dataset_query with parameters"
+		},
+		{
+			skill: "visualization",
+			purpose: "choose display and visualization_settings"
+		}
+	],
 	capabilities: { minVersion: 58 },
 	args: {
 		...outputFlags,
@@ -34,6 +40,7 @@ var create_default = defineMetabaseCommand({
 		...bodyInputFlags,
 		...skipValidateFlag
 	},
+	inputSchema: CardCreateInput,
 	outputSchema: Card,
 	examples: [
 		"cat card.json | mb card create",

package/dist/{create-C7u3umLj.mjs → create-CZ9KFnbi.mjs}

@@ -1,12 +1,10 @@
-import "./notice-DyVl5aYB.mjs";
-import { connectionFlags, outputFlags, profileFlag } from "./error-5H_tcfL8.mjs";
-import "./command-augment-DdZIfx1V.mjs";
-import { defineMetabaseCommand } from "./runtime-BJtuxWM8.mjs";
-import { renderSummary } from "./capabilities-N0jo5U7S.mjs";
-import "./input-7Sj85_K7.mjs";
-import { readBody } from "./body-IcJ5kFtk.mjs";
-import { bodyInputFlags } from "./body-flags-DWTTxJpP.mjs";
-import { Document, DocumentCreateInput, documentView } from "./document-1W7NRaO_.mjs";
+import { connectionFlags, outputFlags, profileFlag, renderSummary } from "./capabilities-DrDJo_ng.mjs";
+import "./command-augment-D9pI9Vbh.mjs";
+import { defineMetabaseCommand } from "./runtime-B-c-Fc2i.mjs";
+import "./input-m9ctfLxZ.mjs";
+import { readBody } from "./body-C1_AaTS4.mjs";
+import { bodyInputFlags } from "./body-flags-CgHgJBRC.mjs";
+import { Document, DocumentCreateInput, documentView } from "./document-CL4ML5FN.mjs";
 
 //#region src/commands/document/create.ts
 var create_default = defineMetabaseCommand({
@@ -21,6 +19,7 @@ var create_default = defineMetabaseCommand({
 		...connectionFlags,
 		...bodyInputFlags
 	},
+	inputSchema: DocumentCreateInput,
 	outputSchema: Document,
 	examples: [
 		"cat doc.json | mb document create",