twentythree-cli 1.0.0

package/dist/commands/video/delete.cjs

@@ -0,0 +1,67 @@
+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/video/delete.ts
+/**
+* Video delete command — deletes a video after confirmation.
+*
+* Prompts user to confirm deletion showing the workspace domain so they know
+* which workspace they are deleting from (T-03-08 repudiation mitigation).
+*
+* --json flag skips the confirmation prompt (scripting mode — assume confirmed).
+*
+* Exit codes:
+*   0 — success
+*   1 — error (video not found, API error)
+*   2 — cancelled (user declined confirmation)
+*
+* Threat mitigations:
+*   T-03-08: Confirmation prompt includes workspace domain
+*   T-03-09: extends AuthenticatedCommand — anonymous mode rejected
+*/
+var VideoDelete = class VideoDelete extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Delete a video from the active workspace";
+	static examples = ["<%= config.bin %> video delete 12345", "<%= config.bin %> video delete 12345 --json"];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "POST /photo/delete",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "destructive"
+	};
+	static flags = { ...require_lib_base_command.AuthenticatedCommand.baseFlags };
+	static args = { id: _oclif_core.Args.string({
+		description: "Video ID",
+		required: true
+	}) };
+	async run() {
+		const { args } = await this.parse(VideoDelete);
+		this.printWorkspaceHeader();
+		if (!this.jsonEnabled()) {
+			const confirmed = await (0, _clack_prompts.confirm)({ message: `Delete video ${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("/photo/delete", {
+			body: { photo_id: Number(args.id) },
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (deleteError) this.error(require_lib_term_map.applyCliTerms(String(deleteError)), { exit: 1 });
+		this.log(chalk.default.green(`Video ${args.id} deleted`));
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: deleteData,
+			summary: `Video ${args.id} deleted`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, {
+				resource: "video",
+				id: args.id
+			}]
+		});
+	}
+};
+//#endregion
+module.exports = VideoDelete;

package/dist/commands/video/frame.cjs

@@ -0,0 +1,69 @@
+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/video/frame.ts
+/**
+* Video frame command — extracts a frame from a video at a given time offset.
+*
+* Threat mitigations:
+*   T-03-09: extends AuthenticatedCommand — anonymous mode rejected
+*/
+var VideoFrame = class VideoFrame extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Extract a frame from a video";
+	static examples = [
+		"<%= config.bin %> video frame 12345",
+		"<%= config.bin %> video frame 12345 --time 30",
+		"<%= config.bin %> video frame 12345 --time 30 --json"
+	];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "POST /photo/frame",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "updates"
+	};
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		time: _oclif_core.Flags.integer({
+			description: "Time offset in seconds to extract the frame from",
+			required: false
+		})
+	};
+	static args = { id: _oclif_core.Args.string({
+		description: "Video ID",
+		required: true
+	}) };
+	async run() {
+		const { args, flags } = await this.parse(VideoFrame);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.POST("/photo/frame", {
+			body: {
+				photo_id: Number(args.id),
+				...flags.time !== void 0 && { time: flags.time }
+			},
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		const frameData = data?.data ?? data;
+		if (!this.jsonEnabled()) {
+			const frameUrl = frameData?.url ?? frameData?.frame_url;
+			if (frameUrl) this.log(`Frame extracted: ${chalk.default.cyan(String(frameUrl))}`);
+			else this.log(chalk.default.green(`Frame extracted for video ${args.id}`));
+		}
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: frameData,
+			summary: `Frame extracted for video ${args.id}`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, {
+				resource: "video",
+				id: args.id
+			}]
+		});
+	}
+};
+//#endregion
+module.exports = VideoFrame;

package/dist/commands/video/get.cjs

@@ -0,0 +1,68 @@
+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/video/get.ts
+/**
+* Video get command — retrieves details of a single video by ID.
+*
+* Uses GET /photo/list?photo_id=<id> as the lookup mechanism — there is no
+* separate /photo/get endpoint (per RESEARCH.md Pitfall 8).
+*
+* Supports --json output with { ok, data, summary, breadcrumbs } shape (CLI-01).
+*/
+var VideoGet = class VideoGet extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Get details of a specific video";
+	static examples = ["<%= config.bin %> video get 12345", "<%= config.bin %> video get 12345 --json"];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "GET /photo/list",
+		auth_scope: "read",
+		output_shape: { type: "key-value" },
+		side_effects: "none"
+	};
+	static flags = { ...require_lib_base_command.AuthenticatedCommand.baseFlags };
+	static args = { id: _oclif_core.Args.string({
+		description: "Video ID",
+		required: true
+	}) };
+	async run() {
+		const { args } = await this.parse(VideoGet);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.GET("/photo/list", { params: { query: {
+			photo_id: Number(args.id),
+			include_unpublished_p: 1
+		} } });
+		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		const resp = data;
+		let video;
+		if (Array.isArray(resp?.data)) video = resp.data[0];
+		else if (resp?.data) video = resp.data;
+		if (!video) this.error(`Video ${args.id} not found`, { exit: 1 });
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: video,
+			summary: video.title ?? `Video ${args.id}`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, {
+				resource: "video",
+				id: args.id
+			}]
+		});
+		const tags = Array.isArray(video.tags) ? video.tags.join(", ") : video.tags ?? "";
+		const status = video.video_encoded_p ? "encoded" : "processing";
+		const published = video.published_p ? "yes" : "no";
+		this.log(`ID:          ${video.photo_id ?? args.id}`);
+		this.log(`Title:       ${require_lib_term_map.applyCliTerms(String(video.title ?? ""))}`);
+		this.log(`Description: ${require_lib_term_map.applyCliTerms(String(video.content_text ?? ""))}`);
+		this.log(`Duration:    ${String(video.video_length_fmt ?? "")}`);
+		this.log(`Status:      ${status}`);
+		this.log(`Published:   ${published}`);
+		this.log(`Tags:        ${require_lib_term_map.applyCliTerms(tags)}`);
+		this.log(`Category:    ${require_lib_term_map.applyCliTerms(String(video.album_title ?? ""))}`);
+		this.log(`Created:     ${String(video.creation_date_ansi ?? "")}`);
+		this.log(`Updated:     ${String(video.publish_date_ansi ?? "")}`);
+	}
+};
+//#endregion
+module.exports = VideoGet;

package/dist/commands/video/index.cjs

@@ -0,0 +1,11 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+let _oclif_core = require("@oclif/core");
+//#region src/commands/video/index.ts
+var VideoIndex = class extends _oclif_core.Command {
+	static description = "Manage videos — upload, list, update, delete, and more";
+	async run() {
+		this.log("Run \"twentythree video --help\" for available commands");
+	}
+};
+//#endregion
+module.exports = VideoIndex;

package/dist/commands/video/list.cjs

@@ -0,0 +1,98 @@
+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/video/list.ts
+/**
+* Video list command — lists all videos in the active workspace with auto-pagination.
+* Renders a cli-table3 table with columns: ID, Title, Duration, Status, Published, Updated.
+* Supports --json output with { ok, data, summary, breadcrumbs } shape (CLI-01).
+*/
+var VideoList = class VideoList extends require_lib_base_command.AuthenticatedCommand {
+	static description = "List videos in the active workspace";
+	static examples = ["<%= config.bin %> video list", "<%= config.bin %> video list --json"];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "GET /photo/list",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"ID",
+				"Title",
+				"Duration",
+				"Status",
+				"Published",
+				"Updated"
+			]
+		},
+		side_effects: "none"
+	};
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		limit: _oclif_core.Flags.integer({
+			description: "Maximum number of videos to return (default: all)",
+			required: false
+		}),
+		"include-unpublished": _oclif_core.Flags.boolean({
+			description: "Include unpublished videos in the results",
+			allowNo: true,
+			required: false
+		}),
+		"include-unpublished-p": _oclif_core.Flags.string({
+			hidden: true,
+			required: false
+		})
+	};
+	static args = {};
+	async run() {
+		const { flags } = await this.parse(VideoList);
+		this.printWorkspaceHeader();
+		const videos = await require_lib_pagination.fetchAllPages(async (page, size) => {
+			const { data, error } = await this.apiClient.GET("/photo/list", { params: { query: {
+				p: page,
+				size,
+				include_unpublished_p: parseBoolParam(flags["include-unpublished"], flags["include-unpublished-p"]) ? 1 : void 0
+			} } });
+			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: videos,
+			summary: `${videos.length} video${videos.length === 1 ? "" : "s"}`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "video" }]
+		});
+		if (videos.length === 0) {
+			this.log("No videos found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"ID",
+			"Title",
+			"Duration",
+			"Status",
+			"Published",
+			"Updated"
+		], videos.map((v) => [
+			String(v.photo_id ?? ""),
+			require_lib_term_map.applyCliTerms(String(v.title ?? "")),
+			String(v.video_length_fmt ?? ""),
+			v.video_encoded_p ? "encoded" : "processing",
+			v.published_p ? "yes" : "no",
+			String(v.publish_date_ansi ?? v.creation_date_ansi ?? "")
+		]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${videos.length} video${videos.length === 1 ? "" : "s"}`));
+	}
+};
+//#endregion
+module.exports = VideoList;

package/dist/commands/video/replace.cjs

@@ -0,0 +1,126 @@
+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_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/video/replace.ts
+/**
+* Simple inline progress bar that writes directly to stderr using \r.
+* Avoids all TTY-detection issues that afflict cli-progress.
+* T-03-10: shows only byte counts, never the replace_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;
+	}
+};
+/**
+* Video replace command — replaces a video file using the replace-token flow.
+*
+* Flow:
+*   1. GET /photo/get-replace-token (with photo_id)
+*   2. Upload replacement file in chunks using chunked-upload engine to /photo/replace
+*   3. Display success message; optionally return --json result
+*
+* Threat mitigations:
+*   T-03-10: replace_token is never logged — only byte counts shown in progress bar
+*   T-03-09: extends AuthenticatedCommand — anonymous mode rejected
+*/
+var VideoReplace = class VideoReplace extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Replace the video file for an existing video";
+	static examples = ["<%= config.bin %> video replace 12345 ./new-video.mp4", "<%= config.bin %> video replace 12345 ./new-video.mp4 --chunk-size 52428800 --concurrency 3"];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "POST /photo/replace",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "updates"
+	};
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		"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 args = {
+		id: _oclif_core.Args.string({
+			description: "Video ID to replace",
+			required: true
+		}),
+		file: _oclif_core.Args.string({
+			description: "Path to the replacement video file",
+			required: true
+		})
+	};
+	async run() {
+		const { args, flags } = await this.parse(VideoReplace);
+		this.printWorkspaceHeader();
+		try {
+			await (0, node_fs_promises.stat)(args.file);
+		} catch {
+			this.error(`File not found: ${args.file}`, { exit: 1 });
+		}
+		const { data: tokenData, error: tokenError } = await this.apiClient.GET("/photo/get-replace-token", { params: { query: { photo_id: args.id } } });
+		if (tokenError) this.error(require_lib_term_map.applyCliTerms(String(tokenError)), { exit: 1 });
+		const replaceToken = tokenData?.data?.replace_token;
+		if (!replaceToken) this.error("Failed to obtain replace token from API", { exit: 1 });
+		const totalBytes = (await (0, node_fs_promises.stat)(args.file)).size;
+		const bar = new ProgressBar();
+		const startTime = Date.now();
+		let result;
+		bar.render(0, totalBytes, 0);
+		try {
+			result = await require_upload_chunked_upload.uploadChunked({
+				filePath: args.file,
+				uploadToken: replaceToken,
+				tokenFieldName: "replace_token",
+				uploadUrl: `${this.apiBaseUrl}photo/replace`,
+				bearerToken: this.activeWorkspace.bearer_token || void 0,
+				chunkSize: flags["chunk-size"],
+				concurrency: flags.concurrency,
+				onProgress(bytesUploaded, total) {
+					const elapsed = (Date.now() - startTime) / 1e3;
+					const speed = elapsed > 0 ? bytesUploaded / elapsed : 0;
+					bar.render(bytesUploaded, total, speed);
+				}
+			});
+		} finally {
+			bar.finish();
+		}
+		const adminUrl = `https://${this.activeWorkspace.domain}/manage/video/${args.id}`;
+		this.log(chalk.default.green(`Video ${args.id} replaced successfully`));
+		this.log(`ID:    ${args.id}`);
+		this.log(`Admin: ${adminUrl}`);
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: result,
+			summary: `Video ${args.id} replaced`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, {
+				resource: "video",
+				id: args.id
+			}]
+		});
+	}
+};
+//#endregion
+module.exports = VideoReplace;

package/dist/commands/video/section/create.cjs

@@ -0,0 +1,73 @@
+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/video/section/create.ts
+/**
+* Video section create command — creates a new section (chapter) for a video.
+*/
+var VideoSectionCreate = class VideoSectionCreate extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Create a new section for a video";
+	static examples = ["<%= config.bin %> video section create 12345 --title \"Introduction\" --start-time 0", "<%= config.bin %> video section create 12345 --title \"Chapter 1\" --start-time 30 --description \"First chapter\""];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "POST /photo/section/create",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "creates"
+	};
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		title: _oclif_core.Flags.string({
+			description: "Section title",
+			required: true
+		}),
+		"start-time": _oclif_core.Flags.integer({
+			description: "Start time in seconds",
+			required: true
+		}),
+		description: _oclif_core.Flags.string({
+			description: "Section description",
+			required: false
+		})
+	};
+	static args = { id: _oclif_core.Args.string({
+		description: "Video ID",
+		required: true
+	}) };
+	async run() {
+		const { args, flags } = await this.parse(VideoSectionCreate);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.POST("/photo/section/create", {
+			body: {
+				photo_id: Number(args.id),
+				title: flags.title,
+				start_time: flags["start-time"],
+				...flags.description !== void 0 && { description: flags.description }
+			},
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		const adminUrl = `https://${this.activeWorkspace.domain}/manage/video/${args.id}`;
+		this.log(chalk.default.green(`Section created for video ${args.id}`));
+		this.log(`Admin: ${adminUrl}`);
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data,
+			summary: `Section created for video ${args.id}`,
+			breadcrumbs: [
+				{ domain: this.activeWorkspace.domain },
+				{
+					resource: "video",
+					id: args.id
+				},
+				{ resource: "section" }
+			]
+		});
+	}
+};
+//#endregion
+module.exports = VideoSectionCreate;

package/dist/commands/video/section/delete.cjs

@@ -0,0 +1,78 @@
+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/video/section/delete.ts
+/**
+* Video section delete command — deletes a section after confirmation.
+*
+* Prompts user to confirm deletion showing workspace domain and section ID
+* so they know exactly what is being deleted (T-03-11 repudiation mitigation).
+*
+* --json flag skips the confirmation prompt (scripting mode — assume confirmed).
+*
+* Threat mitigations:
+*   T-03-11: Confirmation prompt includes workspace domain and section ID
+*   T-03-09: extends AuthenticatedCommand — anonymous mode rejected
+*/
+var VideoSectionDelete = class VideoSectionDelete extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Delete a section from a video";
+	static examples = ["<%= config.bin %> video section delete 12345 --section-id 67", "<%= config.bin %> video section delete 12345 --section-id 67 --json"];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "POST /photo/section/delete",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "destructive"
+	};
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		"section-id": _oclif_core.Flags.string({
+			description: "Section ID to delete",
+			required: true
+		})
+	};
+	static args = { id: _oclif_core.Args.string({
+		description: "Video ID",
+		required: true
+	}) };
+	async run() {
+		const { args, flags } = await this.parse(VideoSectionDelete);
+		this.printWorkspaceHeader();
+		if (!this.jsonEnabled()) {
+			const confirmed = await (0, _clack_prompts.confirm)({ message: `Delete section ${flags["section-id"]} from video ${args.id} on ${this.activeWorkspace.domain}?` });
+			if ((0, _clack_prompts.isCancel)(confirmed) || !confirmed) process.exit(2);
+		}
+		const { data, error } = await this.apiClient.POST("/photo/section/delete", {
+			body: {
+				photo_id: Number(args.id),
+				section_id: flags["section-id"]
+			},
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		this.log(chalk.default.green(`Section ${flags["section-id"]} deleted from video ${args.id}`));
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data,
+			summary: `Section ${flags["section-id"]} deleted from video ${args.id}`,
+			breadcrumbs: [
+				{ domain: this.activeWorkspace.domain },
+				{
+					resource: "video",
+					id: args.id
+				},
+				{
+					resource: "section",
+					id: flags["section-id"]
+				}
+			]
+		});
+	}
+};
+//#endregion
+module.exports = VideoSectionDelete;

package/dist/commands/video/section/index.cjs

@@ -0,0 +1,11 @@
+require("../../../_virtual/_rolldown/runtime.cjs");
+let _oclif_core = require("@oclif/core");
+//#region src/commands/video/section/index.ts
+var SectionIndex = class extends _oclif_core.Command {
+	static description = "Manage video sections (chapters)";
+	async run() {
+		this.log("Run \"twentythree video section --help\" for available commands");
+	}
+};
+//#endregion
+module.exports = SectionIndex;

package/dist/commands/video/section/list.cjs

@@ -0,0 +1,75 @@
+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/video/section/list.ts
+/**
+* Video section list command — lists all sections (chapters) for a video.
+*/
+var VideoSectionList = class VideoSectionList extends require_lib_base_command.AuthenticatedCommand {
+	static description = "List all sections for a video";
+	static examples = ["<%= config.bin %> video section list 12345", "<%= config.bin %> video section list 12345 --json"];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "GET /photo/section/list",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"ID",
+				"Title",
+				"Start Time",
+				"Description"
+			]
+		},
+		side_effects: "none"
+	};
+	static flags = { ...require_lib_base_command.AuthenticatedCommand.baseFlags };
+	static args = { id: _oclif_core.Args.string({
+		description: "Video ID",
+		required: true
+	}) };
+	async run() {
+		const { args } = await this.parse(VideoSectionList);
+		this.printWorkspaceHeader();
+		const token = await this.fetchVideoToken(args.id);
+		const { data, error } = await this.apiClient.GET("/photo/section/list", { params: { query: {
+			photo_id: args.id,
+			token
+		} } });
+		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		const sections = data?.sections ?? data?.data ?? [];
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: sections,
+			summary: `Sections for video ${args.id}`,
+			breadcrumbs: [
+				{ domain: this.activeWorkspace.domain },
+				{
+					resource: "video",
+					id: args.id
+				},
+				{ resource: "section" }
+			]
+		});
+		if (sections.length === 0) {
+			this.log("No sections found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"ID",
+			"Title",
+			"Start Time",
+			"Description"
+		], sections.map((s) => [
+			String(s.section_id ?? s.id ?? ""),
+			String(s.title ?? ""),
+			s.start_time !== void 0 ? `${s.start_time}s` : "",
+			String(s.description ?? "")
+		]));
+		this.log(table.toString());
+	}
+};
+//#endregion
+module.exports = VideoSectionList;