twentythree-cli 1.0.0

package/dist/commands/openupload/update-file.cjs

@@ -0,0 +1,85 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/openupload/update-file.ts
+/**
+* Open upload update-file command — updates metadata for an open upload entry.
+*
+* Requires token-upload-id, token, and upload-key to identify the entry.
+* Optional title, description, and tags can be updated.
+*
+* Threat mitigations:
+*   T-08-21: extends AuthenticatedCommand — anonymous mode rejected
+*/
+var OpenuploadUpdateFile = class OpenuploadUpdateFile extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Update metadata for an open upload entry";
+	static examples = [
+		"<%= config.bin %> openupload update-file --token-upload-id 123 --token abc123 --upload-key key456 --title \"My Video\"",
+		"<%= config.bin %> openupload update-file --token-upload-id 123 --token abc123 --upload-key key456 --tags \"demo tutorial\"",
+		"<%= config.bin %> openupload update-file --token-upload-id 123 --token abc123 --upload-key key456 --json"
+	];
+	static enableJsonFlag = true;
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		"token-upload-id": _oclif_core.Flags.string({
+			description: "Open upload token upload ID",
+			required: true
+		}),
+		token: _oclif_core.Flags.string({
+			description: "Open upload token",
+			required: true
+		}),
+		"upload-key": _oclif_core.Flags.string({
+			description: "Upload key identifying the uploaded file",
+			required: true
+		}),
+		title: _oclif_core.Flags.string({
+			description: "New title for the uploaded file",
+			required: false
+		}),
+		description: _oclif_core.Flags.string({
+			description: "New description for the uploaded file",
+			required: false
+		}),
+		tags: _oclif_core.Flags.string({
+			description: "Tags for the uploaded file (space-separated)",
+			required: false
+		})
+	};
+	static agentMetadata = {
+		api_endpoint: "POST /openupload/update-file",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "updates"
+	};
+	async run() {
+		const { flags } = await this.parse(OpenuploadUpdateFile);
+		this.printWorkspaceHeader();
+		const body = {
+			token_upload_id: flags["token-upload-id"],
+			token: flags.token,
+			upload_key: flags["upload-key"]
+		};
+		if (flags.title !== void 0) body.title = flags.title;
+		if (flags.description !== void 0) body.description = flags.description;
+		if (flags.tags !== void 0) body.tags = flags.tags;
+		const { data: updateData, error: updateError } = await this.apiClient.POST("/openupload/update-file", {
+			body,
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (updateError) this.error(require_lib_term_map.applyCliTerms(formatApiError(updateError)), { exit: 1 });
+		this.log(chalk.default.green("Open upload entry updated"));
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: updateData,
+			summary: "Open upload entry updated",
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "openupload" }]
+		});
+	}
+};
+//#endregion
+module.exports = OpenuploadUpdateFile;

package/dist/commands/openupload/upload-file.cjs

@@ -0,0 +1,130 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+const require_upload_types = require("../../upload/types.cjs");
+const require_upload_chunked_upload = require("../../upload/chunked-upload.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+let node_fs_promises = require("node:fs/promises");
+//#region src/commands/openupload/upload-file.ts
+/**
+* Simple inline progress bar that writes directly to stderr using \r.
+* T-08-18: shows only byte counts, never the open upload token.
+*/
+var ProgressBar = class {
+	lastLen = 0;
+	render(bytesUploaded, total, speed) {
+		const pct = total > 0 ? Math.floor(bytesUploaded / total * 100) : 0;
+		const filled = Math.floor(pct / 5);
+		const line = `[${"█".repeat(filled) + "░".repeat(20 - filled)}] ${pct}% | ${require_lib_output.formatBytes(bytesUploaded)} / ${require_lib_output.formatBytes(total)} | ${require_lib_output.formatBytes(speed)}/s`;
+		const padding = " ".repeat(Math.max(0, this.lastLen - line.length));
+		process.stderr.write(`\r${line}${padding}`);
+		this.lastLen = line.length;
+	}
+	finish() {
+		process.stderr.write("\n");
+		this.lastLen = 0;
+	}
+};
+/**
+* Open upload file command — uploads a file using the chunked upload engine
+* via an open upload token.
+*
+* CRITICAL (Pitfall 3): tokenFieldName must be 'token', NOT 'upload_token'.
+* The open upload endpoint uses 'token' as the field name for the upload token.
+*
+* Flow:
+*   1. Validate file exists
+*   2. Upload file in chunks via chunked engine with tokenFieldName: 'token'
+*   3. Display success message; optionally return --json result
+*
+* Threat mitigations:
+*   T-08-18: Token not logged in progress output — only byte counts shown
+*   T-08-19: uploadUrl HTTPS validation enforced by chunked-upload.ts (T-03-02)
+*   T-08-21: extends AuthenticatedCommand — anonymous mode rejected
+*/
+var OpenuploadUploadFile = class OpenuploadUploadFile extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Upload a file via an open upload token using the chunked upload engine";
+	static examples = [
+		"<%= config.bin %> openupload upload-file --file-path ./video.mp4 --token-upload-id 123 --token abc123",
+		"<%= config.bin %> openupload upload-file --file-path ./video.mp4 --token-upload-id 123 --token abc123 --chunk-size 52428800",
+		"<%= config.bin %> openupload upload-file --file-path ./video.mp4 --token-upload-id 123 --token abc123 --json"
+	];
+	static enableJsonFlag = true;
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		"file-path": _oclif_core.Flags.string({
+			description: "Path to the file to upload",
+			required: true
+		}),
+		"token-upload-id": _oclif_core.Flags.string({
+			description: "Open upload token upload ID",
+			required: true
+		}),
+		token: _oclif_core.Flags.string({
+			description: "Open upload token",
+			required: true
+		}),
+		"chunk-size": _oclif_core.Flags.integer({
+			description: `Chunk size in bytes (default: ${require_upload_types.DEFAULT_CHUNK_SIZE} = 100MB)`,
+			default: require_upload_types.DEFAULT_CHUNK_SIZE
+		}),
+		concurrency: _oclif_core.Flags.integer({
+			description: `Number of chunks to upload in parallel (default: 5)`,
+			default: 5
+		})
+	};
+	static agentMetadata = {
+		api_endpoint: "POST /openupload/upload-file",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "creates"
+	};
+	async run() {
+		const { flags } = await this.parse(OpenuploadUploadFile);
+		this.printWorkspaceHeader();
+		let fileStat;
+		try {
+			fileStat = await (0, node_fs_promises.stat)(flags["file-path"]);
+		} catch {
+			this.error(`File not found: ${flags["file-path"]}`, { exit: 1 });
+			return;
+		}
+		const totalBytes = fileStat.size;
+		const bar = new ProgressBar();
+		const startTime = Date.now();
+		bar.render(0, totalBytes, 0);
+		let result;
+		try {
+			result = await require_upload_chunked_upload.uploadChunked({
+				filePath: flags["file-path"],
+				uploadToken: flags.token,
+				tokenFieldName: "token",
+				uploadUrl: `${this.apiBaseUrl}openupload/upload-file`,
+				bearerToken: this.activeWorkspace.bearer_token || void 0,
+				chunkSize: flags["chunk-size"],
+				concurrency: flags.concurrency,
+				extraFields: { token_upload_id: flags["token-upload-id"] },
+				onProgress(bytesUploaded, total) {
+					const elapsed = (Date.now() - startTime) / 1e3;
+					const speed = elapsed > 0 ? bytesUploaded / elapsed : 0;
+					bar.render(bytesUploaded, total, speed);
+				}
+			});
+		} catch (err) {
+			bar.finish();
+			throw err;
+		}
+		bar.finish();
+		this.log(chalk.default.green("File uploaded via open upload"));
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: result,
+			summary: "File uploaded via open upload",
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "openupload" }]
+		});
+	}
+};
+//#endregion
+module.exports = OpenuploadUploadFile;

package/dist/commands/player/delete.cjs

@@ -0,0 +1,66 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+let _clack_prompts = require("@clack/prompts");
+//#region src/commands/player/delete.ts
+/**
+* Player delete command — deletes a player after confirmation.
+*
+* Prompts user to confirm deletion showing the workspace domain so they know
+* which workspace they are deleting from.
+*
+* --json flag skips the confirmation prompt (scripting mode — assume confirmed).
+*
+* Exit codes:
+*   0 — success
+*   1 — error (player not found, API error)
+*   2 — cancelled (user declined confirmation)
+*
+* Threat mitigations:
+*   T-06-07: Confirmation prompt with workspace domain; exit code 2 on cancel
+*/
+var PlayerDelete = class PlayerDelete extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Delete a player from the active workspace";
+	static agentMetadata = {
+		api_endpoint: "POST /player/delete",
+		auth_scope: "write",
+		output_shape: { type: "none" },
+		side_effects: "destructive"
+	};
+	static examples = ["<%= config.bin %> player delete 42", "<%= config.bin %> player delete 42 --json"];
+	static enableJsonFlag = true;
+	static flags = { ...require_lib_base_command.AuthenticatedCommand.baseFlags };
+	static args = { id: _oclif_core.Args.string({
+		description: "Player ID",
+		required: true
+	}) };
+	async run() {
+		const { args } = await this.parse(PlayerDelete);
+		this.printWorkspaceHeader();
+		if (!this.jsonEnabled()) {
+			const confirmed = await (0, _clack_prompts.confirm)({ message: `Delete player ${args.id} from ${this.activeWorkspace.domain}? This cannot be undone.` });
+			if ((0, _clack_prompts.isCancel)(confirmed) || !confirmed) process.exit(2);
+		}
+		const { data: deleteData, error: deleteError } = await this.apiClient.POST("/player/delete", {
+			body: { player_id: Number(args.id) },
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (deleteError) this.error(require_lib_term_map.applyCliTerms(formatApiError(deleteError)), { exit: 1 });
+		this.log(chalk.default.green("Player deleted"));
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: deleteData,
+			summary: `Player ${args.id} deleted`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, {
+				resource: "player",
+				id: args.id
+			}]
+		});
+	}
+};
+//#endregion
+module.exports = PlayerDelete;

package/dist/commands/player/embed-versions.cjs

@@ -0,0 +1,83 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/player/embed-versions.ts
+/**
+* Player embed-versions command — lists available embed versions for an object.
+*
+* Returns embed codes and share links across multiple platforms (web players, email clients).
+* Requires --object-type (photo|live|album|site) and --object-id.
+*/
+var PlayerEmbedVersions = class PlayerEmbedVersions extends require_lib_base_command.AuthenticatedCommand {
+	static description = "List available embed versions for an object";
+	static agentMetadata = {
+		api_endpoint: "GET /player/embed-versions",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"Type",
+				"Key",
+				"Label"
+			]
+		},
+		side_effects: "none"
+	};
+	static examples = ["<%= config.bin %> player embed-versions --object-type photo --object-id 123", "<%= config.bin %> player embed-versions --object-type live --object-id 456 --json"];
+	static enableJsonFlag = true;
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		"object-type": _oclif_core.Flags.string({
+			description: "Object type: photo, live, album, or site",
+			required: true
+		}),
+		"object-id": _oclif_core.Flags.string({
+			description: "Object ID",
+			required: true
+		}),
+		source: _oclif_core.Flags.string({
+			description: "Embed source parameter (e.g. embed, share)",
+			required: false
+		})
+	};
+	static args = {};
+	async run() {
+		const { flags } = await this.parse(PlayerEmbedVersions);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.GET("/player/embed-versions", { params: { query: {
+			object_type: flags["object-type"],
+			object_id: Number(flags["object-id"]),
+			source: flags.source
+		} } });
+		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		const resp = data;
+		const items = Array.isArray(resp?.data) ? resp.data : resp?.data ? [resp.data] : [];
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: items,
+			summary: `${items.length} embed version${items.length === 1 ? "" : "s"}`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "player" }]
+		});
+		if (items.length === 0) {
+			this.log("No embed versions found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"Type",
+			"Key",
+			"Label"
+		], items.map((v) => [
+			require_lib_term_map.applyCliTerms(String(v.type ?? "")),
+			String(v.key ?? ""),
+			String(v.label ?? "")
+		]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${items.length} embed version${items.length === 1 ? "" : "s"}`));
+	}
+};
+//#endregion
+module.exports = PlayerEmbedVersions;

package/dist/commands/player/embed.cjs

@@ -0,0 +1,134 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+//#region src/commands/player/embed.ts
+/**
+* Player embed command — generates embed code for a video, webinar, or category.
+*
+* CRITICAL: /player/embed returns JSON with data.embed_code — NOT raw HTML.
+* Use apiClient.GET (openapi-fetch), NOT native fetch. Extract embed_code from JSON.
+*
+* Output (D-4): process.stdout.write(embedCode) — pipeable, no trailing newline.
+* In --json mode: returns { ok, data: { embed_code }, summary, breadcrumbs }.
+*
+* Term mappings applied:
+*   photo_id  → --video-id
+*   live_id   → --webinar-id
+*   album_id  → --category-id
+*
+* Threat mitigations:
+*   T-06-08: writes only embed_code string to stdout; no credential data exposed
+*/
+var PlayerEmbed = class PlayerEmbed extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Generate embed code for a video, webinar, or category";
+	static agentMetadata = {
+		api_endpoint: "GET /player/embed",
+		auth_scope: "anonymous",
+		output_shape: { type: "key-value" },
+		side_effects: "none"
+	};
+	static examples = [
+		"<%= config.bin %> player embed --video-id 123",
+		"<%= config.bin %> player embed --video-id 123 --responsive > embed.html",
+		"<%= config.bin %> player embed --webinar-id 456 --iframe",
+		"<%= config.bin %> player embed --video-id 123 --json"
+	];
+	static enableJsonFlag = true;
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		"video-id": _oclif_core.Flags.string({
+			description: "Video ID to embed (maps to photo_id)",
+			required: false
+		}),
+		"webinar-id": _oclif_core.Flags.string({
+			description: "Webinar ID to embed (maps to live_id)",
+			required: false
+		}),
+		"category-id": _oclif_core.Flags.string({
+			description: "Category ID to embed (maps to album_id)",
+			required: false
+		}),
+		"player-id": _oclif_core.Flags.string({
+			description: "Player ID to use (default: workspace default)",
+			required: false
+		}),
+		url: _oclif_core.Flags.string({
+			description: "Workspace URL to resolve to an embed code",
+			required: false
+		}),
+		width: _oclif_core.Flags.integer({
+			description: "Desired embed width in pixels",
+			required: false
+		}),
+		height: _oclif_core.Flags.integer({
+			description: "Desired embed height in pixels",
+			required: false
+		}),
+		responsive: _oclif_core.Flags.boolean({
+			description: "Return a responsive embed code (maps to responsive_p)",
+			allowNo: true,
+			required: false
+		}),
+		autoplay: _oclif_core.Flags.boolean({
+			description: "Enable auto-play in the embed code (maps to autoplay_p)",
+			allowNo: true,
+			required: false
+		}),
+		iframe: _oclif_core.Flags.boolean({
+			description: "Return an iframe-based embed code (maps to iframe_p)",
+			allowNo: true,
+			required: false
+		}),
+		start: _oclif_core.Flags.integer({
+			description: "Start position in seconds",
+			required: false
+		}),
+		"include-unpublished": _oclif_core.Flags.boolean({
+			description: "Include unpublished content in player parameters (maps to include_unpublished_p)",
+			allowNo: true,
+			required: false
+		}),
+		token: _oclif_core.Flags.string({
+			description: "Video token for private or token-protected videos",
+			required: false
+		}),
+		source: _oclif_core.Flags.string({
+			description: "Analytics source tag",
+			required: false
+		})
+	};
+	static args = {};
+	async run() {
+		const { flags } = await this.parse(PlayerEmbed);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.GET("/player/embed", { params: { query: {
+			photo_id: flags["video-id"] ? Number(flags["video-id"]) : void 0,
+			live_id: flags["webinar-id"] ? Number(flags["webinar-id"]) : void 0,
+			album_id: flags["category-id"] ? Number(flags["category-id"]) : void 0,
+			player_id: flags["player-id"] ? Number(flags["player-id"]) : void 0,
+			url: flags.url,
+			width: flags.width,
+			height: flags.height,
+			responsive_p: flags.responsive ? true : void 0,
+			autoplay_p: flags.autoplay ? true : void 0,
+			iframe_p: flags.iframe ? true : void 0,
+			start: flags.start,
+			include_unpublished_p: flags["include-unpublished"] ? true : void 0,
+			token: flags.token,
+			source: flags.source
+		} } });
+		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		const embedCode = data?.data?.embed_code ?? "";
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: { embed_code: embedCode },
+			summary: "Embed code generated",
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "player" }]
+		});
+		process.stdout.write(embedCode);
+	}
+};
+//#endregion
+module.exports = PlayerEmbed;

package/dist/commands/player/list.cjs

@@ -0,0 +1,86 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+const require_lib_pagination = require("../../lib/pagination.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/player/list.ts
+/**
+* Player list command — lists all players in the active workspace.
+*
+* PITFALL 2: /player/list is POST (not GET). Pagination params go in the form body.
+*
+* Renders a cli-table3 table with columns: ID, Name, Default.
+* Supports --json output with { ok, data, summary, breadcrumbs } shape (CLI-01).
+*/
+var PlayerList = class PlayerList extends require_lib_base_command.AuthenticatedCommand {
+	static description = "List players in the active workspace";
+	static agentMetadata = {
+		api_endpoint: "POST /player/list",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"ID",
+				"Name",
+				"Default"
+			]
+		},
+		side_effects: "none"
+	};
+	static examples = ["<%= config.bin %> player list", "<%= config.bin %> player list --json"];
+	static enableJsonFlag = true;
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		source: _oclif_core.Flags.string({
+			description: "Analytics source tag",
+			required: false
+		})
+	};
+	static args = {};
+	async run() {
+		const { flags } = await this.parse(PlayerList);
+		this.printWorkspaceHeader();
+		const players = await require_lib_pagination.fetchAllPages(async (page, size) => {
+			const { data, error } = await this.apiClient.POST("/player/list", {
+				body: {
+					p: page,
+					size,
+					source: flags.source
+				},
+				headers: { "Content-Type": "application/x-www-form-urlencoded" }
+			});
+			if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+			const resp = data;
+			return {
+				data: Array.isArray(resp?.data) ? resp.data : resp?.data ? [resp.data] : [],
+				total_count: resp?.total_count
+			};
+		});
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: players,
+			summary: `${players.length} player${players.length === 1 ? "" : "s"}`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "player" }]
+		});
+		if (players.length === 0) {
+			this.log("No players found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"ID",
+			"Name",
+			"Default"
+		], players.map((p) => [
+			String(p.player_id ?? ""),
+			require_lib_term_map.applyCliTerms(String(p.player_name ?? "")),
+			p.default_p ? "yes" : "no"
+		]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${players.length} player${players.length === 1 ? "" : "s"}`));
+	}
+};
+//#endregion
+module.exports = PlayerList;

package/dist/commands/player/styles.cjs

@@ -0,0 +1,70 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/player/styles.ts
+/**
+* Player styles command — lists available player visual styles.
+*
+* Each entry includes a style key, human-readable name, and icon identifier.
+*/
+var PlayerStyles = class PlayerStyles extends require_lib_base_command.AuthenticatedCommand {
+	static description = "List available player visual styles";
+	static agentMetadata = {
+		api_endpoint: "GET /player/styles",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"Style",
+				"Name",
+				"Icon"
+			]
+		},
+		side_effects: "none"
+	};
+	static examples = ["<%= config.bin %> player styles", "<%= config.bin %> player styles --json"];
+	static enableJsonFlag = true;
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		fields: _oclif_core.Flags.string({
+			description: "Comma-separated list of fields to return",
+			required: false
+		})
+	};
+	static args = {};
+	async run() {
+		const { flags } = await this.parse(PlayerStyles);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.GET("/player/styles", { params: { query: { fields: flags.fields } } });
+		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		const resp = data;
+		const items = Array.isArray(resp?.data) ? resp.data : resp?.data ? [resp.data] : [];
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: items,
+			summary: `${items.length} player style${items.length === 1 ? "" : "s"}`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "player" }]
+		});
+		if (items.length === 0) {
+			this.log("No player styles found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"Style",
+			"Name",
+			"Icon"
+		], items.map((s) => [
+			String(s.style ?? ""),
+			require_lib_term_map.applyCliTerms(String(s.name ?? "")),
+			String(s.icon ?? "")
+		]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${items.length} player style${items.length === 1 ? "" : "s"}`));
+	}
+};
+//#endregion
+module.exports = PlayerStyles;