andesine 0.1.0 → 0.4.0

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { Command, Option } from "@commander-js/extra-typings";
-import { chmod, link, lstat, mkdir, open, readFile, rename, unlink, writeFile } from "node:fs/promises";
+import { chmod, cp, link, lstat, mkdir, open, readFile, readdir, rename, rm, unlink, writeFile } from "node:fs/promises";
 import path from "node:path";
 import * as z from "zod";
 import { homedir } from "node:os";
@@ -13,6 +13,7 @@ import { setTimeout } from "node:timers/promises";
 import lockfile from "proper-lockfile";
 import { AndesineAPIError, AndesineStreamProtocolError, createClient, paginate, paginatePages } from "@andesine/sdk";
 import openBrowser from "open";
+import { fileURLToPath } from "node:url";
 import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { CommanderError } from "commander";
@@ -41,7 +42,7 @@ var CancelledError = class extends CLIError {
 };
 //#endregion
 //#region package.json
-var version = "0.1.0";
+var version = "0.4.0";
 //#endregion
 //#region src/config/files.ts
 /** Read declarative JSON only. Missing optional files are distinct from invalid files. */
@@ -107,7 +108,7 @@ const typesConfigSchema = z.strictObject({
 		kind: "published",
 		channel: "published"
 	}),
-	collections: z.array(nonemptyString).default([]).describe("Collection IDs or paths; empty selects all accessible collections."),
+	collections: z.array(z.union([nonemptyString, z.strictObject({ collectionSlugPath: nonemptyString })])).default([]).describe("Collection IDs, name paths, or objects with collectionSlugPath; empty selects all accessible collections."),
 	output: nonemptyString.default("src/andesine.generated.ts").describe("Output path relative to andesine.json, or the working directory when no config is present."),
 	includeEntryIDs: z.boolean().default(false),
 	includeEntryPaths: z.boolean().default(false),
@@ -951,7 +952,7 @@ const listCollections = async (client, source, signal) => {
 const validateCollections = async (client, source, selectors, signal) => {
 	let snapshotID = source.kind === "published" && "snapshotID" in source ? source.snapshotID : void 0;
 	for (const selector of selectors.length ? selectors : [void 0]) {
-		const scope = selector === void 0 ? {} : /^coll_[A-Za-z\d]+$/.test(selector) ? { collectionID: selector } : { collectionPath: selector };
+		const scope = selector === void 0 ? {} : typeof selector !== "string" ? selector : /^coll_[A-Za-z\d]+$/.test(selector) ? { collectionID: selector } : { collectionPath: selector };
 		if (source.kind === "current") await client.collections.list({
 			...scope,
 			limit: 1
@@ -967,6 +968,53 @@ const validateCollections = async (client, source, selectors, signal) => {
 	}
 };
 //#endregion
+//#region src/types/options.ts
+const validateTypeOptions = (options) => {
+	if (options.channel !== void 0 && options.snapshot !== void 0 || options.source === "current" && (options.channel !== void 0 || options.snapshot !== void 0)) throw new CLIError("Use --channel or --snapshot for published content; neither can be used with --source current.", exitCodes.usage);
+	if (options.allCollections && (options.collection || options.collectionSlugPath)) throw new CLIError("Use collection selectors or --all-collections, not both.", exitCodes.usage);
+};
+/** Apply command overrides without changing the saved configuration. */
+const collectionSelectors = (options, initial) => {
+	if (options.allCollections) return [];
+	if (options.collection === void 0 && options.collectionSlugPath === void 0) return initial;
+	return [...options.collection ?? [], ...(options.collectionSlugPath ?? []).map((collectionSlugPath) => ({ collectionSlugPath }))];
+};
+const resolveTypes = (config, options) => {
+	const initial = config.types;
+	const directory = config.configPath ? path.dirname(config.configPath) : process.cwd();
+	let source = initial.source;
+	validateTypeOptions(options);
+	if (options.source === "current") source = { kind: "current" };
+	else if (options.snapshot !== void 0) source = {
+		kind: "published",
+		snapshotID: options.snapshot
+	};
+	else if (options.source === "published" || options.channel !== void 0) {
+		const previousChannel = initial.source.kind === "published" && "channel" in initial.source ? initial.source.channel : "published";
+		source = {
+			kind: "published",
+			channel: options.channel ?? previousChannel
+		};
+	}
+	const parsed = typesConfigSchema.safeParse({
+		...initial,
+		source,
+		collections: collectionSelectors(options, initial.collections),
+		output: options.output ?? initial.output,
+		includeEntryIDs: options.includeEntryIds ?? initial.includeEntryIDs,
+		includeEntryPaths: options.includeEntryPaths ?? initial.includeEntryPaths,
+		includeTree: options.includeTree ?? initial.includeTree
+	});
+	if (!parsed.success) throw new CLIError("Invalid type options. Check the source, collection selectors, and output path.", exitCodes.usage);
+	const output = path.resolve(directory, parsed.data.output);
+	if (!/\.(?:ts|mts|cts)$/.test(output) || output === config.configPath) throw new CLIError("The types output must be a TypeScript file, separate from the configuration.", exitCodes.usage);
+	return {
+		...parsed.data,
+		collections: [...new Set(parsed.data.collections)],
+		output
+	};
+};
+//#endregion
 //#region src/init/choices.ts
 const selectSource = async (context, client, options, initial) => {
 	const interactive = canPrompt(options.interactive);
@@ -1032,12 +1080,12 @@ const selectSource = async (context, client, options, initial) => {
 const selectTypes = async (context, client, options, initial) => {
 	const interactive = canPrompt(options.interactive);
 	const source = await selectSource(context, client, options, initial.source);
-	let collections = options.allCollections ? [] : options.collection ?? initial.collections;
+	let collections = collectionSelectors(options, initial.collections);
 	let output = options.output ?? initial.output;
 	let includeEntryIDs = options.includeEntryIds ?? initial.includeEntryIDs;
 	let includeEntryPaths = options.includeEntryPaths ?? initial.includeEntryPaths;
 	let includeTree = options.includeTree ?? initial.includeTree;
-	if (interactive && options.collection === void 0 && !options.allCollections) {
+	if (interactive && options.collection === void 0 && options.collectionSlugPath === void 0 && !options.allCollections) {
 		if (!collections.length || await context.prompt((prompt) => confirm({
 			...prompt,
 			message: "Change the saved collection selection?",
@@ -1048,28 +1096,36 @@ const selectTypes = async (context, client, options, initial) => {
 				const format = await context.prompt((prompt) => select({
 					...prompt,
 					message: "How should collections be saved?",
-					options: [{
-						value: "id",
-						label: "IDs",
-						hint: "Stable when collections are renamed"
-					}, {
-						value: "path",
-						label: "Paths",
-						hint: "Readable names from the explorer"
-					}]
+					options: [
+						{
+							value: "id",
+							label: "IDs",
+							hint: "Stable when collections are renamed"
+						},
+						{
+							value: "path",
+							label: "Paths",
+							hint: "Readable names from the explorer"
+						},
+						{
+							value: "slug",
+							label: "Slug paths",
+							hint: "URL paths derived from names"
+						}
+					]
 				}));
 				const selected = await context.prompt((prompt) => multiselect({
 					...prompt,
 					message: "Collections (leave empty for all)",
 					required: false,
-					initialValues: available.filter((item) => collections.includes(item.id) || collections.includes(item.path)).map((item) => item.id),
+					initialValues: available.filter((item) => collections.some((selector) => typeof selector === "string" ? selector === item.id || selector === item.path : selector.collectionSlugPath === item.slugPath)).map((item) => item.id),
 					options: available.map((item) => ({
 						value: item.id,
 						label: item.path,
 						hint: item.id
 					}))
 				}));
-				collections = available.filter((item) => selected.includes(item.id)).map((item) => format === "id" ? item.id : item.path);
+				collections = available.filter((item) => selected.includes(item.id)).map((item) => format === "id" ? item.id : format === "slug" ? { collectionSlugPath: item.slugPath } : item.path);
 			} else {
 				collections = [];
 				await context.output.diagnostic("No collections yet. The configuration will include all collections as they become available.");
@@ -1174,48 +1230,6 @@ const writeProjectConfig = async (file, config, expected, signal) => {
 	}
 };
 //#endregion
-//#region src/types/options.ts
-const validateTypeOptions = (options) => {
-	if (options.channel !== void 0 && options.snapshot !== void 0 || options.source === "current" && (options.channel !== void 0 || options.snapshot !== void 0)) throw new CLIError("Use --channel or --snapshot for published content; neither can be used with --source current.", exitCodes.usage);
-	if (options.allCollections && options.collection) throw new CLIError("Use --collection or --all-collections, not both.", exitCodes.usage);
-};
-/** Apply command overrides without changing the saved configuration. */
-const resolveTypes = (config, options) => {
-	const initial = config.types;
-	const directory = config.configPath ? path.dirname(config.configPath) : process.cwd();
-	let source = initial.source;
-	validateTypeOptions(options);
-	if (options.source === "current") source = { kind: "current" };
-	else if (options.snapshot !== void 0) source = {
-		kind: "published",
-		snapshotID: options.snapshot
-	};
-	else if (options.source === "published" || options.channel !== void 0) {
-		const previousChannel = initial.source.kind === "published" && "channel" in initial.source ? initial.source.channel : "published";
-		source = {
-			kind: "published",
-			channel: options.channel ?? previousChannel
-		};
-	}
-	const parsed = typesConfigSchema.safeParse({
-		...initial,
-		source,
-		collections: options.allCollections ? [] : options.collection ?? initial.collections,
-		output: options.output ?? initial.output,
-		includeEntryIDs: options.includeEntryIds ?? initial.includeEntryIDs,
-		includeEntryPaths: options.includeEntryPaths ?? initial.includeEntryPaths,
-		includeTree: options.includeTree ?? initial.includeTree
-	});
-	if (!parsed.success) throw new CLIError("Invalid type options. Check the source, collection selectors, and output path.", exitCodes.usage);
-	const output = path.resolve(directory, parsed.data.output);
-	if (!/\.(?:ts|mts|cts)$/.test(output) || output === config.configPath) throw new CLIError("The types output must be a TypeScript file, separate from the configuration.", exitCodes.usage);
-	return {
-		...parsed.data,
-		collections: [...new Set(parsed.data.collections)],
-		output
-	};
-};
-//#endregion
 //#region src/api/errors.ts
 /** Keep structured API failures on stderr without exposing response bodies or credentials. */
 const reportAPIError = async (context, error) => {
@@ -1374,7 +1388,7 @@ const treeTypes = (metadata, collectionNames) => {
 		const childEntries = row.entryIDs.map((id) => {
 			const entry = entries.get(id);
 			if (!entry || entry.collectionID !== collection.id) throw new Error(`Invalid tree entry reference ${literal(id)}.`);
-			return `Omit<SDK.PublishedEntry, "id" | "name" | "path"> & { id: ${literal(id)}; name: ${literal(entry.name)}; path: ${literal(entry.path)} }`;
+			return `Omit<SDK.PublishedEntry, "id" | "name" | "path" | "slugPath"> & { id: ${literal(id)}; name: ${literal(entry.name)}; path: ${literal(entry.path)}; slugPath: ${literal(entry.slugPath)} }`;
 		});
 		if (metadata.source.kind === "current") return `export interface ${name} {
   collectionID: ${literal(collection.id)};
@@ -1385,6 +1399,7 @@ const treeTypes = (metadata, collectionNames) => {
   id: ${literal(collection.id)};
   name: ${literal(collection.name)};
   path: ${literal(collection.path)};
+  slugPath: ${literal(collection.slugPath)};
   entries: ${tuple(childEntries)};
   collections: ${tuple(childTrees)};
 }`;
@@ -1443,12 +1458,13 @@ const generateTypes = (metadata, options = {}) => {
 	const treeBindings = [];
 	const contentBase = `Omit<${metadata.source.kind === "published" ? "SDK.PublishedEntryContent" : "SDK.Entry"}, "schema" | "properties" | "fragments">`;
 	const bind = (map, key, value) => {
-		if (map.has(key)) throw new Error(`Duplicate metadata selector ${literal(key)}.`);
+		if (map.has(key) && map.get(key) !== value) throw new Error(`Duplicate metadata selector ${literal(key)}.`);
 		map.set(key, value);
 	};
 	for (const collection of collections) {
 		const name = collectionNames.get(collection.id ?? "/");
 		bind(collectionBindings, collection.path, name);
+		if (collection.slugPath !== collection.path) bind(collectionBindings, collection.slugPath, name);
 		if (collection.id !== null) bind(collectionBindings, collection.id, name);
 	}
 	for (const entry of entries) {
@@ -1456,7 +1472,10 @@ const generateTypes = (metadata, options = {}) => {
 		if (entry.schemaRevisionID !== null) usedRevisions.add(entry.schemaRevisionID);
 		const binding = `{ collection: ${literal(entry.collectionID ?? "/")}; schemaRevisionID: ${literal(entry.schemaRevisionID)} }`;
 		if (options.includeEntryIDs) bind(entryBindings, entry.id, binding);
-		if (options.includeEntryPaths) bind(entryBindings, entry.path, binding);
+		if (options.includeEntryPaths) {
+			bind(entryBindings, entry.path, binding);
+			if (entry.slugPath !== entry.path) bind(entryBindings, entry.slugPath, binding);
+		}
 	}
 	const revisionNames = names([...usedRevisions].map((id) => ({
 		key: id,
@@ -1483,6 +1502,7 @@ const generateTypes = (metadata, options = {}) => {
 		interfaces.push(`export interface ${name} extends SDK.WorkspaceCollection {
   id: ${literal(collection.id)};
   path: ${literal(collection.path)};
+  slugPath: ${literal(collection.slugPath)};
   schemaRevisionIDs: readonly ${tuple(ids.map(literal))};
   descendants: readonly ${tuple(childIDs.map(literal))};
 }`);
@@ -1490,9 +1510,10 @@ const generateTypes = (metadata, options = {}) => {
 		types.push(`export type ${name}StructuredContent = SDK.StructuredContent<${name}Content>;`);
 		const collectionEntries = entries.filter((entry) => entry.collectionID === collection.id);
 		if (options.includeEntryIDs) types.push(`export type ${name}EntryID = ${union(collectionEntries.map((entry) => literal(entry.id)))};`);
-		if (options.includeEntryPaths) types.push(`export type ${name}EntryPath = ${union(collectionEntries.map((entry) => literal(entry.path)))};`);
+		if (options.includeEntryPaths) types.push(`export type ${name}EntryPath = ${union(collectionEntries.map((entry) => literal(entry.path)))};`, `export type ${name}EntrySlugPath = ${union(collectionEntries.map((entry) => literal(entry.slugPath)))};`);
 		if (options.includeTree) {
 			treeBindings.push(`    ${literal(collection.path)}: ${name}Tree;`);
+			if (collection.slugPath !== collection.path) treeBindings.push(`    ${literal(collection.slugPath)}: ${name}Tree;`);
 			if (collection.id !== null) treeBindings.push(`    ${literal(collection.id)}: ${name}Tree;`);
 		}
 	}
@@ -1515,7 +1536,7 @@ const generateTypes = (metadata, options = {}) => {
 		[
 			GENERATED_TYPES_MARKER,
 			`// Workspace: ${literal(metadata.workspaceID)}; source: ${json(source)}.`,
-			`// Collections: ${json([...new Set(options.collections ?? [])].sort(compare))}; entry IDs: ${Boolean(options.includeEntryIDs)}; entry paths: ${Boolean(options.includeEntryPaths)}; tree: ${Boolean(options.includeTree)}.`,
+			`// Collections: ${json([...options.collections ?? []].sort((a, b) => compare(json(a), json(b))))}; entry IDs: ${Boolean(options.includeEntryIDs)}; entry paths: ${Boolean(options.includeEntryPaths)}; tree: ${Boolean(options.includeTree)}.`,
 			"// Types only. Configure the runtime client for the same workspace and source."
 		].join("\n"),
 		"import type * as SDK from \"@andesine/sdk\";",
@@ -1670,7 +1691,7 @@ const executeTypes = async (context, options = {}, emitResult = true) => {
 	await output.heading(`Andesine · ${options.check ? "Check" : options.watch ? "Watch" : "Generate"} content types`);
 	await output.note("Type generation", {
 		Source: JSON.stringify(types.source),
-		Collections: types.collections.join(", ") || "All accessible collections",
+		Collections: types.collections.map((selector) => typeof selector === "string" ? selector : selector.collectionSlugPath).join(", ") || "All accessible collections",
 		Output: types.output
 	});
 	if (options.watch) await output.diagnostic(`Watching every ${interval / 1e3}s. Press Ctrl+C to stop.`);
@@ -1753,7 +1774,7 @@ const describeConfig = (config) => ({
 	"Workspace": config.workspaceID,
 	"Profile": config.profile,
 	"Source": config.types ? JSON.stringify(config.types.source) : void 0,
-	"Collections": config.types ? config.types.collections.join(", ") || "All accessible collections" : void 0,
+	"Collections": config.types ? config.types.collections.map((selector) => typeof selector === "string" ? selector : selector.collectionSlugPath).join(", ") || "All accessible collections" : void 0,
 	"Output": config.types?.output,
 	"Entry IDs": config.types ? String(config.types.includeEntryIDs) : void 0,
 	"Entry paths": config.types ? String(config.types.includeEntryPaths) : void 0,
@@ -1847,6 +1868,42 @@ const init = async (options, signal) => {
 	});
 };
 //#endregion
+//#region src/pages/init.ts
+const templateDirectory = fileURLToPath(new URL("./templates/pages/", import.meta.url));
+const isEmptyDirectory = async (directory) => {
+	try {
+		return (await readdir(directory)).length === 0;
+	} catch (error) {
+		if (error.code === "ENOENT") return true;
+		throw error;
+	}
+};
+/** Package names allow lowercase letters, digits, and `-._~` only. */
+const toPackageName = (directory) => {
+	return path.basename(directory).toLowerCase().replace(/[^a-z\d._~-]+/g, "-").replace(/^[._-]+|[-]+$/g, "") || "andesine-pages-site";
+};
+/** Creates an Andesine Pages site from the template in an empty directory. */
+const initPages = async (directory, output) => {
+	const target = path.resolve(directory);
+	const manifestPath = path.join(target, "package.json");
+	if (!await isEmptyDirectory(target)) throw new CLIError(`${directory} is not empty. Choose a new or empty directory.`, exitCodes.usage);
+	await output.progress("Copying the template", async () => {
+		const manifest = JSON.parse(await readFile(path.join(templateDirectory, "package.template.json"), "utf8"));
+		await cp(templateDirectory, target, { recursive: true });
+		await rename(path.join(target, "gitignore"), path.join(target, ".gitignore"));
+		await rm(path.join(target, "package.template.json"));
+		await writeFile(manifestPath, `${JSON.stringify({
+			...manifest,
+			name: toPackageName(target)
+		}, null, 2)}\n`);
+	}, "Template copied");
+	await output.note("Next steps", {
+		"Open the site": `cd ${path.relative(process.cwd(), target) || "."}`,
+		"Install": "npm install",
+		"Start": "npm run dev"
+	});
+};
+//#endregion
 //#region src/api/manifest.ts
 const commands = [
 	{
@@ -2141,7 +2198,7 @@ const commands = [
 		method: "get",
 		path: "/assets/search",
 		summary: "Search assets",
-		description: "Finds workspace images by text or SHA-256 checksum. Semantic search defaults to true. Returns up to 50 results.\n\nRequired API key permissions: read:entries, read:collections. Write permissions also grant read access for the same resource.",
+		description: "Finds workspace images by text or SHA-256 checksum. Semantic search defaults to true and uses 1 AI credit for a text query. Returns up to 50 results.\n\nRequired API key permissions: read:entries, read:collections. Write permissions also grant read access for the same resource.",
 		example: {
 			query: "mountains",
 			limit: 10
@@ -2331,7 +2388,7 @@ const commands = [
 		method: "post",
 		path: "/collections",
 		summary: "Create a collection",
-		description: "Creates a child collection. Without parentID, uses the workspace root. The name defaults to Untitled. Creation selects an available sibling name with a numeric suffix when needed. Names are trimmed, NFC-normalized, case-sensitive, and shared by sibling entries and collections. Names cannot contain a slash or equal a single dot or two dots. Restricted collections require a session with restricted_collections permission and the Pro plan; API keys cannot create them.\n\nRequired API key permissions: collections. Write permissions also grant read access for the same resource.",
+		description: "Creates a child collection. Without parentID, uses the workspace root. The name defaults to Untitled. Creation selects an available sibling name with a numeric suffix when needed. Names are trimmed and NFC-normalized. Derived URL slugs must be unique across sibling entries and collections, including case and punctuation variants. Names cannot contain a slash or equal a single dot or two dots. Restricted collections require a session with restricted_collections permission and the Pro plan; API keys cannot create them.\n\nRequired API key permissions: collections. Write permissions also grant read access for the same resource.",
 		example: {
 			name: "Documentation",
 			parentID: "coll_example"
@@ -2481,6 +2538,18 @@ const commands = [
 				kind: "string",
 				nullable: false
 			},
+			{
+				name: "collectionSlugPath",
+				location: "query",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Decoded derived slug path, such as /docs/getting-started or coll_ID/getting-started. Use the returned slugPath without URL encoding."
+				},
+				flag: "collection-slug-path",
+				kind: "string",
+				nullable: false
+			},
 			{
 				name: "cursor",
 				location: "query",
@@ -2620,6 +2689,18 @@ const commands = [
 				kind: "string",
 				nullable: false
 			},
+			{
+				name: "slugPath",
+				location: "query",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Decoded derived slug path, such as /docs/getting-started or coll_ID/getting-started. Use the returned slugPath without URL encoding."
+				},
+				flag: "slug-path",
+				kind: "string",
+				nullable: false
+			},
 			{
 				name: "expectedSchemaHash",
 				location: "query",
@@ -2795,6 +2876,18 @@ const commands = [
 				kind: "string",
 				nullable: false
 			},
+			{
+				name: "slugPath",
+				location: "query",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Decoded derived slug path, such as /docs/getting-started or coll_ID/getting-started. Use the returned slugPath without URL encoding."
+				},
+				flag: "slug-path",
+				kind: "string",
+				nullable: false
+			},
 			{
 				name: "channel",
 				location: "query",
@@ -2874,6 +2967,18 @@ const commands = [
 				kind: "string",
 				nullable: false
 			},
+			{
+				name: "collectionSlugPath",
+				location: "query",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Decoded derived slug path, such as /docs/getting-started or coll_ID/getting-started. Use the returned slugPath without URL encoding."
+				},
+				flag: "collection-slug-path",
+				kind: "string",
+				nullable: false
+			},
 			{
 				name: "channel",
 				location: "query",
@@ -2924,7 +3029,7 @@ const commands = [
 		method: "get",
 		path: "/content/collections",
 		summary: "List published collections",
-		description: "Returns a flat page of collections from a publication snapshot. The default channel is published. On later pages, pass the returned snapshotID and pagination.nextCursor, and omit channel. Optionally select direct children using collectionID or collectionPath. Results are ordered by ID, not display order.\n\nRequired API key permissions: read:publishing. Write permissions also grant read access for the same resource.",
+		description: "Returns a flat page of collections from a publication snapshot. The default channel is published. On later pages, pass the returned snapshotID and pagination.nextCursor, and omit channel. Optionally select direct children using collectionID, collectionPath, or collectionSlugPath. Results are ordered by ID, not display order.\n\nRequired API key permissions: read:publishing. Write permissions also grant read access for the same resource.",
 		example: {
 			channel: "published",
 			limit: 20
@@ -2982,6 +3087,18 @@ const commands = [
 				kind: "string",
 				nullable: false
 			},
+			{
+				name: "collectionSlugPath",
+				location: "query",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Decoded derived slug path, such as /docs/getting-started or coll_ID/getting-started. Use the returned slugPath without URL encoding."
+				},
+				flag: "collection-slug-path",
+				kind: "string",
+				nullable: false
+			},
 			{
 				name: "channel",
 				location: "query",
@@ -3031,7 +3148,7 @@ const commands = [
 		method: "get",
 		path: "/content/entries",
 		summary: "List published entries",
-		description: "Returns a flat page of entries from a publication snapshot. The default channel is published. On later pages, pass the returned snapshotID and pagination.nextCursor, and omit channel. Select direct children using collectionID or collectionPath, or include nested entries with descendants: true. descendants requires a collection scope. All property filters must match the assigned version. includeContent: true returns validated full content, properties, fragments, assets, and recorded schema metadata. An invalid full item fails the page. Keep the same scope and filters across pages. Results are ordered by ID, not display order.\n\nRequired API key permissions: read:publishing. Write permissions also grant read access for the same resource.",
+		description: "Returns a flat page of entries from a publication snapshot. The default channel is published. On later pages, pass the returned snapshotID and pagination.nextCursor, and omit channel. Select direct children using collectionID, collectionPath, or collectionSlugPath, or include nested entries with descendants: true. descendants requires a collection scope. All property filters must match the assigned version. includeContent: true returns validated full content, properties, fragments, assets, and recorded schema metadata. An invalid full item fails the page. Keep the same scope and filters across pages. Results are ordered by ID, not display order.\n\nRequired API key permissions: read:publishing. Write permissions also grant read access for the same resource.",
 		example: {
 			channel: "published",
 			limit: 20
@@ -3089,6 +3206,18 @@ const commands = [
 				kind: "string",
 				nullable: false
 			},
+			{
+				name: "collectionSlugPath",
+				location: "query",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Decoded derived slug path, such as /docs/getting-started or coll_ID/getting-started. Use the returned slugPath without URL encoding."
+				},
+				flag: "collection-slug-path",
+				kind: "string",
+				nullable: false
+			},
 			{
 				name: "channel",
 				location: "query",
@@ -3218,7 +3347,7 @@ const commands = [
 		method: "post",
 		path: "/entries",
 		summary: "Create an entry",
-		description: "Creates an entry and its initial document. The name defaults to Untitled. Creation selects an available sibling name with a numeric suffix when needed. Names are trimmed, NFC-normalized, case-sensitive, and shared by sibling entries and collections. Names cannot contain a slash or equal a single dot or two dots. A collection schema can set the initial content.\n\nRequired API key permissions: entries. Write permissions also grant read access for the same resource.",
+		description: "Creates an entry and its initial document. The name defaults to Untitled. Creation selects an available sibling name with a numeric suffix when needed. Names are trimmed and NFC-normalized. Derived URL slugs must be unique across sibling entries and collections, including case and punctuation variants. Names cannot contain a slash or equal a single dot or two dots. A collection schema can set the initial content.\n\nRequired API key permissions: entries. Write permissions also grant read access for the same resource.",
 		example: {
 			name: "Getting started",
 			collectionID: "coll_example"
@@ -3352,6 +3481,18 @@ const commands = [
 				kind: "string",
 				nullable: false
 			},
+			{
+				name: "slugPath",
+				location: "query",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Decoded derived slug path, such as /docs/getting-started or coll_ID/getting-started. Use the returned slugPath without URL encoding."
+				},
+				flag: "slug-path",
+				kind: "string",
+				nullable: false
+			},
 			{
 				name: "expectedSchemaHash",
 				location: "query",
@@ -3419,6 +3560,18 @@ const commands = [
 				kind: "string",
 				nullable: false
 			},
+			{
+				name: "collectionSlugPath",
+				location: "query",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Decoded derived slug path, such as /docs/getting-started or coll_ID/getting-started. Use the returned slugPath without URL encoding."
+				},
+				flag: "collection-slug-path",
+				kind: "string",
+				nullable: false
+			},
 			{
 				name: "cursor",
 				location: "query",
@@ -5627,6 +5780,18 @@ const commands = [
 				kind: "string",
 				nullable: false
 			},
+			{
+				name: "collectionSlugPath",
+				location: "query",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Decoded derived slug path, such as /docs/getting-started or coll_ID/getting-started. Use the returned slugPath without URL encoding."
+				},
+				flag: "collection-slug-path",
+				kind: "string",
+				nullable: false
+			},
 			{
 				name: "x-workspace-id",
 				location: "header",
@@ -5922,7 +6087,7 @@ const commands = [
 		method: "post",
 		path: "/search/current/ask",
 		summary: "Ask AI about current content",
-		description: "Returns a complete answer with numbered sources. Requires explicit ai-answers permission in addition to content read permissions. Accepts up to 1,000 question characters, 10 history messages of up to 4,000 characters each, and 20 property filters. Uses the existing Ask AI rate limit. Keep API keys on your server.\n\nRequired API key permissions: ai-answers, read:entries, read:collections. Write permissions also grant read access for the same resource.",
+		description: "Returns a complete answer with numbered sources. Requires explicit ai-answers permission in addition to content read permissions. Accepts up to 1,000 question characters, 10 history messages of up to 4,000 characters each, and 20 property filters. Uses 3 AI credits and the Ask AI rate limit. Use a secret key on your server, or a publishable key for published content.\n\nRequired API key permissions: ai-answers, read:entries, read:collections. Write permissions also grant read access for the same resource.",
 		example: { question: "How do I install Andesine?" },
 		security: [{ apiKey: [] }, { oauth: [] }],
 		fields: [
@@ -5975,6 +6140,18 @@ const commands = [
 				kind: "string",
 				nullable: false
 			},
+			{
+				name: "collectionSlugPath",
+				location: "body",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Decoded derived slug path, such as /docs/getting-started or coll_ID/getting-started. Use the returned slugPath without URL encoding."
+				},
+				flag: "collection-slug-path",
+				kind: "string",
+				nullable: false
+			},
 			{
 				name: "filters",
 				location: "body",
@@ -6014,7 +6191,7 @@ const commands = [
 		method: "post",
 		path: "/search/current/ask/stream",
 		summary: "Stream an AI answer about current content",
-		description: "Emits sources, textDelta, and completed events over SSE. Uses the same inputs, permissions, and rate limit as complete answers. Stream errors use SSE error frames. Never reconnect automatically.\n\nRequired API key permissions: ai-answers, read:entries, read:collections. Write permissions also grant read access for the same resource.",
+		description: "Emits sources, textDelta, and completed events over SSE. Uses the same inputs, permissions, AI credits, and rate limit as complete answers. Stream errors use SSE error frames. Never reconnect automatically.\n\nRequired API key permissions: ai-answers, read:entries, read:collections. Write permissions also grant read access for the same resource.",
 		security: [{ apiKey: [] }, { oauth: [] }],
 		fields: [
 			{
@@ -6066,6 +6243,18 @@ const commands = [
 				kind: "string",
 				nullable: false
 			},
+			{
+				name: "collectionSlugPath",
+				location: "body",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Decoded derived slug path, such as /docs/getting-started or coll_ID/getting-started. Use the returned slugPath without URL encoding."
+				},
+				flag: "collection-slug-path",
+				kind: "string",
+				nullable: false
+			},
 			{
 				name: "filters",
 				location: "body",
@@ -6105,7 +6294,7 @@ const commands = [
 		method: "post",
 		path: "/search/published/ask",
 		summary: "Ask AI about published content",
-		description: "Returns a complete answer with numbered sources. Requires explicit ai-answers permission in addition to content read permissions. Accepts up to 1,000 question characters, 10 history messages of up to 4,000 characters each, and 20 property filters. Uses the existing Ask AI rate limit. Keep API keys on your server.\n\nRequired API key permissions: ai-answers, read:publishing. Write permissions also grant read access for the same resource.",
+		description: "Returns a complete answer with numbered sources. Requires explicit ai-answers permission in addition to content read permissions. Accepts up to 1,000 question characters, 10 history messages of up to 4,000 characters each, and 20 property filters. Uses 3 AI credits and the Ask AI rate limit. Use a secret key on your server, or a publishable key for published content.\n\nRequired API key permissions: ai-answers, read:publishing. Write permissions also grant read access for the same resource.",
 		example: {
 			question: "How do I install Andesine?",
 			channel: "published"
@@ -6161,6 +6350,18 @@ const commands = [
 				kind: "string",
 				nullable: false
 			},
+			{
+				name: "collectionSlugPath",
+				location: "body",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Decoded derived slug path, such as /docs/getting-started or coll_ID/getting-started. Use the returned slugPath without URL encoding."
+				},
+				flag: "collection-slug-path",
+				kind: "string",
+				nullable: false
+			},
 			{
 				name: "filters",
 				location: "body",
@@ -6214,7 +6415,7 @@ const commands = [
 		method: "post",
 		path: "/search/published/ask/stream",
 		summary: "Stream an AI answer about published content",
-		description: "Emits sources, textDelta, and completed events over SSE. Uses the same inputs, permissions, and rate limit as complete answers. Stream errors use SSE error frames. Never reconnect automatically.\n\nRequired API key permissions: ai-answers, read:publishing. Write permissions also grant read access for the same resource.",
+		description: "Emits sources, textDelta, and completed events over SSE. Uses the same inputs, permissions, AI credits, and rate limit as complete answers. Stream errors use SSE error frames. Never reconnect automatically.\n\nRequired API key permissions: ai-answers, read:publishing. Write permissions also grant read access for the same resource.",
 		security: [{ apiKey: [] }, { oauth: [] }],
 		fields: [
 			{
@@ -6266,6 +6467,18 @@ const commands = [
 				kind: "string",
 				nullable: false
 			},
+			{
+				name: "collectionSlugPath",
+				location: "body",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Decoded derived slug path, such as /docs/getting-started or coll_ID/getting-started. Use the returned slugPath without URL encoding."
+				},
+				flag: "collection-slug-path",
+				kind: "string",
+				nullable: false
+			},
 			{
 				name: "filters",
 				location: "body",
@@ -6319,7 +6532,7 @@ const commands = [
 		method: "post",
 		path: "/search/current",
 		summary: "Search current content",
-		description: "Searches current entry content by text and optional property filters. Up to 20 filters and 50 results are allowed. Semantic search is optional and has a separate rate limit.\n\nRequired API key permissions: read:entries, read:collections. Write permissions also grant read access for the same resource.",
+		description: "Searches current entry content by text and optional property filters. Up to 20 filters and 50 results are allowed. Semantic search is optional, uses 1 AI credit, and has a separate rate limit.\n\nRequired API key permissions: read:entries, read:collections. Write permissions also grant read access for the same resource.",
 		example: {
 			query: "installation",
 			limit: 10
@@ -6374,6 +6587,18 @@ const commands = [
 				kind: "string",
 				nullable: false
 			},
+			{
+				name: "collectionSlugPath",
+				location: "body",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Decoded derived slug path, such as /docs/getting-started or coll_ID/getting-started. Use the returned slugPath without URL encoding."
+				},
+				flag: "collection-slug-path",
+				kind: "string",
+				nullable: false
+			},
 			{
 				name: "filters",
 				location: "body",
@@ -6426,7 +6651,7 @@ const commands = [
 		method: "post",
 		path: "/search/published",
 		summary: "Search published content",
-		description: "Searches content published to the required channel. Up to 20 filters and 50 results are allowed. Semantic search is optional and has a separate rate limit.\n\nRequired API key permissions: read:publishing. Write permissions also grant read access for the same resource.",
+		description: "Searches content published to the required channel. Up to 20 filters and 50 results are allowed. Semantic search is optional, uses 1 AI credit, and has a separate rate limit.\n\nRequired API key permissions: read:publishing. Write permissions also grant read access for the same resource.",
 		example: {
 			query: "installation",
 			channel: "published",
@@ -6482,6 +6707,18 @@ const commands = [
 				kind: "string",
 				nullable: false
 			},
+			{
+				name: "collectionSlugPath",
+				location: "body",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Decoded derived slug path, such as /docs/getting-started or coll_ID/getting-started. Use the returned slugPath without URL encoding."
+				},
+				flag: "collection-slug-path",
+				kind: "string",
+				nullable: false
+			},
 			{
 				name: "filters",
 				location: "body",
@@ -6574,15 +6811,26 @@ const commands = [
 				schema: {
 					type: "array",
 					maxItems: 100,
-					items: { anyOf: [{
-						type: "string",
-						pattern: "^coll_[A-Za-z\\d]{1,22}$"
-					}, {
-						type: "string",
-						description: "Decoded content path, such as /Docs/Page or coll_ID/Page. Names are case-sensitive. Do not URL-encode names before passing them to the SDK."
-					}] },
+					items: { anyOf: [
+						{
+							type: "string",
+							pattern: "^coll_[A-Za-z\\d]{1,22}$"
+						},
+						{
+							type: "string",
+							description: "Decoded content path, such as /Docs/Page or coll_ID/Page. Names are case-sensitive. Do not URL-encode names before passing them to the SDK."
+						},
+						{
+							type: "object",
+							properties: { collectionSlugPath: {
+								type: "string",
+								description: "Decoded derived slug path, such as /docs/getting-started or coll_ID/getting-started. Use the returned slugPath without URL encoding."
+							} },
+							required: ["collectionSlugPath"]
+						}
+					] },
 					default: [],
-					description: "Collection IDs or paths. Includes selected subtrees; empty selects all accessible collections."
+					description: "Collection IDs, name paths, or objects with collectionSlugPath. Includes selected subtrees; empty selects all accessible collections."
 				},
 				flag: "collections",
 				kind: "json",
@@ -6651,15 +6899,26 @@ const commands = [
 				schema: {
 					type: "array",
 					maxItems: 100,
-					items: { anyOf: [{
-						type: "string",
-						pattern: "^coll_[A-Za-z\\d]{1,22}$"
-					}, {
-						type: "string",
-						description: "Decoded content path, such as /Docs/Page or coll_ID/Page. Names are case-sensitive. Do not URL-encode names before passing them to the SDK."
-					}] },
+					items: { anyOf: [
+						{
+							type: "string",
+							pattern: "^coll_[A-Za-z\\d]{1,22}$"
+						},
+						{
+							type: "string",
+							description: "Decoded content path, such as /Docs/Page or coll_ID/Page. Names are case-sensitive. Do not URL-encode names before passing them to the SDK."
+						},
+						{
+							type: "object",
+							properties: { collectionSlugPath: {
+								type: "string",
+								description: "Decoded derived slug path, such as /docs/getting-started or coll_ID/getting-started. Use the returned slugPath without URL encoding."
+							} },
+							required: ["collectionSlugPath"]
+						}
+					] },
 					default: [],
-					description: "Collection IDs or paths. Includes selected subtrees; empty selects all accessible collections."
+					description: "Collection IDs, name paths, or objects with collectionSlugPath. Includes selected subtrees; empty selects all accessible collections."
 				},
 				flag: "collections",
 				kind: "json",
@@ -6998,32 +7257,1224 @@ const commands = [
 		response: "empty"
 	},
 	{
-		id: "workspaces.list",
-		group: "workspaces",
-		command: "list",
-		method: "get",
-		path: "/workspaces",
-		summary: "List available workspaces",
-		description: "Lists workspaces available to the OAuth user, with current role permissions and plan access. Browser sessions can list workspaces across signed-in accounts. Does not require workspace selection and does not count toward API usage.",
-		security: [{ oauth: [] }],
-		fields: [],
-		conditional: false,
-		response: "json"
-	}
-];
-const schemas = {
-	PropertyFilter: { anyOf: [
-		{ $ref: "#/components/schemas/TextPropertyFilter" },
-		{ $ref: "#/components/schemas/NumberPropertyFilter" },
-		{ $ref: "#/components/schemas/BooleanPropertyFilter" },
-		{ $ref: "#/components/schemas/DatePropertyFilter" }
-	] },
-	TextPropertyFilter: {
-		type: "object",
-		properties: {
-			kind: { const: "text" },
-			key: {
-				type: "string",
+		id: "webhooks.bulkDelete",
+		group: "webhooks",
+		command: "bulk-delete",
+		method: "post",
+		path: "/webhooks/bulk/delete",
+		summary: "Delete webhooks",
+		description: "Deletes every listed webhook in one transaction, checking each expectedRevision. Each deletion cancels pending deliveries and destroys signing keys; history stays until its original expiry.\n\nRequired API key permissions: webhooks. Write permissions also grant read access for the same resource.",
+		security: [{ apiKey: [] }, { oauth: [] }],
+		fields: [{
+			name: "x-workspace-id",
+			location: "header",
+			required: false,
+			schema: {
+				type: "string",
+				description: "Required for OAuth: ID of the workspace to access. API keys use their own workspace."
+			},
+			flag: "x-workspace-id",
+			kind: "string",
+			nullable: false
+		}, {
+			name: "webhooks",
+			location: "body",
+			required: true,
+			schema: {
+				type: "array",
+				minItems: 1,
+				maxItems: 10,
+				items: {
+					type: "object",
+					properties: {
+						id: {
+							type: "string",
+							pattern: "^wh_[A-Za-z\\d]{1,22}$"
+						},
+						expectedRevision: {
+							type: "integer",
+							minimum: -9007199254740991,
+							maximum: 9007199254740991,
+							exclusiveMinimum: 0
+						}
+					},
+					required: ["id", "expectedRevision"],
+					additionalProperties: false
+				}
+			},
+			flag: "webhooks",
+			kind: "json",
+			nullable: false
+		}],
+		conditional: false,
+		response: "empty"
+	},
+	{
+		id: "webhooks.bulkRedeliver",
+		group: "webhooks",
+		command: "bulk-redeliver",
+		method: "post",
+		path: "/webhooks/{id}/deliveries/bulk/redeliver",
+		summary: "Redeliver webhook events",
+		description: "Replays every listed delivery in one transaction with the same checks as a single redelivery. Any ineligible delivery fails the whole request. Counts as one request for rate limiting.\n\nRequired API key permissions: webhooks. Write permissions also grant read access for the same resource.",
+		security: [{ apiKey: [] }, { oauth: [] }],
+		fields: [
+			{
+				name: "id",
+				location: "path",
+				required: true,
+				schema: {
+					type: "string",
+					pattern: "^wh_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "x-workspace-id",
+				location: "header",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Required for OAuth: ID of the workspace to access. API keys use their own workspace."
+				},
+				flag: "x-workspace-id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "expectedDestinationRevision",
+				location: "body",
+				required: true,
+				schema: {
+					type: "integer",
+					minimum: -9007199254740991,
+					maximum: 9007199254740991,
+					exclusiveMinimum: 0
+				},
+				flag: "expected-destination-revision",
+				kind: "number",
+				nullable: false
+			},
+			{
+				name: "deliveryIDs",
+				location: "body",
+				required: true,
+				schema: {
+					type: "array",
+					minItems: 1,
+					maxItems: 25,
+					items: {
+						type: "string",
+						pattern: "^whdel_[A-Za-z\\d]{1,22}$"
+					}
+				},
+				flag: "delivery-ids",
+				kind: "json",
+				nullable: false
+			}
+		],
+		conditional: false,
+		response: "json"
+	},
+	{
+		id: "webhooks.bulkSetEnabled",
+		group: "webhooks",
+		command: "bulk-set-enabled",
+		method: "post",
+		path: "/webhooks/bulk/set-enabled",
+		summary: "Enable or disable webhooks",
+		description: "Applies the state to every listed webhook in one transaction, checking each expectedRevision. Enabling checks the scope authority and destination of each webhook. Webhooks already in the state are unchanged.\n\nRequired API key permissions: webhooks. Write permissions also grant read access for the same resource.",
+		security: [{ apiKey: [] }, { oauth: [] }],
+		fields: [
+			{
+				name: "x-workspace-id",
+				location: "header",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Required for OAuth: ID of the workspace to access. API keys use their own workspace."
+				},
+				flag: "x-workspace-id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "webhooks",
+				location: "body",
+				required: true,
+				schema: {
+					type: "array",
+					minItems: 1,
+					maxItems: 10,
+					items: {
+						type: "object",
+						properties: {
+							id: {
+								type: "string",
+								pattern: "^wh_[A-Za-z\\d]{1,22}$"
+							},
+							expectedRevision: {
+								type: "integer",
+								minimum: -9007199254740991,
+								maximum: 9007199254740991,
+								exclusiveMinimum: 0
+							}
+						},
+						required: ["id", "expectedRevision"],
+						additionalProperties: false
+					}
+				},
+				flag: "webhooks",
+				kind: "json",
+				nullable: false
+			},
+			{
+				name: "enabled",
+				location: "body",
+				required: true,
+				schema: { type: "boolean" },
+				flag: "enabled",
+				kind: "boolean",
+				nullable: false
+			}
+		],
+		conditional: false,
+		response: "json"
+	},
+	{
+		id: "webhooks.create",
+		group: "webhooks",
+		command: "create",
+		method: "post",
+		path: "/webhooks",
+		summary: "Create a webhook",
+		description: "Creates an enabled webhook unless `enabled` is false and returns the signing secret once. The caller must be able to read every resource type its events send, and restricted content when included.\n\nRequired API key permissions: webhooks. Write permissions also grant read access for the same resource.",
+		security: [{ apiKey: [] }, { oauth: [] }],
+		fields: [
+			{
+				name: "x-workspace-id",
+				location: "header",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Required for OAuth: ID of the workspace to access. API keys use their own workspace."
+				},
+				flag: "x-workspace-id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "name",
+				location: "body",
+				required: true,
+				schema: {
+					type: "string",
+					minLength: 1,
+					maxLength: 100
+				},
+				flag: "name",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "url",
+				location: "body",
+				required: true,
+				schema: {
+					type: "string",
+					maxLength: 2048,
+					format: "uri"
+				},
+				flag: "url",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "enabled",
+				location: "body",
+				required: false,
+				schema: {
+					type: "boolean",
+					default: true
+				},
+				flag: "enabled",
+				kind: "boolean",
+				nullable: false
+			},
+			{
+				name: "eventTypes",
+				location: "body",
+				required: true,
+				schema: {
+					type: "array",
+					minItems: 1,
+					maxItems: 14,
+					items: { $ref: "#/components/schemas/WebhookEventName" }
+				},
+				flag: "event-types",
+				kind: "json",
+				nullable: false
+			},
+			{
+				name: "schemaVersion",
+				location: "body",
+				required: true,
+				schema: { const: 1 },
+				flag: "schema-version",
+				kind: "number",
+				nullable: false
+			},
+			{
+				name: "collections",
+				location: "body",
+				required: true,
+				schema: { anyOf: [{
+					type: "object",
+					properties: { mode: { const: "all" } },
+					required: ["mode"],
+					additionalProperties: false
+				}, {
+					type: "object",
+					properties: {
+						mode: { const: "selected" },
+						roots: {
+							type: "array",
+							minItems: 1,
+							maxItems: 100,
+							items: {
+								type: "string",
+								pattern: "^coll_[A-Za-z\\d]{1,22}$"
+							}
+						}
+					},
+					required: ["mode", "roots"],
+					additionalProperties: false
+				}] },
+				flag: "collections",
+				kind: "json",
+				nullable: false
+			},
+			{
+				name: "channels",
+				location: "body",
+				required: true,
+				schema: { anyOf: [{
+					type: "object",
+					properties: { mode: { const: "all" } },
+					required: ["mode"],
+					additionalProperties: false
+				}, {
+					type: "object",
+					properties: {
+						mode: { const: "selected" },
+						codes: {
+							type: "array",
+							minItems: 1,
+							maxItems: 100,
+							items: {
+								type: "string",
+								minLength: 1,
+								maxLength: 50
+							}
+						}
+					},
+					required: ["mode", "codes"],
+					additionalProperties: false
+				}] },
+				flag: "channels",
+				kind: "json",
+				nullable: false
+			},
+			{
+				name: "restrictedContent",
+				location: "body",
+				required: true,
+				schema: {
+					type: "boolean",
+					description: "Include restricted collections, including ones restricted later"
+				},
+				flag: "restricted-content",
+				kind: "boolean",
+				nullable: false
+			}
+		],
+		conditional: false,
+		response: "json"
+	},
+	{
+		id: "webhooks.delete",
+		group: "webhooks",
+		command: "delete",
+		method: "delete",
+		path: "/webhooks/{id}",
+		summary: "Delete a webhook",
+		description: "Cancels pending deliveries and destroys signing keys. Retains history until its original expiry; a deleted endpoint cannot be replayed.\n\nRequired API key permissions: webhooks. Write permissions also grant read access for the same resource.",
+		security: [{ apiKey: [] }, { oauth: [] }],
+		fields: [
+			{
+				name: "id",
+				location: "path",
+				required: true,
+				schema: {
+					type: "string",
+					pattern: "^wh_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "x-workspace-id",
+				location: "header",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Required for OAuth: ID of the workspace to access. API keys use their own workspace."
+				},
+				flag: "x-workspace-id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "expectedRevision",
+				location: "body",
+				required: true,
+				schema: {
+					type: "integer",
+					minimum: -9007199254740991,
+					maximum: 9007199254740991,
+					exclusiveMinimum: 0
+				},
+				flag: "expected-revision",
+				kind: "number",
+				nullable: false
+			}
+		],
+		conditional: false,
+		response: "empty"
+	},
+	{
+		id: "webhooks.get",
+		group: "webhooks",
+		command: "get",
+		method: "get",
+		path: "/webhooks/{id}",
+		summary: "Get a webhook",
+		description: "Required API key permissions: read:webhooks. Write permissions also grant read access for the same resource.",
+		security: [{ apiKey: [] }, { oauth: [] }],
+		fields: [{
+			name: "id",
+			location: "path",
+			required: true,
+			schema: {
+				type: "string",
+				pattern: "^wh_[A-Za-z\\d]{1,22}$"
+			},
+			flag: "id",
+			kind: "string",
+			nullable: false
+		}, {
+			name: "x-workspace-id",
+			location: "header",
+			required: false,
+			schema: {
+				type: "string",
+				description: "Required for OAuth: ID of the workspace to access. API keys use their own workspace."
+			},
+			flag: "x-workspace-id",
+			kind: "string",
+			nullable: false
+		}],
+		conditional: false,
+		response: "json"
+	},
+	{
+		id: "webhooks.getDelivery",
+		group: "webhooks",
+		command: "get-delivery",
+		method: "get",
+		path: "/webhooks/{id}/deliveries/{deliveryID}",
+		summary: "Get a webhook delivery",
+		description: "Returns retained delivery metadata and, with content authority, the immutable event payload. Expired deliveries return not found even before physical cleanup.\n\nRequired API key permissions: read:webhooks. Write permissions also grant read access for the same resource.",
+		security: [{ apiKey: [] }, { oauth: [] }],
+		fields: [
+			{
+				name: "id",
+				location: "path",
+				required: true,
+				schema: {
+					type: "string",
+					pattern: "^wh_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "deliveryID",
+				location: "path",
+				required: true,
+				schema: {
+					type: "string",
+					pattern: "^whdel_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "delivery-id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "x-workspace-id",
+				location: "header",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Required for OAuth: ID of the workspace to access. API keys use their own workspace."
+				},
+				flag: "x-workspace-id",
+				kind: "string",
+				nullable: false
+			}
+		],
+		conditional: false,
+		response: "json"
+	},
+	{
+		id: "webhooks.list",
+		group: "webhooks",
+		command: "list",
+		method: "get",
+		path: "/webhooks",
+		summary: "List webhooks",
+		description: "Required API key permissions: read:webhooks. Write permissions also grant read access for the same resource.",
+		security: [{ apiKey: [] }, { oauth: [] }],
+		fields: [
+			{
+				name: "cursor",
+				location: "query",
+				required: false,
+				schema: {
+					type: "string",
+					pattern: "^(?:\\w+?_[A-Za-z\\d]{1,22})$",
+					description: "Cursor from the previous page; keep the same filters"
+				},
+				flag: "cursor",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "limit",
+				location: "query",
+				required: false,
+				schema: {
+					type: "integer",
+					minimum: 1,
+					maximum: 100,
+					default: 50
+				},
+				flag: "limit",
+				kind: "number",
+				nullable: false
+			},
+			{
+				name: "x-workspace-id",
+				location: "header",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Required for OAuth: ID of the workspace to access. API keys use their own workspace."
+				},
+				flag: "x-workspace-id",
+				kind: "string",
+				nullable: false
+			}
+		],
+		conditional: false,
+		response: "json",
+		pagination: "cursor"
+	},
+	{
+		id: "webhooks.listAttempts",
+		group: "webhooks",
+		command: "list-attempts",
+		method: "get",
+		path: "/webhooks/{id}/deliveries/{deliveryID}/runs/{runID}/attempts",
+		summary: "List delivery attempts",
+		description: "Required API key permissions: read:webhooks. Write permissions also grant read access for the same resource.",
+		security: [{ apiKey: [] }, { oauth: [] }],
+		fields: [
+			{
+				name: "id",
+				location: "path",
+				required: true,
+				schema: {
+					type: "string",
+					pattern: "^wh_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "deliveryID",
+				location: "path",
+				required: true,
+				schema: {
+					type: "string",
+					pattern: "^whdel_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "delivery-id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "runID",
+				location: "path",
+				required: true,
+				schema: {
+					type: "string",
+					pattern: "^whrun_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "run-id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "cursor",
+				location: "query",
+				required: false,
+				schema: {
+					type: "string",
+					pattern: "^whatt_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "cursor",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "limit",
+				location: "query",
+				required: false,
+				schema: {
+					type: "integer",
+					minimum: 1,
+					maximum: 100,
+					default: 50
+				},
+				flag: "limit",
+				kind: "number",
+				nullable: false
+			},
+			{
+				name: "x-workspace-id",
+				location: "header",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Required for OAuth: ID of the workspace to access. API keys use their own workspace."
+				},
+				flag: "x-workspace-id",
+				kind: "string",
+				nullable: false
+			}
+		],
+		conditional: false,
+		response: "json",
+		pagination: "cursor"
+	},
+	{
+		id: "webhooks.listDeliveries",
+		group: "webhooks",
+		command: "list-deliveries",
+		method: "get",
+		path: "/webhooks/{id}/deliveries",
+		summary: "List webhook deliveries",
+		description: "Returns unexpired history, including for a deleted endpoint. Metadata does not include event payloads.\n\nRequired API key permissions: read:webhooks. Write permissions also grant read access for the same resource.",
+		security: [{ apiKey: [] }, { oauth: [] }],
+		fields: [
+			{
+				name: "id",
+				location: "path",
+				required: true,
+				schema: {
+					type: "string",
+					pattern: "^wh_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "cursor",
+				location: "query",
+				required: false,
+				schema: {
+					type: "string",
+					pattern: "^whdel_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "cursor",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "limit",
+				location: "query",
+				required: false,
+				schema: {
+					type: "integer",
+					minimum: 1,
+					maximum: 100,
+					default: 50
+				},
+				flag: "limit",
+				kind: "number",
+				nullable: false
+			},
+			{
+				name: "type",
+				location: "query",
+				required: false,
+				schema: { $ref: "#/components/schemas/WebhookEventName" },
+				flag: "type",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "state",
+				location: "query",
+				required: false,
+				schema: {
+					enum: [
+						"pending",
+						"in_flight",
+						"succeeded",
+						"failed",
+						"cancelled"
+					],
+					type: "string"
+				},
+				flag: "state",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "createdAfter",
+				location: "query",
+				required: false,
+				schema: {
+					type: "string",
+					format: "date-time"
+				},
+				flag: "created-after",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "createdBefore",
+				location: "query",
+				required: false,
+				schema: {
+					type: "string",
+					format: "date-time"
+				},
+				flag: "created-before",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "x-workspace-id",
+				location: "header",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Required for OAuth: ID of the workspace to access. API keys use their own workspace."
+				},
+				flag: "x-workspace-id",
+				kind: "string",
+				nullable: false
+			}
+		],
+		conditional: false,
+		response: "json",
+		pagination: "cursor"
+	},
+	{
+		id: "webhooks.listRuns",
+		group: "webhooks",
+		command: "list-runs",
+		method: "get",
+		path: "/webhooks/{id}/deliveries/{deliveryID}/runs",
+		summary: "List delivery runs",
+		description: "Required API key permissions: read:webhooks. Write permissions also grant read access for the same resource.",
+		security: [{ apiKey: [] }, { oauth: [] }],
+		fields: [
+			{
+				name: "id",
+				location: "path",
+				required: true,
+				schema: {
+					type: "string",
+					pattern: "^wh_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "deliveryID",
+				location: "path",
+				required: true,
+				schema: {
+					type: "string",
+					pattern: "^whdel_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "delivery-id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "cursor",
+				location: "query",
+				required: false,
+				schema: {
+					type: "string",
+					pattern: "^whrun_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "cursor",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "limit",
+				location: "query",
+				required: false,
+				schema: {
+					type: "integer",
+					minimum: 1,
+					maximum: 100,
+					default: 50
+				},
+				flag: "limit",
+				kind: "number",
+				nullable: false
+			},
+			{
+				name: "x-workspace-id",
+				location: "header",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Required for OAuth: ID of the workspace to access. API keys use their own workspace."
+				},
+				flag: "x-workspace-id",
+				kind: "string",
+				nullable: false
+			}
+		],
+		conditional: false,
+		response: "json",
+		pagination: "cursor"
+	},
+	{
+		id: "webhooks.redeliver",
+		group: "webhooks",
+		command: "redeliver",
+		method: "post",
+		path: "/webhooks/{id}/deliveries/{deliveryID}/redeliver",
+		summary: "Redeliver a webhook event",
+		description: "Checks the reviewed destination revision and current scope authority. Reuses the original event ID, payload, and expiry. Returns a conflict if a run is active, or the endpoint is disabled or deleted.\n\nRequired API key permissions: webhooks. Write permissions also grant read access for the same resource.",
+		security: [{ apiKey: [] }, { oauth: [] }],
+		fields: [
+			{
+				name: "id",
+				location: "path",
+				required: true,
+				schema: {
+					type: "string",
+					pattern: "^wh_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "deliveryID",
+				location: "path",
+				required: true,
+				schema: {
+					type: "string",
+					pattern: "^whdel_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "delivery-id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "x-workspace-id",
+				location: "header",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Required for OAuth: ID of the workspace to access. API keys use their own workspace."
+				},
+				flag: "x-workspace-id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "expectedDestinationRevision",
+				location: "body",
+				required: true,
+				schema: {
+					type: "integer",
+					minimum: -9007199254740991,
+					maximum: 9007199254740991,
+					exclusiveMinimum: 0
+				},
+				flag: "expected-destination-revision",
+				kind: "number",
+				nullable: false
+			}
+		],
+		conditional: false,
+		response: "json"
+	},
+	{
+		id: "webhooks.rotateSecret",
+		group: "webhooks",
+		command: "rotate-secret",
+		method: "post",
+		path: "/webhooks/{id}/rotate-secret",
+		summary: "Rotate a webhook secret",
+		description: "Returns a new secret once. Overlap keeps the old secret valid for 24 hours. Immediate rotation retires it at once. Normal rotation conflicts while a previous overlap remains active.\n\nRequired API key permissions: webhooks. Write permissions also grant read access for the same resource.",
+		security: [{ apiKey: [] }, { oauth: [] }],
+		fields: [
+			{
+				name: "id",
+				location: "path",
+				required: true,
+				schema: {
+					type: "string",
+					pattern: "^wh_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "x-workspace-id",
+				location: "header",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Required for OAuth: ID of the workspace to access. API keys use their own workspace."
+				},
+				flag: "x-workspace-id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "expectedRevision",
+				location: "body",
+				required: true,
+				schema: {
+					type: "integer",
+					minimum: -9007199254740991,
+					maximum: 9007199254740991,
+					exclusiveMinimum: 0
+				},
+				flag: "expected-revision",
+				kind: "number",
+				nullable: false
+			},
+			{
+				name: "mode",
+				location: "body",
+				required: true,
+				schema: {
+					enum: ["overlap", "immediate"],
+					type: "string"
+				},
+				flag: "mode",
+				kind: "string",
+				nullable: false
+			}
+		],
+		conditional: false,
+		response: "json"
+	},
+	{
+		id: "webhooks.sendTest",
+		group: "webhooks",
+		command: "send-test",
+		method: "post",
+		path: "/webhooks/{id}/test",
+		summary: "Send a webhook test",
+		description: "Schedules one signed synthetic attempt for this endpoint, including when disabled. The event must be selected by the endpoint. It does not enable the endpoint or change content.\n\nRequired API key permissions: webhooks. Write permissions also grant read access for the same resource.",
+		security: [{ apiKey: [] }, { oauth: [] }],
+		fields: [
+			{
+				name: "id",
+				location: "path",
+				required: true,
+				schema: {
+					type: "string",
+					pattern: "^wh_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "x-workspace-id",
+				location: "header",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Required for OAuth: ID of the workspace to access. API keys use their own workspace."
+				},
+				flag: "x-workspace-id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "expectedRevision",
+				location: "body",
+				required: true,
+				schema: {
+					type: "integer",
+					minimum: -9007199254740991,
+					maximum: 9007199254740991,
+					exclusiveMinimum: 0
+				},
+				flag: "expected-revision",
+				kind: "number",
+				nullable: false
+			},
+			{
+				name: "type",
+				location: "body",
+				required: true,
+				schema: { $ref: "#/components/schemas/WebhookEventName" },
+				flag: "type",
+				kind: "string",
+				nullable: false
+			}
+		],
+		conditional: false,
+		response: "json"
+	},
+	{
+		id: "webhooks.update",
+		group: "webhooks",
+		command: "update",
+		method: "put",
+		path: "/webhooks/{id}",
+		summary: "Update a webhook",
+		description: "Checks expectedRevision and validates the merged configuration. A URL change cancels pending deliveries and returns a replacement secret once. Scope changes require authority over the previous and new scope.\n\nRequired API key permissions: webhooks. Write permissions also grant read access for the same resource.",
+		security: [{ apiKey: [] }, { oauth: [] }],
+		fields: [
+			{
+				name: "id",
+				location: "path",
+				required: true,
+				schema: {
+					type: "string",
+					pattern: "^wh_[A-Za-z\\d]{1,22}$"
+				},
+				flag: "id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "x-workspace-id",
+				location: "header",
+				required: false,
+				schema: {
+					type: "string",
+					description: "Required for OAuth: ID of the workspace to access. API keys use their own workspace."
+				},
+				flag: "x-workspace-id",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "name",
+				location: "body",
+				required: false,
+				schema: {
+					type: "string",
+					minLength: 1,
+					maxLength: 100
+				},
+				flag: "name",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "url",
+				location: "body",
+				required: false,
+				schema: {
+					type: "string",
+					maxLength: 2048,
+					format: "uri"
+				},
+				flag: "url",
+				kind: "string",
+				nullable: false
+			},
+			{
+				name: "enabled",
+				location: "body",
+				required: false,
+				schema: { type: "boolean" },
+				flag: "enabled",
+				kind: "boolean",
+				nullable: false
+			},
+			{
+				name: "eventTypes",
+				location: "body",
+				required: false,
+				schema: {
+					type: "array",
+					minItems: 1,
+					maxItems: 14,
+					items: { $ref: "#/components/schemas/WebhookEventName" }
+				},
+				flag: "event-types",
+				kind: "json",
+				nullable: false
+			},
+			{
+				name: "schemaVersion",
+				location: "body",
+				required: false,
+				schema: { const: 1 },
+				flag: "schema-version",
+				kind: "number",
+				nullable: false
+			},
+			{
+				name: "collections",
+				location: "body",
+				required: false,
+				schema: { anyOf: [{
+					type: "object",
+					properties: { mode: { const: "all" } },
+					required: ["mode"],
+					additionalProperties: false
+				}, {
+					type: "object",
+					properties: {
+						mode: { const: "selected" },
+						roots: {
+							type: "array",
+							minItems: 1,
+							maxItems: 100,
+							items: {
+								type: "string",
+								pattern: "^coll_[A-Za-z\\d]{1,22}$"
+							}
+						}
+					},
+					required: ["mode", "roots"],
+					additionalProperties: false
+				}] },
+				flag: "collections",
+				kind: "json",
+				nullable: false
+			},
+			{
+				name: "channels",
+				location: "body",
+				required: false,
+				schema: { anyOf: [{
+					type: "object",
+					properties: { mode: { const: "all" } },
+					required: ["mode"],
+					additionalProperties: false
+				}, {
+					type: "object",
+					properties: {
+						mode: { const: "selected" },
+						codes: {
+							type: "array",
+							minItems: 1,
+							maxItems: 100,
+							items: {
+								type: "string",
+								minLength: 1,
+								maxLength: 50
+							}
+						}
+					},
+					required: ["mode", "codes"],
+					additionalProperties: false
+				}] },
+				flag: "channels",
+				kind: "json",
+				nullable: false
+			},
+			{
+				name: "restrictedContent",
+				location: "body",
+				required: false,
+				schema: {
+					type: "boolean",
+					description: "Include restricted collections, including ones restricted later"
+				},
+				flag: "restricted-content",
+				kind: "boolean",
+				nullable: false
+			},
+			{
+				name: "expectedRevision",
+				location: "body",
+				required: true,
+				schema: {
+					type: "integer",
+					minimum: -9007199254740991,
+					maximum: 9007199254740991,
+					exclusiveMinimum: 0
+				},
+				flag: "expected-revision",
+				kind: "number",
+				nullable: false
+			}
+		],
+		conditional: false,
+		response: "json"
+	},
+	{
+		id: "workspaces.list",
+		group: "workspaces",
+		command: "list",
+		method: "get",
+		path: "/workspaces",
+		summary: "List available workspaces",
+		description: "Lists workspaces available to the OAuth user, with current role permissions and plan access. Browser sessions can list workspaces across signed-in accounts. Does not require workspace selection and does not count toward API usage.",
+		security: [{ oauth: [] }],
+		fields: [],
+		conditional: false,
+		response: "json"
+	}
+];
+const schemas = {
+	PropertyFilter: { anyOf: [
+		{ $ref: "#/components/schemas/TextPropertyFilter" },
+		{ $ref: "#/components/schemas/NumberPropertyFilter" },
+		{ $ref: "#/components/schemas/BooleanPropertyFilter" },
+		{ $ref: "#/components/schemas/DatePropertyFilter" }
+	] },
+	TextPropertyFilter: {
+		type: "object",
+		properties: {
+			kind: { const: "text" },
+			key: {
+				type: "string",
 				minLength: 1,
 				maxLength: 100,
 				description: "Property identifier"
@@ -7122,6 +8573,25 @@ const schemas = {
 			"value"
 		]
 	},
+	WebhookEventName: {
+		enum: [
+			"entry.created",
+			"entry.updated",
+			"entry.content_saved",
+			"entry.moved",
+			"entry.deleted",
+			"entry.restored",
+			"collection.created",
+			"collection.updated",
+			"collection.moved",
+			"collection.deleted",
+			"collection.restored",
+			"publishing.channel_advanced",
+			"publishing.channel_created",
+			"publishing.channel_deleted"
+		],
+		type: "string"
+	},
 	Permission: {
 		enum: [
 			"content",
@@ -7134,6 +8604,8 @@ const schemas = {
 			"read:restricted_collections",
 			"memberships",
 			"roles",
+			"webhooks",
+			"read:webhooks",
 			"workspace"
 		],
 		type: "string"
@@ -7321,6 +8793,21 @@ const bindings = {
 	"versions.list": (client, input, options) => client.versions.list(input, options),
 	"versions.revert": (client, input, options) => client.versions.revert(input, options),
 	"versions.update": (client, input, options) => client.versions.update(input, options),
+	"webhooks.bulkDelete": (client, input, options) => client.webhooks.bulkDelete(input, options),
+	"webhooks.bulkRedeliver": (client, input, options) => client.webhooks.bulkRedeliver(input, options),
+	"webhooks.bulkSetEnabled": (client, input, options) => client.webhooks.bulkSetEnabled(input, options),
+	"webhooks.create": (client, input, options) => client.webhooks.create(input, options),
+	"webhooks.delete": (client, input, options) => client.webhooks.delete(input, options),
+	"webhooks.get": (client, input, options) => client.webhooks.get(input, options),
+	"webhooks.getDelivery": (client, input, options) => client.webhooks.getDelivery(input, options),
+	"webhooks.list": (client, input, options) => client.webhooks.list(input, options),
+	"webhooks.listAttempts": (client, input, options) => client.webhooks.listAttempts(input, options),
+	"webhooks.listDeliveries": (client, input, options) => client.webhooks.listDeliveries(input, options),
+	"webhooks.listRuns": (client, input, options) => client.webhooks.listRuns(input, options),
+	"webhooks.redeliver": (client, input, options) => client.webhooks.redeliver(input, options),
+	"webhooks.rotateSecret": (client, input, options) => client.webhooks.rotateSecret(input, options),
+	"webhooks.sendTest": (client, input, options) => client.webhooks.sendTest(input, options),
+	"webhooks.update": (client, input, options) => client.webhooks.update(input, options),
 	"workspaces.list": (client, input, options) => client.workspaces.list(input, options)
 };
 //#endregion
@@ -7532,7 +9019,7 @@ const registerAPI = (program, signal) => {
 //#endregion
 //#region src/types/register.ts
 const registerTypes = (program, signal) => {
-	program.command("types").description("Generate TypeScript types for workspace content").command("generate").description("Generate a types file, check it for CI, or watch for metadata changes").addOption(new Option("--source <source>", "Content source (default: saved source or published)").choices(["published", "current"])).option("--channel <code>", "Follow a publishing channel").option("--snapshot <id>", "Use a fixed published snapshot").option("--collection <selectors...>", "Collection IDs or decoded paths, including descendants").option("--all-collections", "Include all accessible collections").option("--output <file>", "Types file relative to config, or the working directory without config").option("--include-entry-ids", "Include entry ID types").option("--no-include-entry-ids", "Omit entry ID types").option("--include-entry-paths", "Include entry path types").option("--no-include-entry-paths", "Omit entry path types").option("--include-tree", "Include exact tree types").option("--no-include-tree", "Omit exact tree types").option("--check", "Compare against live metadata without writes; exit 3 if missing or stale").option("--watch", "Poll in the foreground; no daemon or overlapping requests").option("--interval <seconds>", "Watch polling interval, 1–300 seconds (default: 10)").option("--force", "Replace an unrelated output file; with watch, applies only until the first successful generation").addHelpText("after", "\nCommit the generated file and use --check in CI. Channel/current sources follow live changes;\n--snapshot fixes the source while that snapshot is retained. Options override saved config.\nWatch holds configuration fixed; restart it after config changes. Nothing runs at install time.").action(async (options, command) => {
+	program.command("types").description("Generate TypeScript types for workspace content").command("generate").description("Generate a types file, check it for CI, or watch for metadata changes").addOption(new Option("--source <source>", "Content source (default: saved source or published)").choices(["published", "current"])).option("--channel <code>", "Follow a publishing channel").option("--snapshot <id>", "Use a fixed published snapshot").option("--collection <selectors...>", "Collection IDs or decoded paths, including descendants").option("--collection-slug-path <paths...>", "Decoded collection slug paths, including descendants").option("--all-collections", "Include all accessible collections").option("--output <file>", "Types file relative to config, or the working directory without config").option("--include-entry-ids", "Include entry ID types").option("--no-include-entry-ids", "Omit entry ID types").option("--include-entry-paths", "Include entry path types").option("--no-include-entry-paths", "Omit entry path types").option("--include-tree", "Include exact tree types").option("--no-include-tree", "Omit exact tree types").option("--check", "Compare against live metadata without writes; exit 3 if missing or stale").option("--watch", "Poll in the foreground; no daemon or overlapping requests").option("--interval <seconds>", "Watch polling interval, 1–300 seconds (default: 10)").option("--force", "Replace an unrelated output file; with watch, applies only until the first successful generation").addHelpText("after", "\nCommit the generated file and use --check in CI. Channel/current sources follow live changes;\n--snapshot fixes the source while that snapshot is retained. Options override saved config.\nWatch holds configuration fixed; restart it after config changes. Nothing runs at install time.").action(async (options, command) => {
 		const globals = command.optsWithGlobals();
 		await executeTypes(await createCommandContext(globals, signal), options);
 	});
@@ -7543,9 +9030,12 @@ const registerTypes = (program, signal) => {
 const createProgram = (signal) => {
 	const program = new Command().name("andesine").description("Command-line tools for Andesine").version(version).option("--config <file>", "Use a project configuration file (ANDESINE_CONFIG)").option("--profile <name>", "Select a saved user profile (ANDESINE_PROFILE)").option("--base-url <url>", "Set the API root (ANDESINE_BASE_URL)").option("--workspace <id>", "Select a workspace (ANDESINE_WORKSPACE_ID)").option("--no-interactive", "Disable interactive prompts").showHelpAfterError().exitOverride();
 	const auth = program.command("auth").description("Manage CLI authentication");
-	program.command("init").description("Configure this project for Andesine content and type generation").addOption(new Option("--source <source>", "Type source: published (default) or current").choices(["published", "current"])).option("--channel <code>", "Publishing channel (default: published)").option("--snapshot <id>", "Use a fixed published snapshot instead of a channel").option("--collection <selectors...>", "Collection IDs or decoded paths, including collection-ID anchors").option("--all-collections", "Include all accessible collections").option("--output <file>", "Types file relative to config (default: src/andesine.generated.ts)").option("--include-entry-ids", "Include entry ID types").option("--no-include-entry-ids", "Omit entry ID types").option("--include-entry-paths", "Include entry path types").option("--no-include-entry-paths", "Omit entry path types").option("--include-tree", "Include exact tree types").option("--no-include-tree", "Omit exact tree types").option("--yes", "Save without confirmation, including updates to an existing config").option("--generate", "Generate the configured types file after saving").option("--no-generate", "Save configuration without generating types").option("--no-browser", "Do not open a browser if login is needed").addOption(new Option("--credential-store <store>", "Credential store for a new login").choices(["keyring", "file"])).action(async (_options, command) => {
+	program.command("init").description("Configure this project for Andesine content and type generation").addOption(new Option("--source <source>", "Type source: published (default) or current").choices(["published", "current"])).option("--channel <code>", "Publishing channel (default: published)").option("--snapshot <id>", "Use a fixed published snapshot instead of a channel").option("--collection <selectors...>", "Collection IDs or decoded paths, including collection-ID anchors").option("--collection-slug-path <paths...>", "Decoded collection slug paths, including descendants").option("--all-collections", "Include all accessible collections").option("--output <file>", "Types file relative to config (default: src/andesine.generated.ts)").option("--include-entry-ids", "Include entry ID types").option("--no-include-entry-ids", "Omit entry ID types").option("--include-entry-paths", "Include entry path types").option("--no-include-entry-paths", "Omit entry path types").option("--include-tree", "Include exact tree types").option("--no-include-tree", "Omit exact tree types").option("--yes", "Save without confirmation, including updates to an existing config").option("--generate", "Generate the configured types file after saving").option("--no-generate", "Save configuration without generating types").option("--no-browser", "Do not open a browser if login is needed").addOption(new Option("--credential-store <store>", "Credential store for a new login").choices(["keyring", "file"])).action(async (_options, command) => {
 		await init(command.optsWithGlobals(), signal);
 	});
+	program.command("pages").description("Create Andesine Pages documentation sites").command("init").description("Create an Andesine Pages site from the template in a new or empty directory").argument("[directory]", "Directory of the new site", "docs").action(async (directory, _options, command) => {
+		await initPages(directory, createOutput(command.optsWithGlobals().interactive, signal));
+	});
 	auth.command("login").description("Sign in through browser device approval").option("--no-browser", "Display the URL and code without opening a browser").addOption(new Option("--credential-store <store>", "Store credentials in the OS keyring or an unencrypted private file").choices(["keyring", "file"])).action(async (options, command) => {
 		const context = await createCommandContext(command.optsWithGlobals(), signal, { allowNewProfile: true });
 		await login(context, options);