@ait-co/console-cli 0.1.11 → 0.1.12

package/dist/cli.mjs

@@ -161,10 +161,10 @@ async function executeAndUnwrap(url, init, fetchImpl) {
 }
 //#endregion
 //#region src/api/mini-apps.ts
-const BASE$3 = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
+const BASE$4 = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
 async function fetchMiniApps(workspaceId, cookies, opts = {}) {
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${workspaceId}/mini-app`,
+		url: `${BASE$4}/workspaces/${workspaceId}/mini-app`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -187,7 +187,7 @@ function normalizeMiniApp(item, workspaceId, index) {
 }
 async function fetchReviewStatus(workspaceId, cookies, opts = {}) {
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${workspaceId}/mini-apps/review-status`,
+		url: `${BASE$4}/workspaces/${workspaceId}/mini-apps/review-status`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -206,7 +206,7 @@ async function fetchReviewStatus(workspaceId, cookies, opts = {}) {
 }
 async function fetchMiniAppWithDraft(workspaceId, miniAppId, cookies, opts = {}) {
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${workspaceId}/mini-app/${miniAppId}/with-draft`,
+		url: `${BASE$4}/workspaces/${workspaceId}/mini-app/${miniAppId}/with-draft`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -228,7 +228,7 @@ async function fetchMiniAppRatings(params, cookies, opts = {}) {
 	const sortField = params.sortField ?? "CREATED_AT";
 	const sortDirection = params.sortDirection ?? "DESC";
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/app-ratings?page=${page}&size=${size}&sortField=${sortField}&sortDirection=${sortDirection}`,
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/app-ratings?page=${page}&size=${size}&sortField=${sortField}&sortDirection=${sortDirection}`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -261,7 +261,7 @@ async function fetchUserReports(params, cookies, opts = {}) {
 	qs.set("pageSize", String(pageSize));
 	if (params.cursor !== void 0) qs.set("cursor", params.cursor);
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${params.workspaceId}/mini-apps/${params.miniAppId}/user-reports?` + qs.toString(),
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-apps/${params.miniAppId}/user-reports?` + qs.toString(),
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -285,7 +285,7 @@ async function fetchBundles(params, cookies, opts = {}) {
 	if (params.deployStatus !== void 0) qs.set("deployStatus", params.deployStatus);
 	const query = qs.toString();
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/bundles` + (query ? `?${query}` : ""),
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/bundles` + (query ? `?${query}` : ""),
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -309,7 +309,7 @@ async function fetchConversionMetrics(params, cookies, opts = {}) {
 	qs.set("startDate", params.startDate);
 	qs.set("endDate", params.endDate);
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/conversion-metrics?${qs.toString()}`,
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/conversion-metrics?${qs.toString()}`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -327,7 +327,7 @@ async function fetchConversionMetrics(params, cookies, opts = {}) {
 }
 async function fetchCerts(workspaceId, miniAppId, cookies, opts = {}) {
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${workspaceId}/mini-app/${miniAppId}/certs`,
+		url: `${BASE$4}/workspaces/${workspaceId}/mini-app/${miniAppId}/certs`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -341,7 +341,7 @@ async function fetchShareRewards(params, cookies, opts = {}) {
 	const qs = new URLSearchParams();
 	qs.set("search", params.search ?? "");
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/share-rewards?${qs.toString()}`,
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/share-rewards?${qs.toString()}`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -351,9 +351,164 @@ async function fetchShareRewards(params, cookies, opts = {}) {
 		return r;
 	});
 }
+async function fetchSmartMessageCampaigns(params, cookies, opts = {}) {
+	const page = params.page ?? 0;
+	const size = params.size ?? 20;
+	const qs = new URLSearchParams();
+	qs.set("page", String(page));
+	qs.set("size", String(size));
+	const raw = await requestConsoleApi({
+		method: "POST",
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/smart-message/campaigns?${qs.toString()}`,
+		body: {
+			sort: params.sort ?? [{
+				field: "regTs",
+				direction: "DESC"
+			}],
+			search: params.search ?? "",
+			filters: params.filters ?? {}
+		},
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error(`Unexpected smart-message campaigns shape for app=${params.miniAppId}`);
+	const data = raw;
+	const items = Array.isArray(data.items) ? data.items : [];
+	const rawPaging = data.paging;
+	const paging = {
+		pageNumber: typeof rawPaging?.pageNumber === "number" ? rawPaging.pageNumber : page,
+		pageSize: typeof rawPaging?.pageSize === "number" ? rawPaging.pageSize : size,
+		hasNext: Boolean(rawPaging?.hasNext),
+		totalCount: typeof rawPaging?.totalCount === "number" ? rawPaging.totalCount : items.length
+	};
+	return {
+		items: items.map((r) => r && typeof r === "object" ? r : {}),
+		paging
+	};
+}
+async function fetchAppEventCatalogs(params, cookies, opts = {}) {
+	const pageNumber = params.pageNumber ?? 0;
+	const pageSize = params.pageSize ?? 20;
+	const raw = await requestConsoleApi({
+		method: "POST",
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/log/catalogs/search`,
+		body: {
+			isRefresh: params.refresh ?? false,
+			pageNumber,
+			pageSize,
+			search: params.search ?? ""
+		},
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error(`Unexpected event-catalogs shape for app=${params.miniAppId}`);
+	const data = raw;
+	const results = Array.isArray(data.results) ? data.results : [];
+	const rawPaging = data.paging;
+	const paging = {
+		pageNumber: typeof rawPaging?.pageNumber === "number" ? rawPaging.pageNumber : pageNumber,
+		pageSize: typeof rawPaging?.pageSize === "number" ? rawPaging.pageSize : pageSize,
+		hasNext: Boolean(rawPaging?.hasNext),
+		totalCount: typeof rawPaging?.totalCount === "number" ? rawPaging.totalCount : results.length,
+		totalPages: typeof rawPaging?.totalPages === "number" ? rawPaging.totalPages : 0
+	};
+	return {
+		results: results.map((r) => r && typeof r === "object" ? r : {}),
+		cacheTime: typeof data.cacheTime === "string" ? data.cacheTime : void 0,
+		paging
+	};
+}
+const TEMPLATE_CONTENT_REACH_TYPES = ["FUNCTIONAL", "MARKETING"];
+async function fetchAppTemplates(params, cookies, opts = {}) {
+	const page = params.page ?? 0;
+	const size = params.size ?? 20;
+	const qs = new URLSearchParams();
+	qs.set("page", String(page));
+	qs.set("size", String(size));
+	if (params.contentReachType) qs.set("contentReachType", params.contentReachType);
+	if (params.isSmartMessage !== void 0) qs.set("isSmartMessage", String(params.isSmartMessage));
+	const raw = await requestConsoleApi({
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/templates/search?${qs.toString()}`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error(`Unexpected templates shape for app=${params.miniAppId}`);
+	const data = raw;
+	const list = Array.isArray(data.groupSendContextSimpleView) ? data.groupSendContextSimpleView : [];
+	const pageMeta = data.page;
+	return {
+		templates: list.map((r) => r && typeof r === "object" ? r : {}),
+		totalPageCount: typeof pageMeta?.totalPageCount === "number" ? pageMeta.totalPageCount : 0
+	};
+}
+async function fetchImpressionCategoryList(cookies, opts = {}) {
+	const raw = await requestConsoleApi({
+		url: `${BASE$4}/impression/category-list`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (!Array.isArray(raw)) throw new Error("Unexpected impression/category-list shape: not an array");
+	return raw.map((entry, i) => {
+		if (!entry || typeof entry !== "object") throw new Error(`Unexpected category-list entry at index ${i}`);
+		const e = entry;
+		const group = e.categoryGroup;
+		const list = Array.isArray(e.categoryList) ? e.categoryList : [];
+		return {
+			categoryGroup: {
+				id: typeof group?.id === "number" ? group.id : 0,
+				name: typeof group?.name === "string" ? group.name : "",
+				isSelectable: Boolean(group?.isSelectable)
+			},
+			categoryList: list.map((c) => {
+				if (!c || typeof c !== "object") return {
+					id: 0,
+					name: "",
+					isSelectable: false,
+					subCategoryList: []
+				};
+				const cr = c;
+				const subs = Array.isArray(cr.subCategoryList) ? cr.subCategoryList : [];
+				return {
+					id: typeof cr.id === "number" ? cr.id : 0,
+					name: typeof cr.name === "string" ? cr.name : "",
+					isSelectable: Boolean(cr.isSelectable),
+					subCategoryList: subs.map((s) => {
+						if (!s || typeof s !== "object") return {
+							id: 0,
+							name: "",
+							isSelectable: false
+						};
+						const sr = s;
+						return {
+							id: typeof sr.id === "number" ? sr.id : 0,
+							name: typeof sr.name === "string" ? sr.name : "",
+							isSelectable: Boolean(sr.isSelectable)
+						};
+					})
+				};
+			})
+		};
+	});
+}
+async function fetchAppServiceStatus(workspaceId, miniAppId, cookies, opts = {}) {
+	const raw = await requestConsoleApi({
+		url: `${BASE$4}/workspaces/${workspaceId}/mini-app/${miniAppId}/review-status`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error(`Unexpected app service-status shape for app=${miniAppId}`);
+	const data = raw;
+	const serviceStatus = data.serviceStatus;
+	if (typeof serviceStatus !== "string") throw new Error(`Unexpected app service-status shape for app=${miniAppId}: missing serviceStatus`);
+	return {
+		shutdownCandidateStatus: typeof data.shutdownCandidateStatus === "string" ? data.shutdownCandidateStatus : null,
+		scheduledShutdownAt: typeof data.scheduledShutdownAt === "string" ? data.scheduledShutdownAt : null,
+		serviceStatus
+	};
+}
 async function fetchDeployedBundle(workspaceId, miniAppId, cookies, opts = {}) {
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${workspaceId}/mini-app/${miniAppId}/bundles/deployed`,
+		url: `${BASE$4}/workspaces/${workspaceId}/mini-app/${miniAppId}/bundles/deployed`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -363,7 +518,7 @@ async function fetchDeployedBundle(workspaceId, miniAppId, cookies, opts = {}) {
 }
 async function createMiniApp(workspaceId, payload, cookies, opts = {}) {
 	return normalizeCreateResult(await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${workspaceId}/mini-app/review`,
+		url: `${BASE$4}/workspaces/${workspaceId}/mini-app/review`,
 		method: "POST",
 		cookies,
 		body: payload,
@@ -396,7 +551,7 @@ function normalizeCreateResult(raw) {
 * the field name is actually `file` — if so, swap it in one place here.
 */
 async function uploadMiniAppResource(params, opts = {}) {
-	const url = new URL(`${BASE$3}/resource/${params.workspaceId}/upload`);
+	const url = new URL(`${BASE$4}/resource/${params.workspaceId}/upload`);
 	url.searchParams.set("validWidth", String(params.validWidth));
 	url.searchParams.set("validHeight", String(params.validHeight));
 	const form = new FormData();
@@ -2265,73 +2420,559 @@ const appCommand = defineCommand({
 				}
 			}) }
 		}),
-		register: defineCommand({
+		messages: defineCommand({
 			meta: {
-				name: "register",
-				description: "Register a mini-app in the selected workspace from a YAML/JSON manifest. Uploads logo/thumbnail/screenshots, then submits the create payload."
+				name: "messages",
+				description: "Inspect smart-message (formerly push) campaigns for a mini-app."
 			},
-			args: {
-				workspace: {
-					type: "string",
-					description: "Workspace ID. Defaults to the selected workspace (`aitcc workspace use`)."
+			subCommands: { ls: defineCommand({
+				meta: {
+					name: "ls",
+					description: "List smart-message campaigns (formerly \"push\" — the 스마트 발송 menu)."
 				},
-				config: {
-					type: "string",
-					description: "Path to the app manifest. Defaults to `./aitcc.app.yaml`, then `./aitcc.app.json`."
+				args: {
+					id: {
+						type: "positional",
+						description: "Mini-app ID.",
+						required: true
+					},
+					workspace: {
+						type: "string",
+						description: "Workspace ID. Defaults to the selected workspace."
+					},
+					page: {
+						type: "string",
+						description: "Page number (0-indexed).",
+						default: "0"
+					},
+					size: {
+						type: "string",
+						description: "Page size.",
+						default: "20"
+					},
+					search: {
+						type: "string",
+						description: "Title-contains filter. Empty matches everything."
+					},
+					json: {
+						type: "boolean",
+						description: "Emit machine-readable JSON.",
+						default: false
+					}
 				},
-				"dry-run": {
-					type: "boolean",
-					description: "Validate manifest + images and print the inferred submit payload; no uploads.",
-					default: false
+				async run({ args }) {
+					const appId = parseAppId(args.id);
+					if (appId === null) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-id",
+							message: `app id must be a positive integer (got ${JSON.stringify(args.id)})`
+						});
+						else process.stderr.write(`app messages ls: invalid id ${JSON.stringify(args.id)}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					const pageResult = parseNonNegativeInt(String(args.page), "page");
+					if ("error" in pageResult) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-page",
+							message: pageResult.error
+						});
+						else process.stderr.write(`${pageResult.error}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					const sizeResult = parseNonNegativeInt(String(args.size), "size");
+					if ("error" in sizeResult) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-size",
+							message: sizeResult.error
+						});
+						else process.stderr.write(`${sizeResult.error}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					const ctx = await resolveWorkspaceContext(args);
+					if (!ctx) return;
+					const { session, workspaceId } = ctx;
+					try {
+						const result = await fetchSmartMessageCampaigns({
+							workspaceId,
+							miniAppId: appId,
+							page: pageResult.value,
+							size: sizeResult.value,
+							...args.search !== void 0 ? { search: String(args.search) } : {}
+						}, session.cookies);
+						if (args.json) {
+							emitJson({
+								ok: true,
+								workspaceId,
+								appId,
+								campaigns: result.items,
+								paging: result.paging
+							});
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						if (result.items.length === 0) {
+							process.stdout.write(`App ${appId} (ws ${workspaceId}): no smart-message campaigns\n`);
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						process.stdout.write(`App ${appId} (ws ${workspaceId}): ${result.items.length} campaign(s) on page ${result.paging.pageNumber} of ${result.paging.totalCount}\n`);
+						for (const c of result.items) {
+							const id = typeof c.id === "string" || typeof c.id === "number" ? c.id : typeof c.campaignId === "string" || typeof c.campaignId === "number" ? c.campaignId : "-";
+							const title = typeof c.title === "string" ? c.title : typeof c.name === "string" ? c.name : "-";
+							const status = typeof c.status === "string" ? c.status : "-";
+							process.stdout.write(`${id}\t${title}\t${status}\n`);
+						}
+						return exitAfterFlush(ExitCode.Ok);
+					} catch (err) {
+						return emitFailureFromError(args.json, err);
+					}
+				}
+			}) }
+		}),
+		events: defineCommand({
+			meta: {
+				name: "events",
+				description: "Inspect custom event catalogs (log search) for a mini-app."
+			},
+			subCommands: { ls: defineCommand({
+				meta: {
+					name: "ls",
+					description: "List custom event catalogs recorded for a mini-app (the 이벤트 menu)."
 				},
-				"accept-terms": {
-					type: "boolean",
-					description: "Attest to the required console legal-agreement checkboxes (see VALIDATION-RULES.md). Required for real submits.",
-					default: false
+				args: {
+					id: {
+						type: "positional",
+						description: "Mini-app ID.",
+						required: true
+					},
+					workspace: {
+						type: "string",
+						description: "Workspace ID. Defaults to the selected workspace."
+					},
+					page: {
+						type: "string",
+						description: "Page number (0-indexed).",
+						default: "0"
+					},
+					size: {
+						type: "string",
+						description: "Page size.",
+						default: "20"
+					},
+					search: {
+						type: "string",
+						description: "Event-name filter. Empty matches everything."
+					},
+					refresh: {
+						type: "boolean",
+						description: "Bypass the server cache and rebuild the catalog list.",
+						default: false
+					},
+					json: {
+						type: "boolean",
+						description: "Emit machine-readable JSON.",
+						default: false
+					}
 				},
-				json: {
-					type: "boolean",
-					description: "Emit machine-readable JSON to stdout.",
-					default: false
+				async run({ args }) {
+					const appId = parseAppId(args.id);
+					if (appId === null) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-id",
+							message: `app id must be a positive integer (got ${JSON.stringify(args.id)})`
+						});
+						else process.stderr.write(`app events ls: invalid id ${JSON.stringify(args.id)}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					const pageResult = parseNonNegativeInt(String(args.page), "page");
+					if ("error" in pageResult) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-page",
+							message: pageResult.error
+						});
+						else process.stderr.write(`${pageResult.error}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					const sizeResult = parseNonNegativeInt(String(args.size), "size");
+					if ("error" in sizeResult) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-size",
+							message: sizeResult.error
+						});
+						else process.stderr.write(`${sizeResult.error}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					const ctx = await resolveWorkspaceContext(args);
+					if (!ctx) return;
+					const { session, workspaceId } = ctx;
+					try {
+						const result = await fetchAppEventCatalogs({
+							workspaceId,
+							miniAppId: appId,
+							pageNumber: pageResult.value,
+							pageSize: sizeResult.value,
+							...args.search !== void 0 ? { search: String(args.search) } : {},
+							...args.refresh ? { refresh: true } : {}
+						}, session.cookies);
+						if (args.json) {
+							emitJson({
+								ok: true,
+								workspaceId,
+								appId,
+								events: result.results,
+								cacheTime: result.cacheTime ?? null,
+								paging: result.paging
+							});
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						if (result.results.length === 0) {
+							const ct = result.cacheTime ? ` (cached ${result.cacheTime})` : "";
+							process.stdout.write(`App ${appId} (ws ${workspaceId}): no event catalogs${ct}\n`);
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						process.stdout.write(`App ${appId} (ws ${workspaceId}): ${result.results.length} event(s) on page ${result.paging.pageNumber} of ${result.paging.totalPages}\n`);
+						for (const e of result.results) {
+							const name = typeof e.name === "string" ? e.name : typeof e.eventName === "string" ? e.eventName : "-";
+							const count = typeof e.count === "number" ? String(e.count) : typeof e.totalCount === "number" ? String(e.totalCount) : "-";
+							process.stdout.write(`${name}\t${count}\n`);
+						}
+						return exitAfterFlush(ExitCode.Ok);
+					} catch (err) {
+						return emitFailureFromError(args.json, err);
+					}
 				}
+			}) }
+		}),
+		templates: defineCommand({
+			meta: {
+				name: "templates",
+				description: "Inspect smart-message composer templates available for a mini-app."
 			},
-			async run({ args }) {
-				await runRegister({
-					json: args.json,
-					dryRun: args["dry-run"],
-					acceptTerms: args["accept-terms"],
-					...args.workspace !== void 0 ? { workspace: args.workspace } : {},
-					...args.config !== void 0 ? { config: args.config } : {}
-				});
-			}
-		})
-	}
-});
-//#endregion
-//#region src/api/api-keys.ts
-const BASE$2 = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
-async function fetchApiKeys(workspaceId, cookies, opts = {}) {
-	const raw = await requestConsoleApi({
-		url: `${BASE$2}/workspaces/${workspaceId}/api-keys`,
-		cookies,
-		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
-	});
-	if (!Array.isArray(raw)) throw new Error(`Unexpected api-keys shape for workspace=${workspaceId}: not an array`);
-	return raw.map((entry, index) => normalizeKey(entry, workspaceId, index));
-}
-function normalizeKey(raw, workspaceId, index) {
-	if (raw === null || typeof raw !== "object") throw new Error(`Unexpected api-key entry at index ${index} for workspace=${workspaceId}: not an object`);
-	const rec = raw;
-	const rawId = rec.id ?? rec.apiKeyId ?? rec.keyId;
-	if (typeof rawId !== "string" && typeof rawId !== "number") throw new Error(`Unexpected api-key entry at index ${index} for workspace=${workspaceId}: missing id`);
-	const rawName = rec.name ?? rec.apiKeyName ?? rec.keyName ?? rec.description;
-	const name = typeof rawName === "string" ? rawName : void 0;
-	const { id: _id, apiKeyId: _aid, keyId: _kid, name: _n, apiKeyName: _an, keyName: _kn, description: _d, ...extra } = rec;
-	return {
-		id: rawId,
-		name,
-		extra
-	};
+			subCommands: { ls: defineCommand({
+				meta: {
+					name: "ls",
+					description: "List the smart-message composer templates available for a mini-app (the 템플릿 picker in 스마트 발송)."
+				},
+				args: {
+					id: {
+						type: "positional",
+						description: "Mini-app ID.",
+						required: true
+					},
+					workspace: {
+						type: "string",
+						description: "Workspace ID. Defaults to the selected workspace."
+					},
+					page: {
+						type: "string",
+						description: "Page number (0-indexed).",
+						default: "0"
+					},
+					size: {
+						type: "string",
+						description: "Page size.",
+						default: "20"
+					},
+					"content-reach-type": {
+						type: "string",
+						description: `Template reach bucket: ${TEMPLATE_CONTENT_REACH_TYPES.join(" | ")}. Omit for all.`
+					},
+					"smart-message": {
+						type: "string",
+						description: "Filter to templates compatible with smart-message (\"true\") or legacy push (\"false\"). Omit for all."
+					},
+					json: {
+						type: "boolean",
+						description: "Emit machine-readable JSON.",
+						default: false
+					}
+				},
+				async run({ args }) {
+					const appId = parseAppId(args.id);
+					if (appId === null) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-id",
+							message: `app id must be a positive integer (got ${JSON.stringify(args.id)})`
+						});
+						else process.stderr.write(`app templates ls: invalid id ${JSON.stringify(args.id)}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					const pageResult = parseNonNegativeInt(String(args.page), "page");
+					if ("error" in pageResult) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-page",
+							message: pageResult.error
+						});
+						else process.stderr.write(`${pageResult.error}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					const sizeResult = parseNonNegativeInt(String(args.size), "size");
+					if ("error" in sizeResult) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-size",
+							message: sizeResult.error
+						});
+						else process.stderr.write(`${sizeResult.error}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					let contentReachType;
+					if (args["content-reach-type"] !== void 0) {
+						const upper = String(args["content-reach-type"]).toUpperCase();
+						if (TEMPLATE_CONTENT_REACH_TYPES.includes(upper)) contentReachType = upper;
+						else {
+							const message = `--content-reach-type must be one of: ${TEMPLATE_CONTENT_REACH_TYPES.join(", ")}`;
+							if (args.json) emitJson({
+								ok: false,
+								reason: "invalid-content-reach-type",
+								allowed: [...TEMPLATE_CONTENT_REACH_TYPES]
+							});
+							else process.stderr.write(`${message}\n`);
+							return exitAfterFlush(ExitCode.Usage);
+						}
+					}
+					let isSmartMessage;
+					if (args["smart-message"] !== void 0) {
+						const raw = String(args["smart-message"]).toLowerCase();
+						if (raw === "true") isSmartMessage = true;
+						else if (raw === "false") isSmartMessage = false;
+						else {
+							const message = "--smart-message must be \"true\" or \"false\"";
+							if (args.json) emitJson({
+								ok: false,
+								reason: "invalid-smart-message",
+								message
+							});
+							else process.stderr.write(`${message}\n`);
+							return exitAfterFlush(ExitCode.Usage);
+						}
+					}
+					const ctx = await resolveWorkspaceContext(args);
+					if (!ctx) return;
+					const { session, workspaceId } = ctx;
+					try {
+						const result = await fetchAppTemplates({
+							workspaceId,
+							miniAppId: appId,
+							page: pageResult.value,
+							size: sizeResult.value,
+							...contentReachType !== void 0 ? { contentReachType } : {},
+							...isSmartMessage !== void 0 ? { isSmartMessage } : {}
+						}, session.cookies);
+						if (args.json) {
+							emitJson({
+								ok: true,
+								workspaceId,
+								appId,
+								templates: result.templates,
+								totalPageCount: result.totalPageCount
+							});
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						if (result.templates.length === 0) {
+							process.stdout.write(`App ${appId} (ws ${workspaceId}): no templates\n`);
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						process.stdout.write(`App ${appId} (ws ${workspaceId}): ${result.templates.length} template(s) of ${result.totalPageCount} page(s)\n`);
+						for (const t of result.templates) {
+							const id = typeof t.id === "string" || typeof t.id === "number" ? t.id : typeof t.templateId === "string" || typeof t.templateId === "number" ? t.templateId : "-";
+							const title = typeof t.title === "string" ? t.title : typeof t.name === "string" ? t.name : "-";
+							const type = typeof t.templateType === "string" ? t.templateType : "-";
+							process.stdout.write(`${id}\t${title}\t${type}\n`);
+						}
+						return exitAfterFlush(ExitCode.Ok);
+					} catch (err) {
+						return emitFailureFromError(args.json, err);
+					}
+				}
+			}) }
+		}),
+		categories: defineCommand({
+			meta: {
+				name: "categories",
+				description: "List the impression category tree used by `app register`'s `categoryIds` field."
+			},
+			args: {
+				selectable: {
+					type: "boolean",
+					description: "Only show categories flagged `isSelectable: true` — the ones you can pick.",
+					default: false
+				},
+				json: {
+					type: "boolean",
+					description: "Emit machine-readable JSON to stdout.",
+					default: false
+				}
+			},
+			async run({ args }) {
+				const session = await readSession();
+				if (!session) {
+					emitNotAuthenticated(args.json);
+					return exitAfterFlush(ExitCode.NotAuthenticated);
+				}
+				try {
+					const tree = await fetchImpressionCategoryList(session.cookies);
+					const filtered = args.selectable ? tree.filter((g) => g.categoryGroup.isSelectable).map((g) => ({
+						...g,
+						categoryList: g.categoryList.filter((c) => c.isSelectable).map((c) => ({
+							...c,
+							subCategoryList: c.subCategoryList.filter((s) => s.isSelectable)
+						}))
+					})) : tree;
+					if (args.json) {
+						emitJson({
+							ok: true,
+							categories: filtered
+						});
+						return exitAfterFlush(ExitCode.Ok);
+					}
+					for (const g of filtered) {
+						const mark = g.categoryGroup.isSelectable ? "" : " (not selectable)";
+						process.stdout.write(`[${g.categoryGroup.id}] ${g.categoryGroup.name}${mark}\n`);
+						for (const c of g.categoryList) {
+							const cmark = c.isSelectable ? "" : " (not selectable)";
+							process.stdout.write(`  ${c.id}\t${c.name}${cmark}\n`);
+							for (const s of c.subCategoryList) {
+								const smark = s.isSelectable ? "" : " (not selectable)";
+								process.stdout.write(`    ${s.id}\t${s.name}${smark}\n`);
+							}
+						}
+					}
+					return exitAfterFlush(ExitCode.Ok);
+				} catch (err) {
+					return emitFailureFromError(args.json, err);
+				}
+			}
+		}),
+		"service-status": defineCommand({
+			meta: {
+				name: "service-status",
+				description: "Show the server-authoritative runtime status of a mini-app (serviceStatus, shutdown schedule)."
+			},
+			args: {
+				id: {
+					type: "positional",
+					description: "Mini-app ID.",
+					required: true
+				},
+				workspace: {
+					type: "string",
+					description: "Workspace ID. Defaults to the selected workspace."
+				},
+				json: {
+					type: "boolean",
+					description: "Emit machine-readable JSON.",
+					default: false
+				}
+			},
+			async run({ args }) {
+				const appId = parseAppId(args.id);
+				if (appId === null) {
+					if (args.json) emitJson({
+						ok: false,
+						reason: "invalid-id",
+						message: `app id must be a positive integer (got ${JSON.stringify(args.id)})`
+					});
+					else process.stderr.write(`app service-status: invalid id ${JSON.stringify(args.id)}\n`);
+					return exitAfterFlush(ExitCode.Usage);
+				}
+				const ctx = await resolveWorkspaceContext(args);
+				if (!ctx) return;
+				const { session, workspaceId } = ctx;
+				try {
+					const st = await fetchAppServiceStatus(workspaceId, appId, session.cookies);
+					if (args.json) {
+						emitJson({
+							ok: true,
+							workspaceId,
+							appId,
+							...st
+						});
+						return exitAfterFlush(ExitCode.Ok);
+					}
+					process.stdout.write(`App ${appId} (ws ${workspaceId}):\n`);
+					process.stdout.write(`  serviceStatus: ${st.serviceStatus}\n`);
+					process.stdout.write(`  shutdownCandidateStatus: ${st.shutdownCandidateStatus ?? "null"}\n`);
+					process.stdout.write(`  scheduledShutdownAt: ${st.scheduledShutdownAt ?? "null"}\n`);
+					return exitAfterFlush(ExitCode.Ok);
+				} catch (err) {
+					return emitFailureFromError(args.json, err);
+				}
+			}
+		}),
+		register: defineCommand({
+			meta: {
+				name: "register",
+				description: "Register a mini-app in the selected workspace from a YAML/JSON manifest. Uploads logo/thumbnail/screenshots, then submits the create payload."
+			},
+			args: {
+				workspace: {
+					type: "string",
+					description: "Workspace ID. Defaults to the selected workspace (`aitcc workspace use`)."
+				},
+				config: {
+					type: "string",
+					description: "Path to the app manifest. Defaults to `./aitcc.app.yaml`, then `./aitcc.app.json`."
+				},
+				"dry-run": {
+					type: "boolean",
+					description: "Validate manifest + images and print the inferred submit payload; no uploads.",
+					default: false
+				},
+				"accept-terms": {
+					type: "boolean",
+					description: "Attest to the required console legal-agreement checkboxes (see VALIDATION-RULES.md). Required for real submits.",
+					default: false
+				},
+				json: {
+					type: "boolean",
+					description: "Emit machine-readable JSON to stdout.",
+					default: false
+				}
+			},
+			async run({ args }) {
+				await runRegister({
+					json: args.json,
+					dryRun: args["dry-run"],
+					acceptTerms: args["accept-terms"],
+					...args.workspace !== void 0 ? { workspace: args.workspace } : {},
+					...args.config !== void 0 ? { config: args.config } : {}
+				});
+			}
+		})
+	}
+});
+//#endregion
+//#region src/api/api-keys.ts
+const BASE$3 = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
+async function fetchApiKeys(workspaceId, cookies, opts = {}) {
+	const raw = await requestConsoleApi({
+		url: `${BASE$3}/workspaces/${workspaceId}/api-keys`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (!Array.isArray(raw)) throw new Error(`Unexpected api-keys shape for workspace=${workspaceId}: not an array`);
+	return raw.map((entry, index) => normalizeKey(entry, workspaceId, index));
+}
+function normalizeKey(raw, workspaceId, index) {
+	if (raw === null || typeof raw !== "object") throw new Error(`Unexpected api-key entry at index ${index} for workspace=${workspaceId}: not an object`);
+	const rec = raw;
+	const rawId = rec.id ?? rec.apiKeyId ?? rec.keyId;
+	if (typeof rawId !== "string" && typeof rawId !== "number") throw new Error(`Unexpected api-key entry at index ${index} for workspace=${workspaceId}: missing id`);
+	const rawName = rec.name ?? rec.apiKeyName ?? rec.keyName ?? rec.description;
+	const name = typeof rawName === "string" ? rawName : void 0;
+	const { id: _id, apiKeyId: _aid, keyId: _kid, name: _n, apiKeyName: _an, keyName: _kn, description: _d, ...extra } = rec;
+	return {
+		id: rawId,
+		name,
+		extra
+	};
 }
 const keysCommand = defineCommand({
 	meta: {
@@ -2392,7 +3033,8 @@ const keysCommand = defineCommand({
 });
 //#endregion
 //#region src/api/me.ts
-const MEMBER_USER_INFO_URL = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole/members/me/user-info";
+const BASE$2 = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
+const MEMBER_USER_INFO_URL = `${BASE$2}/members/me/user-info`;
 async function fetchConsoleMemberUserInfo(cookies, opts = {}) {
 	return requestConsoleApi({
 		url: MEMBER_USER_INFO_URL,
@@ -2400,6 +3042,28 @@ async function fetchConsoleMemberUserInfo(cookies, opts = {}) {
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
 }
+async function fetchUserTerms(cookies, opts = {}) {
+	const raw = await requestConsoleApi({
+		url: `${BASE$2}/console-user-terms/me`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (!Array.isArray(raw)) throw new Error("Unexpected user-terms shape: not an array");
+	return raw.map((entry, i) => {
+		if (!entry || typeof entry !== "object") throw new Error(`Unexpected user-terms entry at index ${i}`);
+		const e = entry;
+		return {
+			required: Boolean(e.required),
+			termsId: typeof e.termsId === "number" ? e.termsId : 0,
+			revisionId: typeof e.revisionId === "number" ? e.revisionId : 0,
+			title: typeof e.title === "string" ? e.title : "",
+			contentsUrl: typeof e.contentsUrl === "string" ? e.contentsUrl : "",
+			actionType: typeof e.actionType === "string" ? e.actionType : "",
+			isAgreed: Boolean(e.isAgreed),
+			isOneTimeConsent: Boolean(e.isOneTimeConsent)
+		};
+	});
+}
 //#endregion
 //#region src/cdp.ts
 function isResponse(m) {
@@ -3054,27 +3718,75 @@ const logoutCommand = defineCommand({
 	}
 });
 //#endregion
-//#region src/api/members.ts
-const BASE$1 = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
-async function fetchWorkspaceMembers(workspaceId, cookies, opts = {}) {
-	const raw = await requestConsoleApi({
-		url: `${BASE$1}/workspaces/${workspaceId}/members`,
-		cookies,
-		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
-	});
-	if (!Array.isArray(raw)) throw new Error(`Unexpected members shape for workspace=${workspaceId}: not an array`);
-	return raw.map((entry, index) => normalizeMember(entry, workspaceId, index));
+//#region src/commands/me.ts
+function formatTermLine(t) {
+	return `  ${t.isAgreed ? "[agreed]" : "[pending]"}${t.required ? " required" : ""}  ${t.title}\n    ${t.contentsUrl}\n`;
 }
-function normalizeMember(raw, workspaceId, index) {
-	if (raw === null || typeof raw !== "object") throw new Error(`Unexpected member entry at index ${index} for workspace=${workspaceId}: not an object`);
-	const rec = raw;
-	const stringField = (k) => {
-		const v = rec[k];
-		if (typeof v !== "string") throw new Error(`Unexpected member entry at index ${index} for workspace=${workspaceId}: missing ${k}`);
-		return v;
-	};
-	const numField = (k) => {
-		const v = rec[k];
+const meCommand = defineCommand({
+	meta: {
+		name: "me",
+		description: "Inspect account-level settings for the signed-in user."
+	},
+	subCommands: { terms: defineCommand({
+		meta: {
+			name: "terms",
+			description: "Show the console-level terms of agreement for the signed-in account."
+		},
+		args: { json: {
+			type: "boolean",
+			description: "Emit machine-readable JSON to stdout.",
+			default: false
+		} },
+		async run({ args }) {
+			const session = await readSession();
+			if (!session) {
+				emitNotAuthenticated(args.json);
+				return exitAfterFlush(ExitCode.NotAuthenticated);
+			}
+			try {
+				const terms = await fetchUserTerms(session.cookies);
+				if (args.json) {
+					emitJson({
+						ok: true,
+						terms
+					});
+					return exitAfterFlush(ExitCode.Ok);
+				}
+				if (terms.length === 0) {
+					process.stdout.write("No console-level terms required.\n");
+					return exitAfterFlush(ExitCode.Ok);
+				}
+				process.stdout.write("Console account terms:\n");
+				for (const t of terms) process.stdout.write(formatTermLine(t));
+				return exitAfterFlush(ExitCode.Ok);
+			} catch (err) {
+				return emitFailureFromError(args.json, err);
+			}
+		}
+	}) }
+});
+//#endregion
+//#region src/api/members.ts
+const BASE$1 = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
+async function fetchWorkspaceMembers(workspaceId, cookies, opts = {}) {
+	const raw = await requestConsoleApi({
+		url: `${BASE$1}/workspaces/${workspaceId}/members`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (!Array.isArray(raw)) throw new Error(`Unexpected members shape for workspace=${workspaceId}: not an array`);
+	return raw.map((entry, index) => normalizeMember(entry, workspaceId, index));
+}
+function normalizeMember(raw, workspaceId, index) {
+	if (raw === null || typeof raw !== "object") throw new Error(`Unexpected member entry at index ${index} for workspace=${workspaceId}: not an object`);
+	const rec = raw;
+	const stringField = (k) => {
+		const v = rec[k];
+		if (typeof v !== "string") throw new Error(`Unexpected member entry at index ${index} for workspace=${workspaceId}: missing ${k}`);
+		return v;
+	};
+	const numField = (k) => {
+		const v = rec[k];
 		if (typeof v !== "number" || !Number.isFinite(v)) throw new Error(`Unexpected member entry at index ${index} for workspace=${workspaceId}: missing ${k}`);
 		return v;
 	};
@@ -3507,7 +4219,7 @@ function resolveVersion() {
 		if (typeof injected === "string" && injected.length > 0) return injected;
 	} catch {}
 	try {
-		return "0.1.11";
+		return "0.1.12";
 	} catch {}
 	return "0.0.0-dev";
 }
@@ -3886,6 +4598,70 @@ async function fetchWorkspaceDetail(workspaceId, cookies, opts = {}) {
 		extra
 	};
 }
+async function fetchWorkspacePartner(workspaceId, cookies, opts = {}) {
+	const raw = await requestConsoleApi({
+		url: `${WORKSPACES_BASE}/workspaces/${workspaceId}/partner`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	const registered = raw.registered;
+	if (typeof registered !== "boolean") throw new Error(`Unexpected workspace partner shape for id=${workspaceId}`);
+	return {
+		registered,
+		approvalType: typeof raw.approvalType === "string" ? raw.approvalType : null,
+		rejectMessage: typeof raw.rejectMessage === "string" ? raw.rejectMessage : null,
+		partner: raw.partner && typeof raw.partner === "object" ? raw.partner : null
+	};
+}
+const WORKSPACE_TERM_TYPES = [
+	"TOSS_LOGIN",
+	"BIZ_WORKSPACE",
+	"TOSS_PROMOTION_MONEY",
+	"IAA",
+	"IAP"
+];
+const DEFAULT_SEGMENT_CATEGORY = "생성된 세그먼트";
+async function fetchWorkspaceSegments(params, cookies, opts = {}) {
+	const page = params.page ?? 0;
+	const qs = new URLSearchParams();
+	qs.set("category", params.category ?? DEFAULT_SEGMENT_CATEGORY);
+	qs.set("search", params.search ?? "");
+	qs.set("page", String(page));
+	const raw = await requestConsoleApi({
+		url: `${WORKSPACES_BASE}/workspaces/${params.workspaceId}/segments/list?${qs.toString()}`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error(`Unexpected segments shape for workspace=${params.workspaceId}`);
+	const data = raw;
+	return {
+		contents: (Array.isArray(data.contents) ? data.contents : []).map((c) => c && typeof c === "object" ? c : {}),
+		totalPage: typeof data.totalPage === "number" ? data.totalPage : 0,
+		currentPage: typeof data.currentPage === "number" ? data.currentPage : page
+	};
+}
+async function fetchWorkspaceTerms(workspaceId, type, cookies, opts = {}) {
+	const raw = await requestConsoleApi({
+		url: `${WORKSPACES_BASE}/workspaces/${workspaceId}/console-workspace-terms/${type}/skip-permission`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (!Array.isArray(raw)) throw new Error(`Unexpected workspace terms shape for type=${type}`);
+	return raw.map((entry, i) => {
+		if (!entry || typeof entry !== "object") throw new Error(`Unexpected workspace terms entry at index ${i} for type=${type}`);
+		const e = entry;
+		return {
+			required: Boolean(e.required),
+			termsId: typeof e.termsId === "number" ? e.termsId : 0,
+			revisionId: typeof e.revisionId === "number" ? e.revisionId : 0,
+			title: typeof e.title === "string" ? e.title : "",
+			contentsUrl: typeof e.contentsUrl === "string" ? e.contentsUrl : "",
+			actionType: typeof e.actionType === "string" ? e.actionType : "",
+			isAgreed: Boolean(e.isAgreed),
+			isOneTimeConsent: Boolean(e.isOneTimeConsent)
+		};
+	});
+}
 //#endregion
 //#region src/commands/workspace.ts
 function formatScalar(v) {
@@ -3893,68 +4669,282 @@ function formatScalar(v) {
 	if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") return String(v);
 	return JSON.stringify(v);
 }
+const lsCommand = defineCommand({
+	meta: {
+		name: "ls",
+		description: "List workspaces the current user has access to."
+	},
+	args: { json: {
+		type: "boolean",
+		description: "Emit machine-readable JSON to stdout.",
+		default: false
+	} },
+	async run({ args }) {
+		const session = await readSession();
+		if (!session) {
+			emitNotAuthenticated(args.json);
+			return exitAfterFlush(ExitCode.NotAuthenticated);
+		}
+		try {
+			const info = await fetchConsoleMemberUserInfo(session.cookies);
+			const current = session.currentWorkspaceId;
+			if (args.json) {
+				emitJson({
+					ok: true,
+					workspaces: info.workspaces.map((w) => ({
+						workspaceId: w.workspaceId,
+						workspaceName: w.workspaceName,
+						role: w.role,
+						current: w.workspaceId === current
+					}))
+				});
+				return exitAfterFlush(ExitCode.Ok);
+			}
+			if (info.workspaces.length === 0) {
+				process.stdout.write("No workspaces.\n");
+				return exitAfterFlush(ExitCode.Ok);
+			}
+			for (const w of info.workspaces) {
+				const marker = w.workspaceId === current ? "* " : "  ";
+				process.stdout.write(`${marker}${w.workspaceId}  ${w.workspaceName}  (${w.role})\n`);
+			}
+			if (current === void 0) process.stderr.write("No workspace selected. Run `aitcc workspace use <id>`.\n");
+			return exitAfterFlush(ExitCode.Ok);
+		} catch (err) {
+			return emitFailureFromError(args.json, err);
+		}
+	}
+});
+const useCommand = defineCommand({
+	meta: {
+		name: "use",
+		description: "Select the current workspace by ID. Subsequent commands use this."
+	},
+	args: {
+		id: {
+			type: "positional",
+			description: "Workspace ID",
+			required: true
+		},
+		json: {
+			type: "boolean",
+			description: "Emit machine-readable JSON to stdout.",
+			default: false
+		}
+	},
+	async run({ args }) {
+		const raw = String(args.id);
+		const parsed = parsePositiveInt$1(raw);
+		if (parsed === null) {
+			const message = `workspace id must be a positive integer (got ${raw})`;
+			if (args.json) emitJson({
+				ok: false,
+				reason: "invalid-id",
+				message
+			});
+			else process.stderr.write(`${message}\n`);
+			return exitAfterFlush(ExitCode.Usage);
+		}
+		const session = await readSession();
+		if (!session) {
+			emitNotAuthenticated(args.json);
+			return exitAfterFlush(ExitCode.NotAuthenticated);
+		}
+		try {
+			const match = (await fetchConsoleMemberUserInfo(session.cookies)).workspaces.find((w) => w.workspaceId === parsed);
+			if (!match) {
+				if (args.json) emitJson({
+					ok: false,
+					reason: "not-found",
+					workspaceId: parsed
+				});
+				else process.stderr.write(`Workspace ${parsed} is not accessible from this account. Run \`aitcc workspace ls\` to see available workspaces.\n`);
+				return exitAfterFlush(ExitCode.Usage);
+			}
+			if (await setCurrentWorkspaceId(parsed) === null) {
+				emitNotAuthenticated(args.json);
+				return exitAfterFlush(ExitCode.NotAuthenticated);
+			}
+			if (args.json) emitJson({
+				ok: true,
+				workspaceId: match.workspaceId,
+				workspaceName: match.workspaceName
+			});
+			else process.stdout.write(`Using workspace ${match.workspaceId} (${match.workspaceName}).\n`);
+			return exitAfterFlush(ExitCode.Ok);
+		} catch (err) {
+			return emitFailureFromError(args.json, err);
+		}
+	}
+});
+const showCommand = defineCommand({
+	meta: {
+		name: "show",
+		description: "Show details of the selected workspace (or the one passed with --workspace)."
+	},
+	args: {
+		workspace: {
+			type: "string",
+			description: "Workspace ID to inspect. Defaults to the selected workspace."
+		},
+		json: {
+			type: "boolean",
+			description: "Emit machine-readable JSON to stdout.",
+			default: false
+		}
+	},
+	async run({ args }) {
+		const session = await readSession();
+		if (!session) {
+			emitNotAuthenticated(args.json);
+			return exitAfterFlush(ExitCode.NotAuthenticated);
+		}
+		let workspaceId;
+		if (args.workspace) {
+			const raw = String(args.workspace);
+			const parsed = parsePositiveInt$1(raw);
+			if (parsed === null) {
+				const message = `--workspace must be a positive integer (got ${raw})`;
+				if (args.json) emitJson({
+					ok: false,
+					reason: "invalid-id",
+					message
+				});
+				else process.stderr.write(`${message}\n`);
+				return exitAfterFlush(ExitCode.Usage);
+			}
+			workspaceId = parsed;
+		} else workspaceId = session.currentWorkspaceId;
+		if (workspaceId === void 0) {
+			if (args.json) emitJson({
+				ok: false,
+				reason: "no-workspace-selected"
+			});
+			else process.stderr.write("No workspace selected. Pass `--workspace <id>` or run `aitcc workspace use <id>`.\n");
+			return exitAfterFlush(ExitCode.Usage);
+		}
+		try {
+			const detail = await fetchWorkspaceDetail(workspaceId, session.cookies);
+			if (args.json) {
+				emitJson({
+					ok: true,
+					workspaceId: detail.workspaceId,
+					workspaceName: detail.workspaceName,
+					extra: detail.extra ?? {}
+				});
+				return exitAfterFlush(ExitCode.Ok);
+			}
+			process.stdout.write(`Workspace ${detail.workspaceId}: ${detail.workspaceName}\n`);
+			if (detail.extra) for (const [k, v] of Object.entries(detail.extra)) process.stdout.write(`  ${k}: ${formatScalar(v)}\n`);
+			return exitAfterFlush(ExitCode.Ok);
+		} catch (err) {
+			return emitFailureFromError(args.json, err);
+		}
+	}
+});
+async function resolveWorkspaceArg(args, selected) {
+	if (args.workspace) {
+		const raw = String(args.workspace);
+		const parsed = parsePositiveInt$1(raw);
+		if (parsed === null) {
+			const message = `--workspace must be a positive integer (got ${raw})`;
+			if (args.json) emitJson({
+				ok: false,
+				reason: "invalid-id",
+				message
+			});
+			else process.stderr.write(`${message}\n`);
+			return null;
+		}
+		return parsed;
+	}
+	if (selected === void 0) {
+		if (args.json) emitJson({
+			ok: false,
+			reason: "no-workspace-selected"
+		});
+		else process.stderr.write("No workspace selected. Pass `--workspace <id>` or run `aitcc workspace use <id>`.\n");
+		return null;
+	}
+	return selected;
+}
+const partnerCommand = defineCommand({
+	meta: {
+		name: "partner",
+		description: "Show the partner (billing/payout) registration state for the selected workspace."
+	},
+	args: {
+		workspace: {
+			type: "string",
+			description: "Workspace ID to inspect. Defaults to the selected workspace."
+		},
+		json: {
+			type: "boolean",
+			description: "Emit machine-readable JSON to stdout.",
+			default: false
+		}
+	},
+	async run({ args }) {
+		const session = await readSession();
+		if (!session) {
+			emitNotAuthenticated(args.json);
+			return exitAfterFlush(ExitCode.NotAuthenticated);
+		}
+		const workspaceId = await resolveWorkspaceArg(args, session.currentWorkspaceId);
+		if (workspaceId === null) return exitAfterFlush(ExitCode.Usage);
+		try {
+			const state = await fetchWorkspacePartner(workspaceId, session.cookies);
+			if (args.json) {
+				emitJson({
+					ok: true,
+					workspaceId,
+					registered: state.registered,
+					approvalType: state.approvalType,
+					rejectMessage: state.rejectMessage,
+					partner: state.partner
+				});
+				return exitAfterFlush(ExitCode.Ok);
+			}
+			process.stdout.write(`Workspace ${workspaceId} partner:\n`);
+			process.stdout.write(`  registered: ${state.registered}\n`);
+			process.stdout.write(`  approvalType: ${state.approvalType ?? "null"}\n`);
+			if (state.rejectMessage) process.stdout.write(`  rejectMessage: ${state.rejectMessage}\n`);
+			if (state.partner) {
+				process.stdout.write("  partner:\n");
+				for (const [k, v] of Object.entries(state.partner)) process.stdout.write(`    ${k}: ${formatScalar(v)}\n`);
+			}
+			return exitAfterFlush(ExitCode.Ok);
+		} catch (err) {
+			return emitFailureFromError(args.json, err);
+		}
+	}
+});
+function formatTermLines(term) {
+	return `  ${term.isAgreed ? "[agreed]" : "[pending]"}${term.required ? " required" : ""}  ${term.title}\n    ${term.contentsUrl}\n`;
+}
 const workspaceCommand = defineCommand({
 	meta: {
 		name: "workspace",
 		description: "Inspect and switch between the workspaces this account can access."
 	},
 	subCommands: {
-		ls: defineCommand({
+		ls: lsCommand,
+		use: useCommand,
+		show: showCommand,
+		partner: partnerCommand,
+		terms: defineCommand({
 			meta: {
-				name: "ls",
-				description: "List workspaces the current user has access to."
-			},
-			args: { json: {
-				type: "boolean",
-				description: "Emit machine-readable JSON to stdout.",
-				default: false
-			} },
-			async run({ args }) {
-				const session = await readSession();
-				if (!session) {
-					emitNotAuthenticated(args.json);
-					return exitAfterFlush(ExitCode.NotAuthenticated);
-				}
-				try {
-					const info = await fetchConsoleMemberUserInfo(session.cookies);
-					const current = session.currentWorkspaceId;
-					if (args.json) {
-						emitJson({
-							ok: true,
-							workspaces: info.workspaces.map((w) => ({
-								workspaceId: w.workspaceId,
-								workspaceName: w.workspaceName,
-								role: w.role,
-								current: w.workspaceId === current
-							}))
-						});
-						return exitAfterFlush(ExitCode.Ok);
-					}
-					if (info.workspaces.length === 0) {
-						process.stdout.write("No workspaces.\n");
-						return exitAfterFlush(ExitCode.Ok);
-					}
-					for (const w of info.workspaces) {
-						const marker = w.workspaceId === current ? "* " : "  ";
-						process.stdout.write(`${marker}${w.workspaceId}  ${w.workspaceName}  (${w.role})\n`);
-					}
-					if (current === void 0) process.stderr.write("No workspace selected. Run `aitcc workspace use <id>`.\n");
-					return exitAfterFlush(ExitCode.Ok);
-				} catch (err) {
-					return emitFailureFromError(args.json, err);
-				}
-			}
-		}),
-		use: defineCommand({
-			meta: {
-				name: "use",
-				description: "Select the current workspace by ID. Subsequent commands use this."
+				name: "terms",
+				description: "Show the console terms-of-agreement state that gate workspace-level features (Toss login, IAP, IAA, biz workspace, promotion money)."
 			},
 			args: {
-				id: {
-					type: "positional",
-					description: "Workspace ID",
-					required: true
+				type: {
+					type: "string",
+					description: `Term bucket to inspect: ${WORKSPACE_TERM_TYPES.join(" | ")}. Omit to query every bucket.`
+				},
+				workspace: {
+					type: "string",
+					description: "Workspace ID to inspect. Defaults to the selected workspace."
 				},
 				json: {
 					type: "boolean",
@@ -3963,114 +4953,158 @@ const workspaceCommand = defineCommand({
 				}
 			},
 			async run({ args }) {
-				const raw = String(args.id);
-				const parsed = parsePositiveInt$1(raw);
-				if (parsed === null) {
-					const message = `workspace id must be a positive integer (got ${raw})`;
+				const session = await readSession();
+				if (!session) {
+					emitNotAuthenticated(args.json);
+					return exitAfterFlush(ExitCode.NotAuthenticated);
+				}
+				const workspaceId = await resolveWorkspaceArg(args, session.currentWorkspaceId);
+				if (workspaceId === null) return exitAfterFlush(ExitCode.Usage);
+				const typesToQuery = (() => {
+					if (!args.type) return WORKSPACE_TERM_TYPES;
+					const raw = String(args.type).toUpperCase();
+					if (WORKSPACE_TERM_TYPES.includes(raw)) return [raw];
+					return [];
+				})();
+				if (typesToQuery.length === 0) {
+					const message = `--type must be one of: ${WORKSPACE_TERM_TYPES.join(", ")}`;
 					if (args.json) emitJson({
 						ok: false,
-						reason: "invalid-id",
-						message
+						reason: "invalid-type",
+						allowed: [...WORKSPACE_TERM_TYPES]
 					});
 					else process.stderr.write(`${message}\n`);
 					return exitAfterFlush(ExitCode.Usage);
 				}
-				const session = await readSession();
-				if (!session) {
-					emitNotAuthenticated(args.json);
-					return exitAfterFlush(ExitCode.NotAuthenticated);
-				}
 				try {
-					const match = (await fetchConsoleMemberUserInfo(session.cookies)).workspaces.find((w) => w.workspaceId === parsed);
-					if (!match) {
-						if (args.json) emitJson({
-							ok: false,
-							reason: "not-found",
-							workspaceId: parsed
+					const results = await Promise.all(typesToQuery.map(async (t) => [t, await fetchWorkspaceTerms(workspaceId, t, session.cookies)]));
+					if (typesToQuery.length === 1) {
+						const [type, terms] = results[0];
+						if (args.json) {
+							emitJson({
+								ok: true,
+								workspaceId,
+								type,
+								terms
+							});
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						process.stdout.write(`Workspace ${workspaceId} terms (${type}):\n`);
+						if (terms.length === 0) process.stdout.write("  (no terms required)\n");
+						else for (const t of terms) process.stdout.write(formatTermLines(t));
+						return exitAfterFlush(ExitCode.Ok);
+					}
+					const byType = {};
+					for (const [t, terms] of results) byType[t] = terms;
+					if (args.json) {
+						emitJson({
+							ok: true,
+							workspaceId,
+							byType
 						});
-						else process.stderr.write(`Workspace ${parsed} is not accessible from this account. Run \`aitcc workspace ls\` to see available workspaces.\n`);
-						return exitAfterFlush(ExitCode.Usage);
+						return exitAfterFlush(ExitCode.Ok);
 					}
-					if (await setCurrentWorkspaceId(parsed) === null) {
-						emitNotAuthenticated(args.json);
-						return exitAfterFlush(ExitCode.NotAuthenticated);
+					for (const [type, terms] of results) {
+						process.stdout.write(`\n[${type}]\n`);
+						if (terms.length === 0) process.stdout.write("  (no terms required)\n");
+						else for (const t of terms) process.stdout.write(formatTermLines(t));
 					}
-					if (args.json) emitJson({
-						ok: true,
-						workspaceId: match.workspaceId,
-						workspaceName: match.workspaceName
-					});
-					else process.stdout.write(`Using workspace ${match.workspaceId} (${match.workspaceName}).\n`);
 					return exitAfterFlush(ExitCode.Ok);
 				} catch (err) {
 					return emitFailureFromError(args.json, err);
 				}
 			}
 		}),
-		show: defineCommand({
+		segments: defineCommand({
 			meta: {
-				name: "show",
-				description: "Show details of the selected workspace (or the one passed with --workspace)."
+				name: "segments",
+				description: "Inspect user segments defined in a workspace."
 			},
-			args: {
-				workspace: {
-					type: "string",
-					description: "Workspace ID to inspect. Defaults to the selected workspace."
+			subCommands: { ls: defineCommand({
+				meta: {
+					name: "ls",
+					description: "List user segments in the selected workspace (the 세그먼트 menu)."
 				},
-				json: {
-					type: "boolean",
-					description: "Emit machine-readable JSON to stdout.",
-					default: false
-				}
-			},
-			async run({ args }) {
-				const session = await readSession();
-				if (!session) {
-					emitNotAuthenticated(args.json);
-					return exitAfterFlush(ExitCode.NotAuthenticated);
-				}
-				let workspaceId;
-				if (args.workspace) {
-					const raw = String(args.workspace);
-					const parsed = parsePositiveInt$1(raw);
-					if (parsed === null) {
-						const message = `--workspace must be a positive integer (got ${raw})`;
+				args: {
+					workspace: {
+						type: "string",
+						description: "Workspace ID. Defaults to the selected workspace."
+					},
+					category: {
+						type: "string",
+						description: "Category bucket (tab). Defaults to \"생성된 세그먼트\" — the UI's initial tab."
+					},
+					search: {
+						type: "string",
+						description: "Name-contains filter. Empty matches everything."
+					},
+					page: {
+						type: "string",
+						description: "Page number (0-indexed).",
+						default: "0"
+					},
+					json: {
+						type: "boolean",
+						description: "Emit machine-readable JSON to stdout.",
+						default: false
+					}
+				},
+				async run({ args }) {
+					const session = await readSession();
+					if (!session) {
+						emitNotAuthenticated(args.json);
+						return exitAfterFlush(ExitCode.NotAuthenticated);
+					}
+					const workspaceId = await resolveWorkspaceArg(args, session.currentWorkspaceId);
+					if (workspaceId === null) return exitAfterFlush(ExitCode.Usage);
+					const pageRaw = String(args.page);
+					const pageNum = Number(pageRaw);
+					if (!Number.isFinite(pageNum) || !Number.isInteger(pageNum) || pageNum < 0) {
+						const message = `--page must be a non-negative integer (got ${JSON.stringify(pageRaw)})`;
 						if (args.json) emitJson({
 							ok: false,
-							reason: "invalid-id",
+							reason: "invalid-page",
 							message
 						});
 						else process.stderr.write(`${message}\n`);
 						return exitAfterFlush(ExitCode.Usage);
 					}
-					workspaceId = parsed;
-				} else workspaceId = session.currentWorkspaceId;
-				if (workspaceId === void 0) {
-					if (args.json) emitJson({
-						ok: false,
-						reason: "no-workspace-selected"
-					});
-					else process.stderr.write("No workspace selected. Pass `--workspace <id>` or run `aitcc workspace use <id>`.\n");
-					return exitAfterFlush(ExitCode.Usage);
-				}
-				try {
-					const detail = await fetchWorkspaceDetail(workspaceId, session.cookies);
-					if (args.json) {
-						emitJson({
-							ok: true,
-							workspaceId: detail.workspaceId,
-							workspaceName: detail.workspaceName,
-							extra: detail.extra ?? {}
-						});
+					try {
+						const page = await fetchWorkspaceSegments({
+							workspaceId,
+							...args.category !== void 0 ? { category: String(args.category) } : {},
+							...args.search !== void 0 ? { search: String(args.search) } : {},
+							page: pageNum
+						}, session.cookies);
+						const category = args.category !== void 0 ? String(args.category) : "생성된 세그먼트";
+						if (args.json) {
+							emitJson({
+								ok: true,
+								workspaceId,
+								category,
+								segments: page.contents,
+								totalPage: page.totalPage,
+								currentPage: page.currentPage
+							});
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						if (page.contents.length === 0) {
+							process.stdout.write(`Workspace ${workspaceId} (${category}): no segments on page ${page.currentPage}\n`);
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						process.stdout.write(`Workspace ${workspaceId} (${category}): ${page.contents.length} segment(s), page ${page.currentPage} of ${page.totalPage}\n`);
+						for (const s of page.contents) {
+							const id = typeof s.id === "string" || typeof s.id === "number" ? s.id : typeof s.segmentId === "string" || typeof s.segmentId === "number" ? s.segmentId : "-";
+							const name = typeof s.name === "string" ? s.name : typeof s.title === "string" ? s.title : "-";
+							const userCount = typeof s.userCount === "number" ? String(s.userCount) : typeof s.count === "number" ? String(s.count) : "-";
+							process.stdout.write(`${id}\t${name}\t${userCount}\n`);
+						}
 						return exitAfterFlush(ExitCode.Ok);
+					} catch (err) {
+						return emitFailureFromError(args.json, err);
 					}
-					process.stdout.write(`Workspace ${detail.workspaceId}: ${detail.workspaceName}\n`);
-					if (detail.extra) for (const [k, v] of Object.entries(detail.extra)) process.stdout.write(`  ${k}: ${formatScalar(v)}\n`);
-					return exitAfterFlush(ExitCode.Ok);
-				} catch (err) {
-					return emitFailureFromError(args.json, err);
 				}
-			}
+			}) }
 		})
 	}
 });
@@ -4091,7 +5125,8 @@ runMain(defineCommand({
 		app: appCommand,
 		members: membersCommand,
 		keys: keysCommand,
-		notices: noticesCommand
+		notices: noticesCommand,
+		me: meCommand
 	}
 }));
 //#endregion