@qoder-ai/qmind-cli 2.0.0 → 3.0.0

package/dist/qmind.js

@@ -1,10 +1,10 @@
+import { $ as executeStream, A as retrieveResultSchema, B as sourceTreeSchema, C as chatSessionListSchema, E as imageUrlsSchema, F as sourceImportResultsSchema, G as streamWireEventSchema, H as sourceUploadTicketSchema, I as sourceListSchema, J as voidResponseSchema, K as taskRunListSchema, L as sourcePreviewSchema, M as sourceActionAccessSchema, N as sourceChildrenCountsSchema, O as notebookListSchema, P as sourceContentSchema, Q as assertCapability, R as sourceRawContentSchema, S as chatMessageListSchema, T as imageUploadTicketSchema, U as sourceWebOfficeSessionSchema, V as sourceUploadCapabilitiesSchema, W as sourceWebOfficeTokenSchema, X as QMIND_MULTIPART_UPLOAD_MAX_BYTES, Y as wikiBranchListSchema, Z as QMIND_SOURCE_UPLOAD_MAX_BYTES, a as invalidArgument$1, c as optionalRecord, d as pagination$1, et as executeUnary, f as positiveInteger$1, h as stringList, i as httpUrl, j as sharedNotebookListSchema, k as notebookSchema, l as optionalString$1, m as requiredString$2, n as call, o as nonNegativeInteger$1, p as queryPath, q as taskRunSchema, r as compactUndefined, s as optionalBoolean, t as assertNonEmptyPatch, tt as QMindError, u as optionalTrimmedString, v as batchMutationResultSchema, w as chatSessionSchema, y as cancelQuestionResultSchema, z as sourceSchema } from "./shared-DwycozMA.js";
 import { createInterface } from "node:readline/promises";
+import { basename, dirname, extname, join, relative, resolve, sep } from "node:path";
 import { z } from "zod";
-import { Command, CommanderError, Option } from "commander";
 import { createHash, randomBytes } from "node:crypto";
 import { chmod, copyFile, link, lstat, mkdir, readFile, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
-import { basename, dirname, extname, join, relative, resolve, sep } from "node:path";
 import lockfile from "proper-lockfile";
 import open from "open";
 import { createReadStream, createWriteStream } from "node:fs";
@@ -12,782 +12,10 @@ import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { createParser } from "eventsource-parser";
 import { Agent, EnvHttpProxyAgent, request } from "undici";
+import { Command, CommanderError, Option } from "commander";
 import pLimit from "p-limit";
 import picomatch from "picomatch";
 import { decodeHTML } from "entities";
-//#region ../sdk/src/errors.ts
-var QMindError = class extends Error {
-	access;
-	code;
-	details;
-	operation;
-	rawBody;
-	requestId;
-	status;
-	upstreamCode;
-	constructor(code, message, options = {}) {
-		super(message, { cause: options.cause });
-		this.name = "QMindError";
-		this.access = options.access;
-		this.code = code;
-		this.details = options.details;
-		this.operation = options.operation;
-		this.rawBody = options.rawBody;
-		this.requestId = options.requestId;
-		this.status = options.status;
-		this.upstreamCode = options.upstreamCode;
-	}
-};
-//#endregion
-//#region ../sdk/src/execution.ts
-const credentialHeaders = /* @__PURE__ */ new Set([
-	"authorization",
-	"cookie",
-	"proxy-authorization",
-	"x-csrf-token",
-	"x-xsrf-token"
-]);
-function isRecord$5(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function nestedRecord(value, key) {
-	const nested = value[key];
-	return isRecord$5(nested) ? nested : void 0;
-}
-function firstString(records, keys) {
-	for (const record of records) {
-		if (record === void 0) continue;
-		for (const key of keys) {
-			const value = record[key];
-			if (typeof value === "string" && value.length > 0) return value;
-		}
-	}
-}
-function headerValue(headers, name) {
-	const normalizedName = name.toLowerCase();
-	for (const [key, value] of Object.entries(headers)) if (key.toLowerCase() === normalizedName && value.length > 0) return value;
-}
-function errorCodeForStatus$1(status) {
-	if (status === 401) return "AUTH_REQUIRED";
-	if (status === 403) return "FORBIDDEN";
-	if (status === 404) return "NOT_FOUND";
-	if (status === 409) return "CONFLICT";
-	if (status === 429) return "RATE_LIMITED";
-	if (status >= 400 && status < 500) return "INVALID_ARGUMENT";
-	return "REMOTE_ERROR";
-}
-function httpError(access, operation, profile, response) {
-	const body = profile.unwrapError(response.body);
-	const root = isRecord$5(body) ? body : void 0;
-	const records = [
-		root,
-		root === void 0 ? void 0 : nestedRecord(root, "error"),
-		root === void 0 ? void 0 : nestedRecord(root, "details")
-	];
-	const upstreamCode = firstString(records, [
-		"errorCode",
-		"error_code",
-		"code"
-	]);
-	const requestId = firstString(records, ["requestId", "request_id"]) ?? headerValue(response.headers, "x-request-id") ?? headerValue(response.headers, "request-id");
-	const message = firstString(records, [
-		"message",
-		"errorMessage",
-		"error_message"
-	]) ?? `QMind request failed with HTTP ${response.status}`;
-	return new QMindError(errorCodeForStatus$1(response.status), message, {
-		access,
-		details: body,
-		operation,
-		...response.rawBody === void 0 ? {} : { rawBody: response.rawBody },
-		...requestId === void 0 ? {} : { requestId },
-		status: response.status,
-		...upstreamCode === void 0 ? {} : { upstreamCode }
-	});
-}
-function isAbortLike(cause) {
-	return isRecord$5(cause) && (cause.name === "AbortError" && typeof cause.name === "string" || cause.code === "ABORT_ERR");
-}
-function transportError(access, operation, request, cause) {
-	if (cause instanceof QMindError) return cause;
-	const aborted = request.signal?.aborted === true || isAbortLike(cause);
-	return new QMindError(aborted ? "ABORTED" : "NETWORK_ERROR", aborted ? "QMind request was aborted" : "QMind transport failed", {
-		access,
-		cause,
-		operation
-	});
-}
-function requestWasAborted(request) {
-	return request.signal?.aborted === true;
-}
-function assertWireRequestInvariant(request) {
-	for (const [field, value] of [
-		["connectTimeoutMs", request.connectTimeoutMs],
-		["idleTimeoutMs", request.idleTimeoutMs],
-		["timeoutMs", request.timeoutMs]
-	]) if (!Number.isFinite(value ?? 1) || (value ?? 1) <= 0) throw new QMindError("INVALID_ARGUMENT", `${field} must be a positive finite number`, { details: { field } });
-	if (request.destination.kind === "host") {
-		if (!request.destination.path.startsWith("/") || request.destination.path.startsWith("//")) throw new QMindError("HOST_POLICY_ERROR", "host destination must be a root-relative path", { details: { destination: request.destination.kind } });
-		return;
-	}
-	let url;
-	try {
-		url = new URL(request.destination.url);
-	} catch (cause) {
-		throw new QMindError("HOST_POLICY_ERROR", "signed destination must be a valid HTTPS URL", {
-			cause,
-			details: { destination: request.destination.kind }
-		});
-	}
-	if (url.protocol !== "https:" || url.username.length > 0 || url.password.length > 0) throw new QMindError("HOST_POLICY_ERROR", "signed destination must be credential-free HTTPS", { details: { destination: request.destination.kind } });
-	for (const header of Object.keys(request.headers ?? {})) if (credentialHeaders.has(header.toLowerCase())) throw new QMindError("HOST_POLICY_ERROR", "host credentials must never be sent to a signed destination", { details: {
-		destination: request.destination.kind,
-		header: header.toLowerCase()
-	} });
-}
-function assertCapability(profile, capability, operation) {
-	if (profile.capabilities[capability]) return;
-	throw new QMindError("UNSUPPORTED_OPERATION", `${operation} is not supported by the ${profile.access} access profile`, {
-		access: profile.access,
-		details: { capability },
-		operation
-	});
-}
-async function executeUnary(options) {
-	const { capability, operation, profile, request, schema, transport } = options;
-	assertCapability(profile, capability, operation);
-	assertWireRequestInvariant(request);
-	if (requestWasAborted(request)) throw new QMindError("ABORTED", "QMind request was aborted", {
-		access: profile.access,
-		operation
-	});
-	let response;
-	try {
-		response = await transport.request(request);
-	} catch (cause) {
-		throw transportError(profile.access, operation, request, cause);
-	}
-	if (response.status < 200 || response.status >= 300) throw httpError(profile.access, operation, profile, response);
-	const body = profile.unwrapSuccess(operation, response.body);
-	const parsed = schema.safeParse(body);
-	if (!parsed.success) throw new QMindError("PROTOCOL_ERROR", "server response does not match the QMind contract", {
-		access: profile.access,
-		details: { issues: parsed.error.issues },
-		operation,
-		...response.rawBody === void 0 ? {} : { rawBody: response.rawBody },
-		status: response.status
-	});
-	return parsed.data;
-}
-function streamContractError(profile, operation, message, details) {
-	return new QMindError("STREAM_ERROR", message, {
-		access: profile.access,
-		...details === void 0 ? {} : { details },
-		operation
-	});
-}
-function streamFailureResponse(response) {
-	return {
-		body: response.body,
-		headers: response.headers,
-		...response.rawBody === void 0 ? {} : { rawBody: response.rawBody },
-		status: response.status
-	};
-}
-async function* executeStream(options) {
-	const { capability, operation, profile, request, transport } = options;
-	assertCapability(profile, capability, operation);
-	assertWireRequestInvariant(request);
-	if (requestWasAborted(request)) throw new QMindError("ABORTED", "QMind request was aborted", {
-		access: profile.access,
-		operation
-	});
-	let response;
-	try {
-		response = await transport.stream(request);
-	} catch (cause) {
-		throw transportError(profile.access, operation, request, cause);
-	}
-	if (response.kind === "response") {
-		if (response.status >= 200 && response.status < 300) throw streamContractError(profile, operation, "stream handshake returned no event stream", { status: response.status });
-		throw httpError(profile.access, operation, profile, streamFailureResponse(response));
-	}
-	if (response.status < 200 || response.status >= 300) throw streamContractError(profile, operation, "stream handshake returned events for a failure status", { status: response.status });
-	let doneMarkerSeen = false;
-	let started = false;
-	let terminal = false;
-	try {
-		for await (const payload of response.events) {
-			if (requestWasAborted(request)) throw new QMindError("ABORTED", "QMind request was aborted", {
-				access: profile.access,
-				operation
-			});
-			if (payload.trim() === "[DONE]") {
-				if (doneMarkerSeen) throw streamContractError(profile, operation, "stream emitted more than one [DONE] marker");
-				doneMarkerSeen = true;
-				continue;
-			}
-			if (doneMarkerSeen) throw streamContractError(profile, operation, "stream emitted an event after [DONE]");
-			if (terminal) throw streamContractError(profile, operation, "stream emitted an event after messageComplete");
-			const event = profile.decodeStreamPayload(payload);
-			if (event.type === "error") throw streamContractError(profile, operation, event.message, { event });
-			if (event.type === "messageStart") {
-				if (started) throw streamContractError(profile, operation, "stream emitted duplicate messageStart");
-				started = true;
-			} else if (!started) throw streamContractError(profile, operation, "stream event arrived before messageStart", { eventType: event.type });
-			if (event.type === "messageComplete") terminal = true;
-			yield event;
-		}
-	} catch (cause) {
-		throw transportError(profile.access, operation, request, cause);
-	}
-	if (requestWasAborted(request)) throw new QMindError("ABORTED", "QMind request was aborted", {
-		access: profile.access,
-		operation
-	});
-	if (!terminal) throw streamContractError(profile, operation, "stream ended before messageComplete", {
-		doneMarkerSeen,
-		started
-	});
-}
-//#endregion
-//#region ../sdk/src/workflows.ts
-const QMIND_MULTIPART_UPLOAD_MAX_BYTES = 52428800;
-const QMIND_SOURCE_UPLOAD_MAX_BYTES = 524288e3;
-Object.freeze({
-	canceled: {
-		order: 2,
-		outcome: "canceled",
-		phase: "terminal",
-		terminal: true
-	},
-	failed: {
-		order: 2,
-		outcome: "failure",
-		phase: "terminal",
-		terminal: true
-	},
-	partial: {
-		order: 2,
-		outcome: "partial",
-		phase: "terminal",
-		terminal: true
-	},
-	pending: {
-		order: 0,
-		outcome: "none",
-		phase: "queued",
-		terminal: false
-	},
-	running: {
-		order: 1,
-		outcome: "none",
-		phase: "active",
-		terminal: false
-	},
-	success: {
-		order: 2,
-		outcome: "success",
-		phase: "terminal",
-		terminal: true
-	},
-	unknown: {
-		order: -1,
-		outcome: "none",
-		phase: "unknown",
-		terminal: false
-	}
-});
-function normalizeQMindTaskRunStatus(status) {
-	switch (status.trim().toLowerCase()) {
-		case "pending":
-		case "running":
-		case "success":
-		case "partial":
-		case "failed":
-		case "canceled": return status.trim().toLowerCase();
-		default: return "unknown";
-	}
-}
-//#endregion
-//#region ../sdk/src/schemas.ts
-function isRecord$4(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-const wirePageNumberSchema = z.number().int().nonnegative().optional();
-const timestampSchema = z.union([z.string(), z.object({
-	nanos: z.number().int().optional(),
-	seconds: z.union([z.number(), z.string()])
-})]).nullable();
-const notebookOverviewSchema = z.object({
-	status: z.string().default("empty"),
-	summary: z.string().default(""),
-	topics: z.array(z.string()).nullish().transform((topics) => topics ?? [])
-});
-const notebookMaintenanceSchema = z.object({
-	lastRunAt: timestampSchema.optional(),
-	lastRunId: z.string().optional(),
-	status: z.string().default("idle")
-});
-const notebookAccessInfoSchema = z.object({
-	canDeleteNotebook: z.boolean(),
-	canEdit: z.boolean(),
-	canManageMembers: z.boolean(),
-	canManageTasks: z.boolean(),
-	currentUserPermission: z.string(),
-	memberCount: z.number().int().nonnegative()
-});
-const notebookSchema = z.object({
-	access: notebookAccessInfoSchema.nullable().optional(),
-	client: z.string().optional(),
-	createdAt: timestampSchema.optional(),
-	description: z.string().default(""),
-	id: z.string().min(1),
-	maintenance: notebookMaintenanceSchema.optional(),
-	materialCount: z.number().int().nonnegative().default(0),
-	orgId: z.string().default(""),
-	overview: notebookOverviewSchema.optional(),
-	settings: z.record(z.string(), z.unknown()).optional(),
-	sourceCount: z.number().int().nonnegative().default(0),
-	status: z.string().default("active"),
-	title: z.string(),
-	updatedAt: timestampSchema.optional(),
-	userId: z.string().default("")
-});
-const notebookListSchema = z.object({
-	currentPage: wirePageNumberSchema,
-	notebooks: z.array(notebookSchema).nullish().transform((notebooks) => notebooks ?? []),
-	pageSize: wirePageNumberSchema,
-	totalSize: z.number().int().nonnegative().default(0)
-});
-const wikiDocumentSchema = z.preprocess((value) => isRecord$4(value) ? {
-	...value,
-	contentHash: value.contentHash ?? value.content_hash,
-	contentUrl: value.contentUrl ?? value.content_url
-} : value, z.object({
-	contentHash: z.string().default(""),
-	contentUrl: z.string().min(1),
-	language: z.string().default("")
-}));
-const wikiBranchSchema = z.preprocess((value) => isRecord$4(value) ? {
-	...value,
-	commitTimestamp: value.commitTimestamp ?? value.commit_timestamp,
-	knowledgeCount: value.knowledgeCount ?? value.knowledge_count,
-	repoUrl: value.repoUrl ?? value.repo_url,
-	resultVersion: value.resultVersion ?? value.result_version,
-	updatedAt: value.updatedAt ?? value.updated_at
-} : value, z.object({
-	branch: z.string().min(1),
-	commitTimestamp: z.number().optional(),
-	documents: z.array(wikiDocumentSchema).nullish().transform((documents) => documents ?? []),
-	exists: z.boolean().optional(),
-	knowledgeCount: z.number().int().nonnegative().default(0),
-	repo: z.string().min(1),
-	repoUrl: z.string().optional(),
-	resultVersion: z.string().default(""),
-	updatedAt: timestampSchema.optional()
-}));
-const wikiBranchListSchema = z.object({ branches: z.array(wikiBranchSchema).nullish().transform((branches) => branches ?? []) });
-const cardLinkSchema = z.object({
-	description: z.string().optional(),
-	linkType: z.string().default(""),
-	targetId: z.string().min(1),
-	targetTitle: z.string().optional()
-});
-const cardSchema = z.object({
-	branch: z.string().optional(),
-	cardType: z.string().optional(),
-	category: z.string().optional(),
-	content: z.string().default(""),
-	createdAt: timestampSchema.optional(),
-	extra: z.string().optional(),
-	id: z.string().min(1),
-	keywords: z.array(z.string()).default([]),
-	knowledgeId: z.string().optional(),
-	language: z.string().optional(),
-	links: z.array(cardLinkSchema).default([]),
-	notebookId: z.string().optional(),
-	orgId: z.string().optional(),
-	repo: z.string().optional(),
-	score: z.number().optional(),
-	source: z.string().optional(),
-	title: z.string().default(""),
-	updatedAt: timestampSchema.optional()
-});
-const cardCategoryCountSchema = z.object({
-	category: z.string(),
-	count: z.number().int().nonnegative()
-});
-const cardLanguageCountSchema = z.object({
-	count: z.number().int().nonnegative(),
-	language: z.string()
-});
-const cardAppliedFiltersSchema = z.object({
-	branch: z.string().optional(),
-	category: z.string().optional(),
-	language: z.string().optional(),
-	query: z.string().optional(),
-	repo: z.string().optional(),
-	source: z.string().optional()
-});
-const cardListSchema = z.object({
-	appliedFilters: cardAppliedFiltersSchema.optional(),
-	cards: z.array(cardSchema).nullish().transform((cards) => cards ?? []),
-	categoryCounts: z.array(cardCategoryCountSchema).nullish().transform((counts) => counts ?? []),
-	currentPage: wirePageNumberSchema,
-	languageCounts: z.array(cardLanguageCountSchema).nullish().transform((counts) => counts ?? []),
-	pageSize: wirePageNumberSchema,
-	totalSize: z.number().int().nonnegative().default(0)
-});
-const sourcePageInfoSchema = z.object({
-	currentPage: wirePageNumberSchema,
-	lastPage: wirePageNumberSchema,
-	nextPage: wirePageNumberSchema,
-	nextToken: z.string().optional(),
-	pageSize: wirePageNumberSchema,
-	prevPage: wirePageNumberSchema,
-	totalSize: z.number().int().nonnegative().optional()
-});
-const sourceSchema = z.object({
-	childrenCount: z.number().int().nonnegative().optional(),
-	createdAt: timestampSchema.optional(),
-	errorMessage: z.string().default(""),
-	filename: z.string().optional(),
-	hasChildren: z.boolean().optional(),
-	id: z.string().min(1),
-	isDir: z.boolean().default(false),
-	metadata: z.record(z.string(), z.unknown()).nullable().optional(),
-	mimeType: z.string().optional(),
-	name: z.string().optional(),
-	notebookId: z.string().default(""),
-	orgId: z.string().default(""),
-	originUrl: z.string().optional(),
-	parentSourceId: z.string().default(""),
-	path: z.string().default(""),
-	sourceType: z.string().default(""),
-	size: z.number().int().nonnegative().optional(),
-	status: z.string().default(""),
-	title: z.string().default(""),
-	updatedAt: timestampSchema.optional(),
-	uri: z.string().default(""),
-	userId: z.string().default("")
-});
-const sourceListSchema = z.object({
-	currentPage: wirePageNumberSchema,
-	pageSize: wirePageNumberSchema,
-	pages: sourcePageInfoSchema.optional(),
-	sources: z.array(sourceSchema).nullish().transform((sources) => sources ?? []),
-	totalSize: z.number().int().nonnegative().optional()
-});
-const sourceTreeNodeSchema = z.lazy(() => z.object({
-	files: z.array(sourceTreeNodeSchema).default([]),
-	id: z.string().min(1),
-	name: z.string().default(""),
-	path: z.string().default(""),
-	sourceType: z.string().default(""),
-	status: z.string().default(""),
-	type: z.enum(["file", "directory"])
-}));
-const sourceTreeSchema = z.object({
-	totalSize: z.number().int().nonnegative().default(0),
-	tree: z.array(sourceTreeNodeSchema)
-});
-const sourceContentSchema = z.object({
-	content: z.string(),
-	contentType: z.string().default("text/markdown"),
-	size: z.number().int().nonnegative().optional(),
-	sourceId: z.string().default("")
-});
-const sourceImportResultSchema = z.object({
-	error: z.string().optional(),
-	source: sourceSchema.optional(),
-	url: z.string().default("")
-});
-const sourceImportResultsSchema = z.object({ results: z.array(sourceImportResultSchema) }).transform((value) => value.results);
-const batchMutationResultSchema = z.object({
-	failureCount: z.number().int().nonnegative().default(0),
-	successCount: z.number().int().nonnegative().default(0)
-});
-const voidResponseSchema = z.unknown().transform(() => void 0);
-const httpsUrlSchema = z.string().url().refine((value) => new URL(value).protocol === "https:", "expected an HTTPS URL");
-const imageUploadTicketSchema = z.object({
-	expiresAt: z.string().optional(),
-	headers: z.record(z.string(), z.string()).default({}),
-	method: z.literal("PUT").default("PUT"),
-	ossKey: z.string().min(1),
-	uploadUrl: httpsUrlSchema
-});
-const imageUrlsSchema = z.object({
-	expiresAt: z.string().optional(),
-	urls: z.record(z.string(), httpsUrlSchema)
-});
-const notebookCitationSchema = z.preprocess((value) => isRecord$4(value) ? {
-	...value,
-	chunkId: value.chunkId ?? value.chunk_id,
-	chunkIndex: value.chunkIndex ?? value.chunk_index,
-	originUrl: value.originUrl ?? value.origin_url,
-	sourceId: value.sourceId ?? value.source_id,
-	sourceTitle: value.sourceTitle ?? value.source_title,
-	sourceUri: value.sourceUri ?? value.source_uri
-} : value, z.object({
-	chunkId: z.string().default(""),
-	chunkIndex: z.number().int().nonnegative().default(0),
-	metadata: z.record(z.string(), z.unknown()).optional(),
-	originUrl: z.string().optional(),
-	snippet: z.string().default(""),
-	sourceId: z.string().default(""),
-	sourceTitle: z.string().default(""),
-	sourceUri: z.string().default("")
-}));
-const chatMessageSchema = z.object({
-	chatSessionId: z.string().optional(),
-	citations: z.array(notebookCitationSchema).nullish().transform((citations) => citations === null ? [] : citations),
-	content: z.string().default(""),
-	createdAt: timestampSchema.optional(),
-	id: z.string().min(1),
-	metadata: z.record(z.string(), z.unknown()).optional(),
-	model: z.string().optional(),
-	notebookId: z.string().optional(),
-	orgId: z.string().optional(),
-	role: z.string().default(""),
-	sceneType: z.string().optional(),
-	sequence: z.number().int().nonnegative().optional(),
-	updatedAt: timestampSchema.optional(),
-	userId: z.string().optional()
-});
-const streamWireEventSchema = z.object({
-	assistantMessage: chatMessageSchema.optional(),
-	assistantMessageId: z.string().optional(),
-	cancelReason: z.string().optional(),
-	canceled: z.boolean().optional(),
-	citations: z.array(z.string()).optional(),
-	delta: z.string().optional(),
-	errorMessage: z.string().optional(),
-	error: z.string().optional(),
-	eventType: z.string().optional(),
-	event_type: z.string().optional(),
-	metadata: z.record(z.string(), z.string()).optional(),
-	promptContext: z.string().optional(),
-	reranked: z.boolean().optional(),
-	step: z.number().int().optional(),
-	toolArguments: z.string().optional(),
-	toolDisplayName: z.string().optional(),
-	toolName: z.string().optional(),
-	toolResult: z.string().optional(),
-	totalContextChunks: z.number().int().nonnegative().optional(),
-	type: z.string().optional(),
-	userMessage: chatMessageSchema.optional()
-});
-const sourceUploadTicketSchema = z.object({
-	expiresAt: z.string().optional(),
-	headers: z.record(z.string(), z.string()).default({}),
-	method: z.literal("PUT").default("PUT"),
-	uploadUrl: httpsUrlSchema,
-	uri: z.string().min(1)
-});
-const chatSessionSchema = z.object({
-	createdAt: timestampSchema.optional(),
-	id: z.string().min(1),
-	metadata: z.record(z.string(), z.unknown()).optional(),
-	modelOverride: z.string().default(""),
-	notebookId: z.string().default(""),
-	orgId: z.string().default(""),
-	sceneType: z.string().default("rag"),
-	status: z.string().default("active"),
-	title: z.string().default(""),
-	updatedAt: timestampSchema.optional(),
-	userId: z.string().default("")
-});
-const notebookContextChunkSchema = z.object({
-	chunkId: z.string().default(""),
-	chunkIndex: z.number().int().nonnegative().default(0),
-	content: z.string().default(""),
-	metadata: z.record(z.string(), z.unknown()).optional(),
-	originUrl: z.string().optional(),
-	score: z.number().finite().default(0),
-	sourceId: z.string().default(""),
-	sourceTitle: z.string().default(""),
-	sourceUri: z.string().default(""),
-	tokenCount: z.number().int().nonnegative().default(0)
-});
-const retrievedCardLinkSchema = z.object({
-	description: z.string().optional(),
-	linkType: z.string().default(""),
-	targetId: z.string().min(1),
-	targetTitle: z.string().optional()
-});
-const retrievedCardSchema = z.object({
-	cardType: z.string().optional(),
-	category: z.string().optional(),
-	content: z.string().default(""),
-	depth: z.number().int().nonnegative().default(0),
-	id: z.string().min(1),
-	keywords: z.array(z.string()).default([]),
-	links: z.array(retrievedCardLinkSchema).default([]),
-	score: z.number().finite().default(0),
-	title: z.string().default("")
-});
-const retrieveResultSchema = z.object({
-	cards: z.array(retrievedCardSchema).default([]),
-	chunks: z.array(notebookContextChunkSchema).default([]),
-	citations: z.array(notebookCitationSchema).default([]),
-	promptContext: z.string().default(""),
-	reranked: z.boolean().default(false),
-	total: z.number().int().nonnegative().default(0)
-});
-const cancelQuestionResultSchema = z.object({ accepted: z.boolean() });
-const taskRunSchema = z.object({
-	assistantMessageId: z.string().optional(),
-	chatSessionId: z.string().optional(),
-	config: z.record(z.string(), z.unknown()).optional(),
-	createdAt: timestampSchema.optional(),
-	durationMs: z.number().int().nonnegative().optional(),
-	errorMessage: z.string().optional(),
-	finishedAt: timestampSchema.optional(),
-	id: z.string().min(1),
-	message: chatMessageSchema.optional(),
-	notebookId: z.string().default(""),
-	orgId: z.string().default(""),
-	parentRunId: z.string().optional(),
-	reportMarkdown: z.string().optional(),
-	sceneType: z.string().default(""),
-	scheduledTaskId: z.string().optional(),
-	sourceId: z.string().optional(),
-	startedAt: timestampSchema.optional(),
-	stats: z.record(z.string(), z.unknown()).optional(),
-	status: z.string().default(""),
-	trigger: z.string().default(""),
-	updatedAt: timestampSchema.optional(),
-	userId: z.string().default("")
-}).transform((value) => ({
-	...value,
-	rawStatus: value.status,
-	status: normalizeQMindTaskRunStatus(value.status)
-}));
-const taskRunListSchema = z.object({
-	currentPage: wirePageNumberSchema,
-	pageSize: wirePageNumberSchema,
-	runs: z.array(taskRunSchema).nullish().transform((runs) => runs ?? []),
-	totalSize: z.number().int().nonnegative().default(0)
-});
-//#endregion
-//#region ../sdk/src/operations/shared.ts
-function invalidArgument$1(message, field, details) {
-	return new QMindError("INVALID_ARGUMENT", message, { details: details ?? { field } });
-}
-function requiredString$2(value, field) {
-	if (typeof value !== "string" || value.trim().length === 0) throw invalidArgument$1(`${field} must be a non-empty string`, field);
-	return value.trim();
-}
-function optionalString$1(value, field) {
-	if (value === void 0) return void 0;
-	if (typeof value !== "string") throw invalidArgument$1(`${field} must be a string`, field);
-	return value;
-}
-function optionalTrimmedString(value, field) {
-	const string = optionalString$1(value, field)?.trim();
-	return string === "" ? void 0 : string;
-}
-function optionalRecord(value, field) {
-	if (value === void 0) return void 0;
-	if (typeof value !== "object" || value === null || Array.isArray(value)) throw invalidArgument$1(`${field} must be an object`, field);
-	return value;
-}
-function optionalBoolean(value, field) {
-	if (value === void 0) return void 0;
-	if (typeof value !== "boolean") throw invalidArgument$1(`${field} must be a boolean`, field);
-	return value;
-}
-function positiveInteger$1(value, field) {
-	if (value === void 0) return void 0;
-	if (typeof value !== "number" || !Number.isInteger(value) || value <= 0) throw invalidArgument$1(`${field} must be a positive integer`, field);
-	return value;
-}
-function nonNegativeInteger$1(value, field) {
-	if (value === void 0) return void 0;
-	if (typeof value !== "number" || !Number.isInteger(value) || value < 0) throw invalidArgument$1(`${field} must be a non-negative integer`, field);
-	return value;
-}
-function pagination$1(input) {
-	const page = positiveInteger$1(input.page, "page");
-	const pageSize = positiveInteger$1(input.pageSize, "pageSize");
-	return {
-		...page === void 0 ? {} : { page },
-		...pageSize === void 0 ? {} : { pageSize }
-	};
-}
-function stringList(value, field, options = {}) {
-	if (!Array.isArray(value)) throw invalidArgument$1(`${field} must be an array`, field);
-	const result = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (const item of value) {
-		if (typeof item !== "string") throw invalidArgument$1(`${field} must contain only strings`, field);
-		const normalized = item.trim();
-		if (normalized.length === 0 || seen.has(normalized)) continue;
-		seen.add(normalized);
-		result.push(normalized);
-	}
-	if (options.min !== void 0 && result.length < options.min) throw invalidArgument$1(`${field} must contain at least ${options.min} item(s)`, field);
-	if (options.max !== void 0 && result.length > options.max) throw invalidArgument$1(`${field} must contain at most ${options.max} item(s)`, field);
-	return result;
-}
-function httpUrl(value, field) {
-	const raw = requiredString$2(value, field);
-	let url;
-	try {
-		url = new URL(raw);
-	} catch (cause) {
-		throw invalidArgument$1(`${field} must be a valid HTTP(S) URL`, field, {
-			cause,
-			field
-		});
-	}
-	if (url.protocol !== "http:" && url.protocol !== "https:" || url.host.length === 0) throw invalidArgument$1(`${field} must be a valid HTTP(S) URL`, field);
-	url.hash = "";
-	return url.toString();
-}
-function compactUndefined(value) {
-	return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== void 0));
-}
-function assertNonEmptyPatch(patch, field) {
-	if (Object.keys(patch).length > 0) return;
-	throw invalidArgument$1(`${field} must contain at least one change`, field);
-}
-function queryPath(path, entries) {
-	const query = new URLSearchParams();
-	for (const [key, value] of entries) if (value !== void 0 && value !== "") query.set(key, String(value));
-	const suffix = query.toString();
-	return suffix.length === 0 ? path : `${path}?${suffix}`;
-}
-function wireRequest(options) {
-	const timeoutMs = options.callOptions?.timeoutMs;
-	if (timeoutMs !== void 0 && (!Number.isFinite(timeoutMs) || timeoutMs <= 0)) throw invalidArgument$1("timeoutMs must be a positive finite number", "timeoutMs");
-	return {
-		...options.body === void 0 ? {} : { body: {
-			kind: "json",
-			value: options.body
-		} },
-		destination: {
-			kind: "host",
-			path: options.path
-		},
-		idempotent: options.idempotent,
-		method: options.method,
-		...options.callOptions?.signal === void 0 ? {} : { signal: options.callOptions.signal },
-		...timeoutMs === void 0 ? {} : { timeoutMs }
-	};
-}
-function call(context, options) {
-	return executeUnary({
-		capability: options.capability,
-		operation: options.operation,
-		profile: context.profile,
-		request: wireRequest(options),
-		schema: options.schema,
-		transport: context.transport
-	});
-}
-//#endregion
 //#region ../sdk/src/operations/agents.ts
 const workflowPrompt = "Follow the system prompt strictly: use the provided tools to discover, process and prepare the result, then emit the final report. Do NOT greet, do NOT ask for clarification — act immediately.";
 function isRecord$3(value) {
@@ -931,25 +159,27 @@ function streamCallOptions(options) {
 	};
 }
 function createAgentOperations(context) {
-	const createChatSession = (notebookId, input, options) => {
+	const createChatSessionFor = (notebookId, input, options, featured) => {
 		const notebook = requiredString$2(notebookId, "notebookId");
 		return call(context, {
 			body: chatSessionBody(input),
 			callOptions: options,
-			capability: "chat",
+			capability: featured ? "featuredNotebooks.read" : "chat",
 			idempotent: false,
 			method: "POST",
-			operation: "chatSessions.create",
-			path: context.profile.apiPath("notebooks", notebook, "chat-sessions"),
+			operation: featured ? "featuredChatSessions.create" : "chatSessions.create",
+			path: context.profile.apiPath(featured ? "featured-notebooks" : "notebooks", notebook, "chat-sessions"),
 			schema: chatSessionSchema
 		});
 	};
-	const streamQuestion = (notebookId, sessionId, input, options) => {
+	const createChatSession = (notebookId, input, options) => createChatSessionFor(notebookId, input, options, false);
+	const createFeaturedChatSession = (notebookId, input, options) => createChatSessionFor(notebookId, input, options, true);
+	const streamQuestionFor = (notebookId, sessionId, input, options, featured) => {
 		const notebook = requiredString$2(notebookId, "notebookId");
 		const session = requiredString$2(sessionId, "sessionId");
 		return executeStream({
-			capability: "chat",
-			operation: "chat.stream",
+			capability: featured ? "featuredNotebooks.read" : "chat",
+			operation: featured ? "featuredChat.stream" : "chat.stream",
 			profile: context.profile,
 			request: {
 				body: {
@@ -958,7 +188,7 @@ function createAgentOperations(context) {
 				},
 				destination: {
 					kind: "host",
-					path: queryPath(context.profile.apiPath("notebooks", notebook, "chat-sessions", session, "messages", "stream"), [["client", context.client]])
+					path: queryPath(context.profile.apiPath(featured ? "featured-notebooks" : "notebooks", notebook, "chat-sessions", session, "messages", "stream"), [["client", context.client]])
 				},
 				idempotent: false,
 				method: "POST",
@@ -967,23 +197,94 @@ function createAgentOperations(context) {
 			transport: context.transport
 		});
 	};
+	const streamQuestion = (notebookId, sessionId, input, options) => streamQuestionFor(notebookId, sessionId, input, options, false);
+	const streamFeaturedQuestion = (notebookId, sessionId, input, options) => streamQuestionFor(notebookId, sessionId, input, options, true);
+	const cancelQuestionFor = (notebookId, sessionId, input = {}, options, featured = false) => {
+		const notebook = requiredString$2(notebookId, "notebookId");
+		const session = requiredString$2(sessionId, "sessionId");
+		if (!isRecord$3(input)) throw invalidArgument$1("input must be an object", "input");
+		return call(context, {
+			body: compactUndefined({ reason: optionalTrimmedString(input.reason, "reason") }),
+			callOptions: options,
+			capability: featured ? "featuredNotebooks.read" : "chat",
+			idempotent: false,
+			method: "POST",
+			operation: featured ? "featuredChat.cancel" : "chat.cancel",
+			path: context.profile.apiPath(featured ? "featured-notebooks" : "notebooks", notebook, "chat-sessions", session, "messages", "cancel"),
+			schema: cancelQuestionResultSchema
+		});
+	};
+	const listChatSessionsFor = (notebookId, input = {}, options, featured = false) => {
+		const notebook = requiredString$2(notebookId, "notebookId");
+		const normalizedPage = pagination$1({
+			page: input.page ?? 1,
+			pageSize: input.pageSize ?? 20
+		});
+		return call(context, {
+			callOptions: options,
+			capability: featured ? "featuredNotebooks.read" : "chat",
+			idempotent: true,
+			method: "GET",
+			operation: featured ? "featuredChatSessions.list" : "chatSessions.list",
+			path: queryPath(context.profile.apiPath(featured ? "featured-notebooks" : "notebooks", notebook, "chat-sessions"), [["page", normalizedPage.page], ["page_size", normalizedPage.pageSize]]),
+			schema: chatSessionListSchema
+		});
+	};
+	const listChatMessagesFor = (notebookId, sessionId, input = {}, options, featured = false) => {
+		const notebook = requiredString$2(notebookId, "notebookId");
+		const session = requiredString$2(sessionId, "sessionId");
+		const normalizedPage = pagination$1({
+			page: input.page ?? 1,
+			pageSize: input.pageSize ?? 100
+		});
+		return call(context, {
+			callOptions: options,
+			capability: featured ? "featuredNotebooks.read" : "chat",
+			idempotent: true,
+			method: "GET",
+			operation: featured ? "featuredChatMessages.list" : "chatMessages.list",
+			path: queryPath(context.profile.apiPath(featured ? "featured-notebooks" : "notebooks", notebook, "chat-sessions", session, "messages"), [["page", normalizedPage.page], ["page_size", normalizedPage.pageSize]]),
+			schema: chatMessageListSchema
+		});
+	};
+	const deleteChatSessionFor = (notebookId, sessionId, options, featured = false) => {
+		const notebook = requiredString$2(notebookId, "notebookId");
+		const session = requiredString$2(sessionId, "sessionId");
+		return call(context, {
+			callOptions: options,
+			capability: featured ? "featuredNotebooks.read" : "chat",
+			idempotent: false,
+			method: "DELETE",
+			operation: featured ? "featuredChatSessions.delete" : "chatSessions.delete",
+			path: context.profile.apiPath(featured ? "featured-notebooks" : "notebooks", notebook, "chat-sessions", session),
+			schema: voidResponseSchema
+		});
+	};
+	const startAgentRunFor = async (notebookId, input, options, featured) => {
+		if (!isRecord$3(input)) throw invalidArgument$1("input must be an object", "input");
+		if (input.scene !== "rag" && input.scene !== "compilation" && input.scene !== "lint") throw invalidArgument$1("scene must be rag, compilation or lint", "scene");
+		const notebook = requiredString$2(notebookId, "notebookId");
+		const scene = input.scene;
+		const modelOverride = optionalTrimmedString(input.modelOverride, "modelOverride");
+		const title = optionalString$1(input.title, "title");
+		const session = await (featured ? createFeaturedChatSession : createChatSession)(notebook, {
+			...modelOverride === void 0 ? {} : { modelOverride },
+			sceneType: scene,
+			...title === void 0 ? {} : { title }
+		}, options);
+		return {
+			events: (featured ? streamFeaturedQuestion : streamQuestion)(notebook, session.id, agentContent(input), options),
+			scene,
+			session
+		};
+	};
 	return {
-		async cancelQuestion(notebookId, sessionId, input = {}, options) {
-			const notebook = requiredString$2(notebookId, "notebookId");
-			const session = requiredString$2(sessionId, "sessionId");
-			if (!isRecord$3(input)) throw invalidArgument$1("input must be an object", "input");
-			return call(context, {
-				body: compactUndefined({ reason: optionalTrimmedString(input.reason, "reason") }),
-				callOptions: options,
-				capability: "chat",
-				idempotent: false,
-				method: "POST",
-				operation: "chat.cancel",
-				path: context.profile.apiPath("notebooks", notebook, "chat-sessions", session, "messages", "cancel"),
-				schema: cancelQuestionResultSchema
-			});
-		},
+		cancelFeaturedQuestion: (notebookId, sessionId, input, options) => cancelQuestionFor(notebookId, sessionId, input, options, true),
+		cancelQuestion: (notebookId, sessionId, input, options) => cancelQuestionFor(notebookId, sessionId, input, options),
 		createChatSession,
+		createFeaturedChatSession,
+		deleteChatSession: (notebookId, sessionId, options) => deleteChatSessionFor(notebookId, sessionId, options),
+		deleteFeaturedChatSession: (notebookId, sessionId, options) => deleteChatSessionFor(notebookId, sessionId, options, true),
 		async createTaskRun(notebookId, input, options) {
 			const notebook = requiredString$2(notebookId, "notebookId");
 			return call(context, {
@@ -1011,16 +312,21 @@ function createAgentOperations(context) {
 			});
 		},
 		async listTaskRuns(notebookId, input, options) {
+			const notebook = requiredString$2(notebookId, "notebookId");
 			return call(context, {
 				callOptions: options,
 				capability: "taskRuns.read",
 				idempotent: true,
 				method: "GET",
 				operation: "taskRuns.list",
-				path: taskRunListPath(context, requiredString$2(notebookId, "notebookId"), input),
+				path: taskRunListPath(context, notebook, input),
 				schema: taskRunListSchema
 			});
 		},
+		listChatMessages: (notebookId, sessionId, input, options) => listChatMessagesFor(notebookId, sessionId, input, options),
+		listChatSessions: (notebookId, input, options) => listChatSessionsFor(notebookId, input, options),
+		listFeaturedChatMessages: (notebookId, sessionId, input, options) => listChatMessagesFor(notebookId, sessionId, input, options, true),
+		listFeaturedChatSessions: (notebookId, input, options) => listChatSessionsFor(notebookId, input, options, true),
 		async retrieve(notebookId, input, options) {
 			const notebook = requiredString$2(notebookId, "notebookId");
 			return call(context, {
@@ -1034,93 +340,13 @@ function createAgentOperations(context) {
 				schema: retrieveResultSchema
 			});
 		},
-		async startAgentRun(notebookId, input, options) {
-			if (!isRecord$3(input)) throw invalidArgument$1("input must be an object", "input");
-			if (input.scene !== "rag" && input.scene !== "compilation" && input.scene !== "lint") throw invalidArgument$1("scene must be rag, compilation or lint", "scene");
-			const notebook = requiredString$2(notebookId, "notebookId");
-			const scene = input.scene;
-			const modelOverride = optionalTrimmedString(input.modelOverride, "modelOverride");
-			const title = optionalString$1(input.title, "title");
-			const session = await createChatSession(notebook, {
-				...modelOverride === void 0 ? {} : { modelOverride },
-				sceneType: scene,
-				...title === void 0 ? {} : { title }
-			}, options);
-			return {
-				events: streamQuestion(notebook, session.id, agentContent(input), options),
-				scene,
-				session
-			};
-		},
+		startAgentRun: (notebookId, input, options) => startAgentRunFor(notebookId, input, options, false),
+		startFeaturedAgentRun: (notebookId, input, options) => startAgentRunFor(notebookId, input, options, true),
+		streamFeaturedQuestion,
 		streamQuestion
 	};
 }
 //#endregion
-//#region ../sdk/src/operations/cards.ts
-function createCardOperations(context) {
-	return {
-		async batchDeleteCards(notebookId, cardIds, options) {
-			const notebook = requiredString$2(notebookId, "notebookId");
-			return call(context, {
-				body: { cardIds: stringList(cardIds, "cardIds", { min: 1 }) },
-				callOptions: options,
-				capability: "cards.write",
-				idempotent: false,
-				method: "POST",
-				operation: "cards.batchDelete",
-				path: context.profile.apiPath("notebooks", notebook, "cards", "batch-delete"),
-				schema: batchMutationResultSchema
-			});
-		},
-		async deleteCard(notebookId, cardId, options) {
-			const notebook = requiredString$2(notebookId, "notebookId");
-			const card = requiredString$2(cardId, "cardId");
-			return call(context, {
-				callOptions: options,
-				capability: "cards.write",
-				idempotent: false,
-				method: "DELETE",
-				operation: "cards.delete",
-				path: context.profile.apiPath("notebooks", notebook, "cards", card),
-				schema: batchMutationResultSchema
-			});
-		},
-		async getCard(notebookId, cardId, options) {
-			const notebook = requiredString$2(notebookId, "notebookId");
-			const card = requiredString$2(cardId, "cardId");
-			return call(context, {
-				callOptions: options,
-				capability: "cards.read",
-				idempotent: true,
-				method: "GET",
-				operation: "cards.get",
-				path: context.profile.apiPath("notebooks", notebook, "cards", card),
-				schema: cardSchema
-			});
-		},
-		async listCards(notebookId, input = {}, options) {
-			const notebook = requiredString$2(notebookId, "notebookId");
-			const normalizedPage = pagination$1(input);
-			const category = optionalTrimmedString(input.category, "category");
-			const query = optionalTrimmedString(input.query, "query");
-			return call(context, {
-				callOptions: options,
-				capability: "cards.read",
-				idempotent: true,
-				method: "GET",
-				operation: "cards.list",
-				path: queryPath(context.profile.apiPath("notebooks", notebook, "cards"), [
-					["category", category],
-					["query", query],
-					["page", normalizedPage.page],
-					["page_size", normalizedPage.pageSize]
-				]),
-				schema: cardListSchema
-			});
-		}
-	};
-}
-//#endregion
 //#region ../sdk/src/operations/notebooks.ts
 function createNotebookOperations(context) {
 	return {
@@ -1168,6 +394,30 @@ function createNotebookOperations(context) {
 				schema: notebookSchema
 			});
 		},
+		async getFeaturedNotebook(notebookId, options) {
+			const id = requiredString$2(notebookId, "notebookId");
+			return call(context, {
+				callOptions: options,
+				capability: "featuredNotebooks.read",
+				idempotent: true,
+				method: "GET",
+				operation: "featuredNotebooks.get",
+				path: context.profile.featuredNotebookPath(id),
+				schema: notebookSchema
+			});
+		},
+		async listFeaturedNotebooks(input = {}, options) {
+			const normalized = pagination$1(input);
+			return call(context, {
+				callOptions: options,
+				capability: "featuredNotebooks.read",
+				idempotent: true,
+				method: "GET",
+				operation: "featuredNotebooks.list",
+				path: context.profile.listFeaturedNotebooksPath(normalized),
+				schema: notebookListSchema
+			});
+		},
 		async listNotebooks(input = {}, options) {
 			const normalizedPage = pagination$1(input);
 			const client = optionalTrimmedString(input.client, "client");
@@ -1186,6 +436,18 @@ function createNotebookOperations(context) {
 				schema: notebookListSchema
 			});
 		},
+		async listSharedNotebooks(input = {}, options) {
+			const normalized = pagination$1(input);
+			return call(context, {
+				callOptions: options,
+				capability: "sharedNotebooks.read",
+				idempotent: true,
+				method: "GET",
+				operation: "sharedNotebooks.list",
+				path: context.profile.listSharedNotebooksPath(normalized),
+				schema: sharedNotebookListSchema
+			});
+		},
 		async listWikiBranches(notebookId, options) {
 			const id = requiredString$2(notebookId, "notebookId");
 			return (await call(context, {
@@ -1246,6 +508,7 @@ function createsSourceCycle(source, sourcesById) {
 }
 function buildSourceTree(sources) {
 	const sourcesById = new Map(sources.map((source) => [source.id, source]));
+	const parentIds = new Set(sources.filter((source) => sourcesById.has(source.parentSourceId) && !createsSourceCycle(source, sourcesById)).map((source) => source.parentSourceId));
 	const nodesById = /* @__PURE__ */ new Map();
 	for (const source of sources) nodesById.set(source.id, {
 		files: [],
@@ -1254,7 +517,7 @@ function buildSourceTree(sources) {
 		path: source.path,
 		sourceType: source.sourceType,
 		status: source.status,
-		type: source.isDir ? "directory" : "file"
+		type: source.isDir || parentIds.has(source.id) ? "directory" : "file"
 	});
 	const tree = [];
 	for (const source of sources) {
@@ -1304,9 +567,10 @@ function siteBody(input) {
 	const includePaths = stringList(input?.includePaths ?? [], "includePaths");
 	const excludePaths = stringList(input?.excludePaths ?? [], "excludePaths");
 	const sitemap = optionalTrimmedString(input?.sitemapUrl, "sitemapUrl");
+	const compileAfterRefresh = optionalBoolean(input?.compileAfterRefresh, "compileAfterRefresh");
 	return compactUndefined({
 		config: compactUndefined({
-			compileAfterRefresh: optionalBoolean(input?.compileAfterRefresh, "compileAfterRefresh"),
+			compileAfterRefresh,
 			excludePaths,
 			includePaths,
 			maxPages,
@@ -1358,24 +622,49 @@ function createSourceOperations(context) {
 		if (view === "children") assertCapability(context.profile, "sources.children", "sources.list");
 		if (query !== void 0) assertCapability(context.profile, "sources.search", "sources.list");
 		if (parentSourceId !== void 0 && view !== "children") throw invalidArgument$1("parentSourceId requires view=\"children\"", "parentSourceId");
+		const path = queryPath(context.profile.apiPath("notebooks", notebook, "sources"), [
+			["view", view === "list" ? void 0 : view],
+			["is_dir", isDir === void 0 ? void 0 : String(isDir)],
+			["parent_source_id", parentSourceId],
+			["page", normalizedPage.page],
+			["page_size", normalizedPage.pageSize],
+			["query", query]
+		]);
 		return call(context, {
 			callOptions: options,
 			capability: "sources.read",
 			idempotent: true,
 			method: "GET",
 			operation,
-			path: queryPath(context.profile.apiPath("notebooks", notebook, "sources"), [
+			path,
+			schema: sourceListSchema
+		});
+	};
+	const listSources = (notebookId, input, options) => readSourcePage(notebookId, input, options);
+	const listFeaturedSources = async (notebookId, input = {}, options) => {
+		const notebook = requiredString$2(notebookId, "notebookId");
+		const normalizedPage = pagination$1({
+			page: input.page ?? 1,
+			pageSize: input.pageSize ?? 200
+		});
+		const parentSourceId = optionalString$1(input.parentSourceId, "parentSourceId");
+		const view = input.view ?? "list";
+		if (view !== "list" && view !== "children") throw invalidArgument$1("view must be either \"list\" or \"children\"", "view");
+		return call(context, {
+			callOptions: options,
+			capability: "featuredNotebooks.read",
+			idempotent: true,
+			method: "GET",
+			operation: "featuredSources.list",
+			path: queryPath(context.profile.apiPath("featured-notebooks", notebook, "sources"), [
 				["view", view === "list" ? void 0 : view],
-				["is_dir", isDir === void 0 ? void 0 : String(isDir)],
 				["parent_source_id", parentSourceId],
 				["page", normalizedPage.page],
-				["page_size", normalizedPage.pageSize],
-				["query", query]
+				["page_size", normalizedPage.pageSize]
 			]),
 			schema: sourceListSchema
 		});
 	};
-	const listSources = (notebookId, input, options) => readSourcePage(notebookId, input, options);
 	const collectAllSources = async (notebookId, input = {}, options, operation) => {
 		const notebook = requiredString$2(notebookId, "notebookId");
 		const pageSize = positiveInteger$1(input.pageSize, "pageSize") ?? 200;
@@ -1418,8 +707,9 @@ function createSourceOperations(context) {
 	return {
 		async batchDeleteSources(notebookId, sourceIds, options) {
 			const notebook = requiredString$2(notebookId, "notebookId");
+			const ids = stringList(sourceIds, "sourceIds", { min: 1 });
 			return call(context, {
-				body: { sourceIds: stringList(sourceIds, "sourceIds", { min: 1 }) },
+				body: { sourceIds: ids },
 				callOptions: options,
 				capability: "sources.write",
 				idempotent: false,
@@ -1429,28 +719,114 @@ function createSourceOperations(context) {
 				schema: batchMutationResultSchema
 			});
 		},
-		async createDirectory(notebookId, input, options) {
-			const title = requiredString$2(input?.title, "title");
-			return createSource(notebookId, {
-				isDir: true,
-				parentSourceId: input?.parentSourceId,
-				path: input?.path,
-				status: "ready",
-				title
-			}, options);
-		},
-		createSource,
-		async deleteSource(notebookId, sourceId, options) {
+		async countSourceChildren(notebookId, parentIds, options) {
+			const notebook = requiredString$2(notebookId, "notebookId");
+			const ids = stringList(parentIds, "parentIds", {
+				max: 200,
+				min: 1
+			});
+			assertCapability(context.profile, "sources.childrenCount", "sources.childrenCount");
+			const path = context.profile.mindPath("notebooks", notebook, "sources", "children-count");
+			const query = new URLSearchParams();
+			for (const id of ids) query.append("parent_ids", id);
+			return call(context, {
+				callOptions: options,
+				capability: "sources.childrenCount",
+				idempotent: true,
+				method: "GET",
+				operation: "sources.childrenCount",
+				path: `${path}?${query.toString()}`,
+				schema: sourceChildrenCountsSchema
+			});
+		},
+		async createDirectory(notebookId, input, options) {
+			const title = requiredString$2(input?.title, "title");
+			return createSource(notebookId, {
+				isDir: true,
+				parentSourceId: input?.parentSourceId,
+				path: input?.path,
+				status: "ready",
+				title
+			}, options);
+		},
+		createSource,
+		async createSourceWebOfficeSession(notebookId, sourceId, options) {
+			const notebook = requiredString$2(notebookId, "notebookId");
+			const source = requiredString$2(sourceId, "sourceId");
+			assertCapability(context.profile, "sources.webOffice", "sources.webOffice.create");
+			return call(context, {
+				callOptions: options,
+				capability: "sources.webOffice",
+				idempotent: false,
+				method: "POST",
+				operation: "sources.webOffice.create",
+				path: context.profile.apiPath("notebooks", notebook, "sources", source, "weboffice", "session"),
+				schema: sourceWebOfficeSessionSchema
+			});
+		},
+		async deleteSource(notebookId, sourceId, options) {
+			const notebook = requiredString$2(notebookId, "notebookId");
+			const source = requiredString$2(sourceId, "sourceId");
+			return call(context, {
+				callOptions: options,
+				capability: "sources.write",
+				idempotent: false,
+				method: "DELETE",
+				operation: "sources.delete",
+				path: context.profile.apiPath("notebooks", notebook, "sources", source),
+				schema: voidResponseSchema
+			});
+		},
+		async getFeaturedSource(notebookId, sourceId, options) {
+			const notebook = requiredString$2(notebookId, "notebookId");
+			const source = requiredString$2(sourceId, "sourceId");
+			return call(context, {
+				callOptions: options,
+				capability: "featuredNotebooks.read",
+				idempotent: true,
+				method: "GET",
+				operation: "featuredSources.get",
+				path: context.profile.apiPath("featured-notebooks", notebook, "sources", source),
+				schema: sourceSchema
+			});
+		},
+		async getFeaturedSourceContent(notebookId, sourceId, options) {
+			const notebook = requiredString$2(notebookId, "notebookId");
+			const source = requiredString$2(sourceId, "sourceId");
+			return call(context, {
+				callOptions: options,
+				capability: "featuredNotebooks.read",
+				idempotent: true,
+				method: "GET",
+				operation: "featuredSources.content",
+				path: context.profile.apiPath("featured-notebooks", notebook, "sources", source, "content"),
+				schema: sourceContentSchema
+			});
+		},
+		async getFeaturedSourcePreview(notebookId, sourceId, options) {
+			const notebook = requiredString$2(notebookId, "notebookId");
+			const source = requiredString$2(sourceId, "sourceId");
+			return call(context, {
+				callOptions: options,
+				capability: "featuredNotebooks.read",
+				idempotent: true,
+				method: "GET",
+				operation: "featuredSources.preview",
+				path: context.profile.apiPath("featured-notebooks", notebook, "sources", source, "preview"),
+				schema: sourcePreviewSchema
+			});
+		},
+		async getFeaturedSourceRawContent(notebookId, sourceId, options) {
 			const notebook = requiredString$2(notebookId, "notebookId");
 			const source = requiredString$2(sourceId, "sourceId");
 			return call(context, {
 				callOptions: options,
-				capability: "sources.write",
-				idempotent: false,
-				method: "DELETE",
-				operation: "sources.delete",
-				path: context.profile.apiPath("notebooks", notebook, "sources", source),
-				schema: voidResponseSchema
+				capability: "featuredNotebooks.read",
+				idempotent: true,
+				method: "GET",
+				operation: "featuredSources.rawContent",
+				path: context.profile.apiPath("featured-notebooks", notebook, "sources", source, "raw-content"),
+				schema: sourceRawContentSchema
 			});
 		},
 		async getSource(notebookId, sourceId, options) {
@@ -1479,6 +855,60 @@ function createSourceOperations(context) {
 				schema: sourceContentSchema
 			});
 		},
+		async getSourceActionAccess(options) {
+			return call(context, {
+				callOptions: options,
+				capability: "sources.actionAccess",
+				idempotent: true,
+				method: "GET",
+				operation: "sources.actionAccess",
+				path: context.profile.mindPath("source-actions", "access"),
+				schema: sourceActionAccessSchema
+			});
+		},
+		async getSourcePreview(notebookId, sourceId, options) {
+			const notebook = requiredString$2(notebookId, "notebookId");
+			const source = requiredString$2(sourceId, "sourceId");
+			return call(context, {
+				callOptions: options,
+				capability: "sources.preview",
+				idempotent: true,
+				method: "GET",
+				operation: "sources.preview",
+				path: context.profile.apiPath("notebooks", notebook, "sources", source, "preview"),
+				schema: sourcePreviewSchema
+			});
+		},
+		async getSourceRawContent(notebookId, sourceId, options) {
+			const notebook = requiredString$2(notebookId, "notebookId");
+			const source = requiredString$2(sourceId, "sourceId");
+			return call(context, {
+				callOptions: options,
+				capability: "sources.rawContent",
+				idempotent: true,
+				method: "GET",
+				operation: "sources.rawContent",
+				path: context.profile.apiPath("notebooks", notebook, "sources", source, "raw-content"),
+				schema: sourceRawContentSchema
+			});
+		},
+		async getSourceUploadCapabilities(options) {
+			return call(context, {
+				callOptions: options,
+				capability: "sources.write",
+				idempotent: true,
+				method: "GET",
+				operation: "sources.uploadCapabilities",
+				path: context.profile.mindPath("source-upload", "capabilities"),
+				schema: sourceUploadCapabilitiesSchema
+			});
+		},
+		async getFeaturedSourceTree(notebookId, options) {
+			return buildSourceTree((await listFeaturedSources(notebookId, {
+				page: 1,
+				pageSize: 200
+			}, options)).sources);
+		},
 		getSourceTree,
 		async importSite(notebookId, input, options) {
 			const notebook = requiredString$2(notebookId, "notebookId");
@@ -1503,6 +933,7 @@ function createSourceOperations(context) {
 				body: compactUndefined({
 					parentSourceId: optionalString$1(input?.parentSourceId, "parentSourceId"),
 					path: optionalString$1(input?.path, "path"),
+					sourceType: "url",
 					urls
 				}),
 				callOptions: options,
@@ -1514,7 +945,30 @@ function createSourceOperations(context) {
 				schema: sourceImportResultsSchema
 			});
 		},
+		async importWikiDocuments(notebookId, input, options) {
+			const notebook = requiredString$2(notebookId, "notebookId");
+			const urls = stringList(input?.urls ?? [], "urls", {
+				max: 5,
+				min: 1
+			});
+			return call(context, {
+				body: compactUndefined({
+					parentSourceId: optionalString$1(input?.parentSourceId, "parentSourceId"),
+					path: "/repowiki",
+					sourceType: "repowiki",
+					urls
+				}),
+				callOptions: options,
+				capability: "sources.write",
+				idempotent: false,
+				method: "POST",
+				operation: "sources.importWiki",
+				path: context.profile.apiPath("notebooks", notebook, "sources"),
+				schema: sourceImportResultsSchema
+			});
+		},
 		listAllSources,
+		listFeaturedSources,
 		listSources,
 		async moveSource(notebookId, sourceId, input, options) {
 			const parentSourceId = optionalString$1(input?.parentSourceId, "parentSourceId");
@@ -1553,13 +1007,31 @@ function createSourceOperations(context) {
 				schema: imageUploadTicketSchema
 			});
 		},
+		async refreshSourceWebOfficeSession(notebookId, sourceId, input, options) {
+			const notebook = requiredString$2(notebookId, "notebookId");
+			const source = requiredString$2(sourceId, "sourceId");
+			const sessionId = requiredString$2(input?.sessionId, "sessionId");
+			const tokenVersion = nonNegativeInteger$1(input?.tokenVersion, "tokenVersion") ?? 0;
+			assertCapability(context.profile, "sources.webOffice", "sources.webOffice.refresh");
+			return call(context, {
+				body: { tokenVersion },
+				callOptions: options,
+				capability: "sources.webOffice",
+				idempotent: false,
+				method: "POST",
+				operation: "sources.webOffice.refresh",
+				path: context.profile.apiPath("notebooks", notebook, "sources", source, "weboffice", "session", sessionId, "refresh"),
+				schema: sourceWebOfficeTokenSchema
+			});
+		},
 		async presignImageUrls(notebookId, ossKeys, options) {
 			const notebook = requiredString$2(notebookId, "notebookId");
+			const keys = stringList(ossKeys, "ossKeys", {
+				max: 100,
+				min: 1
+			});
 			return call(context, {
-				body: { ossKeys: stringList(ossKeys, "ossKeys", {
-					max: 100,
-					min: 1
-				}) },
+				body: { ossKeys: keys },
 				callOptions: options,
 				capability: "images.presignUrls",
 				idempotent: false,
@@ -1662,12 +1134,14 @@ function transferCall(context, operation, request, schema) {
 	});
 }
 function hostRequest(path, method, idempotent, options, body) {
+	const authorization = options.authorization?.trim();
 	return {
 		body,
 		destination: {
 			kind: "host",
 			path
 		},
+		...authorization === void 0 || authorization.length === 0 ? {} : { headers: { authorization: `Bearer ${authorization}` } },
 		idempotent,
 		method,
 		...requestOptions(options)
@@ -1788,22 +1262,31 @@ const dashboardCapabilities = Object.freeze({
 	"cards.read": true,
 	"cards.write": true,
 	chat: true,
-	"featuredNotebooks.read": false,
+	compilation: true,
+	"featuredNotebooks.read": true,
 	"images.presignUpload": false,
 	"images.presignUrls": false,
-	members: false,
+	"imports.aliDing": true,
+	"imports.discover": true,
+	members: true,
 	"notebooks.filterByClient": false,
 	"notebooks.read": true,
 	"notebooks.write": true,
 	"notes.read": false,
 	"notes.write": false,
 	retrieval: true,
-	scheduledTasks: false,
+	scheduledTasks: true,
+	"sharedNotebooks.read": true,
 	"sources.children": true,
+	"sources.childrenCount": true,
+	"sources.actionAccess": true,
 	"sources.importWeb": true,
+	"sources.preview": true,
+	"sources.rawContent": true,
 	"sources.read": true,
 	"sources.search": true,
 	"sources.tree": true,
+	"sources.webOffice": true,
 	"sources.write": true,
 	"taskRuns.read": true,
 	"taskRuns.write": true,
@@ -1815,9 +1298,12 @@ const sashCapabilities = Object.freeze({
 	"cards.read": true,
 	"cards.write": true,
 	chat: true,
+	compilation: false,
 	"featuredNotebooks.read": false,
 	"images.presignUpload": true,
 	"images.presignUrls": true,
+	"imports.aliDing": false,
+	"imports.discover": false,
 	members: false,
 	"notebooks.filterByClient": true,
 	"notebooks.read": true,
@@ -1826,11 +1312,17 @@ const sashCapabilities = Object.freeze({
 	"notes.write": false,
 	retrieval: true,
 	scheduledTasks: false,
-	"sources.children": false,
-	"sources.importWeb": false,
+	"sharedNotebooks.read": false,
+	"sources.children": true,
+	"sources.childrenCount": false,
+	"sources.actionAccess": true,
+	"sources.importWeb": true,
+	"sources.preview": true,
+	"sources.rawContent": true,
 	"sources.read": true,
 	"sources.search": false,
 	"sources.tree": true,
+	"sources.webOffice": true,
 	"sources.write": true,
 	"taskRuns.read": true,
 	"taskRuns.write": true,
@@ -1993,6 +1485,12 @@ function createProfile(access, apiPrefix) {
 		decodeStreamPayload(payload) {
 			return decodeStreamPayload(access, payload);
 		},
+		featuredNotebookPath(notebookId) {
+			return notebookId === void 0 ? apiPath("featured-notebooks") : apiPath("featured-notebooks", notebookId);
+		},
+		listFeaturedNotebooksPath(input) {
+			return appendQuery(`${apiPrefix}/featured-notebooks`, [["page", input.page], ["page_size", input.pageSize]]);
+		},
 		listNotebooksPath(input) {
 			return appendQuery(`${apiPrefix}/notebooks`, [
 				["page", input.page],
@@ -2000,6 +1498,12 @@ function createProfile(access, apiPrefix) {
 				["client", input.client]
 			]);
 		},
+		listSharedNotebooksPath(input) {
+			return appendQuery(`${apiPrefix}/notebooks/shared`, [["page", input.page], ["page_size", input.pageSize]]);
+		},
+		mindPath(...segments) {
+			return `/api/v1/mind/${segments.map((segment) => encodeId(segment)).join("/")}`;
+		},
 		notebookPath(notebookId) {
 			return notebookId === void 0 ? apiPath("notebooks") : apiPath("notebooks", notebookId);
 		},
@@ -2031,6 +1535,58 @@ function isQMindTransport(value) {
 	if (!isRecord(value)) return false;
 	return typeof value.request === "function" && typeof value.stream === "function";
 }
+const managementOperationNames = [
+	"addMember",
+	"createScheduledTask",
+	"deleteScheduledTask",
+	"getCompilationSettings",
+	"getCompilationStatus",
+	"listMembers",
+	"listScheduledTasks",
+	"removeMember",
+	"saveCompilationSettings",
+	"startCompilation",
+	"updateMemberPermission",
+	"updateScheduledTask"
+];
+const cardOperationNames = [
+	"batchDeleteCards",
+	"deleteCard",
+	"getCard",
+	"listCards",
+	"listFeaturedCards"
+];
+const importOperationNames = [
+	"getAliDingImportRun",
+	"listAliDingImportRunItems",
+	"listImportProviders",
+	"startAliDingKnowledgeBaseImport",
+	"startAliDingNodeSubtreeImport"
+];
+function createLazyCardOperations(context) {
+	let operations;
+	const load = () => {
+		operations ??= import("./cards-2J6ebaI0.js").then(({ createCardOperations }) => createCardOperations(context));
+		return operations;
+	};
+	return Object.fromEntries(cardOperationNames.map((name) => [name, (...args) => load().then((loaded) => Reflect.apply(loaded[name], loaded, args))]));
+}
+function createLazyImportOperations(context) {
+	let operations;
+	const load = () => {
+		operations ??= import("./imports-Da88W09Q.js").then(({ createImportOperations }) => createImportOperations(context));
+		return operations;
+	};
+	return Object.fromEntries(importOperationNames.map((name) => [name, (...args) => load().then((loaded) => Reflect.apply(loaded[name], loaded, args))]));
+}
+function createLazyManagementOperations(context) {
+	let operations;
+	const load = () => {
+		operations ??= import("./management-xYuUDFtg.js").then(({ createManagementOperations }) => createManagementOperations(context));
+		return operations;
+	};
+	return Object.fromEntries(managementOperationNames.map((name) => [name, (...args) => load().then((loaded) => Reflect.apply(loaded[name], loaded, args))]));
+}
 function createQMindClient(options) {
 	if (!isRecord(options)) throw invalidArgument$1("client options must be an object", "options");
 	if (!isQMindAccess(options.access)) throw invalidArgument$1("access must be either \"sash\" or \"dashboard\"", "access");
@@ -2045,8 +1601,10 @@ function createQMindClient(options) {
 		access: profile.access,
 		capabilities: profile.capabilities,
 		...createNotebookOperations(context),
-		...createCardOperations(context),
+		...createLazyCardOperations(context),
 		...createSourceOperations(context),
+		...createLazyImportOperations(context),
+		...createLazyManagementOperations(context),
 		...createTransferOperations(context),
 		...createAgentOperations(context),
 		supports(capability) {
@@ -2055,65 +1613,6 @@ function createQMindClient(options) {
 	});
 }
 //#endregion
-//#region src/argv.ts
-const SHORT_OPTIONS = /* @__PURE__ */ new Set([
-	"-h",
-	"-V",
-	"-o",
-	"-q"
-]);
-/**
-* Preserve the historical Go CLI spelling where long options used one dash.
-* The delimiter is an intentional hard boundary: everything after `--` is a
-* positional value and must remain byte-for-byte unchanged.
-*/
-function normalizeLegacyArgv(argv) {
-	let positionalOnly = false;
-	return argv.map((argument) => {
-		if (argument === "--") {
-			positionalOnly = true;
-			return argument;
-		}
-		if (positionalOnly || SHORT_OPTIONS.has(argument) || argument.startsWith("--")) return argument;
-		if (/^-[A-Za-z][A-Za-z0-9-]+(?:=.*)?$/.test(argument)) return `-${argument}`;
-		return argument;
-	});
-}
-/** Runtime errors use the JSON error envelope only when the caller explicitly
-* selected JSON, except folder sync whose compatibility default is JSON. */
-function requestsJsonOutput(argv) {
-	let explicitFormat;
-	let positionalOnly = false;
-	for (let index = 0; index < argv.length; index += 1) {
-		const argument = argv[index];
-		if (argument === "--") {
-			positionalOnly = true;
-			continue;
-		}
-		if (positionalOnly) continue;
-		if (argument === "--format" || argument === "-format") {
-			explicitFormat = argv[index + 1];
-			index += 1;
-			continue;
-		}
-		const match = argument?.match(/^--?format=(.*)$/);
-		if (match !== null && match !== void 0) explicitFormat = match[1];
-	}
-	if (explicitFormat !== void 0) return explicitFormat === "json";
-	return argv[0] === "upload-folder" || argv[0] === "sync";
-}
-//#endregion
-//#region src/build-info.ts
-const QMIND_CLI_VERSION = "2.0.0";
-const QMIND_CLI_BUILD_TIME = "development";
-const QMIND_CLI_UPDATE_BASE_URL = typeof __QMIND_CLI_UPDATE_BASE_URL__ === "string" ? __QMIND_CLI_UPDATE_BASE_URL__ : "https://qoder-ide-cn.oss-cn-hangzhou.aliyuncs.com/qmind/cli/";
-function qmindCliPlatform() {
-	return process.platform === "win32" ? "windows" : process.platform;
-}
-function qmindCliArchitecture() {
-	return process.arch === "x64" ? "amd64" : process.arch;
-}
-//#endregion
 //#region ../node-host/src/auth.ts
 const responseRecordSchema = z.record(z.string(), z.unknown());
 const personalTokenExchangeSchema = z.object({ token: z.string().min(1) });
@@ -2336,7 +1835,7 @@ function createQMindCliAuthManager(options) {
 			if (token.length > 0) return token;
 			const candidate = explicitToken || credentials?.deviceToken || "";
 			if (candidate.length === 0) {
-				if (options.config.nonInteractive) throw new QMindError("AUTH_REQUIRED", "no credentials found; run 'qmind login' in an interactive terminal");
+				if (options.config.nonInteractive) throw new QMindError("AUTH_REQUIRED", `no credentials found; run '${options.loginCommand ?? "qmind login"}' in an interactive terminal`);
 				await login();
 				return token;
 			}
@@ -2372,18 +1871,32 @@ function createQMindCliAuthManager(options) {
 //#endregion
 //#region ../node-host/src/authenticated-transport.ts
 function withBearer(request, token) {
+	const headers = Object.fromEntries(Object.entries(request.headers ?? {}).filter(([name]) => name.toLowerCase() !== "authorization"));
 	return {
 		...request,
 		headers: {
-			...request.headers,
+			...headers,
 			authorization: `Bearer ${token}`
 		}
 	};
 }
-function createAuthenticatedQMindTransport(transport, auth) {
+/** A caller-supplied per-request bearer wins over process-level auth and skips refresh. */
+function hasRequestAuthorization(request) {
+	const headers = request.headers;
+	if (headers === void 0) return false;
+	return Object.keys(headers).some((name) => name.toLowerCase() === "authorization");
+}
+function hostCredentialRequired() {
+	return new QMindError("AUTH_REQUIRED", "The embedding host did not provide a credential for this request.");
+}
+function createAuthenticatedQMindTransport(transport, auth, requestCredential) {
 	return Object.freeze({
 		async request(request) {
 			if (request.destination.kind === "signed") return await transport.request(request);
+			const providedToken = (await requestCredential?.())?.trim();
+			if (providedToken) return await transport.request(withBearer(request, providedToken));
+			if (hasRequestAuthorization(request)) return await transport.request(request);
+			if (requestCredential !== void 0) throw hostCredentialRequired();
 			const token = await auth.getToken();
 			const response = await transport.request(withBearer(request, token));
 			if (response.status !== 401) return response;
@@ -2391,6 +1904,10 @@ function createAuthenticatedQMindTransport(transport, auth) {
 			return await transport.request(withBearer(request, refreshed));
 		},
 		async stream(request) {
+			const providedToken = (await requestCredential?.())?.trim();
+			if (providedToken) return await transport.stream(withBearer(request, providedToken));
+			if (hasRequestAuthorization(request)) return await transport.stream(request);
+			if (requestCredential !== void 0) throw hostCredentialRequired();
 			const token = await auth.getToken();
 			const response = await transport.stream(withBearer(request, token));
 			if (response.kind !== "response" || response.status !== 401) return response;
@@ -2426,10 +1943,31 @@ const PRESETS = Object.freeze({
 		sashOrigin: "https://test-openapi.qoder.sh"
 	}
 });
+/**
+* Embedding product identity → that product's backends per environment. Two products share neither
+* dashboard nor Sash, so a host that declares its identity must be routed by it; falling back to the
+* environment table alone would send the second product's requests to the first product's backend,
+* which is indistinguishable from a correct call on the wire.
+*
+* Cells that no backend exists for yet are absent rather than borrowed: resolving one throws.
+*/
+const PRODUCT_PRESETS = Object.freeze({
+	qoder: PRESETS,
+	"qoder-cn": Object.freeze({
+		prod: {
+			dashboardOrigin: "https://qoder.cn",
+			sashOrigin: "https://openapi.qoder.com.cn"
+		},
+		test: {
+			dashboardOrigin: "https://test.qoder.com.cn",
+			sashOrigin: "https://test-openapi.qoder.com.cn"
+		}
+	})
+});
 function invalidConfig(message, field) {
 	return new QMindError("INVALID_ARGUMENT", message, { ...field === void 0 ? {} : { details: { field } } });
 }
-function normalizeOrigin$1(rawValue, field) {
+function normalizeQMindOrigin(rawValue, field) {
 	let url;
 	try {
 		url = new URL(rawValue);
@@ -2439,6 +1977,17 @@ function normalizeOrigin$1(rawValue, field) {
 	if (url.protocol !== "http:" && url.protocol !== "https:" || url.username.length > 0 || url.password.length > 0 || url.pathname !== "/" || url.search.length > 0 || url.hash.length > 0) throw invalidConfig(`${field} must contain only an HTTP(S) scheme and authority`, field);
 	return url.origin;
 }
+/**
+* Resolves one registered product/environment without fallback. The default Host config loader
+* invokes this lazily after explicit overrides; fixed-product callers select the target up front.
+*/
+function resolveQMindProductEndpoints(productId, presetName, field = "env") {
+	const presets = Object.hasOwn(PRODUCT_PRESETS, productId) ? PRODUCT_PRESETS[productId] : void 0;
+	if (presets === void 0) throw invalidConfig(`no QMind endpoints are registered for product ${JSON.stringify(productId)}`, field);
+	const preset = Object.hasOwn(presets, presetName) ? presets[presetName] : void 0;
+	if (preset === void 0) throw invalidConfig(`product ${JSON.stringify(productId)} has no ${JSON.stringify(presetName)} endpoints; set ${field} explicitly`, field);
+	return { ...preset };
+}
 function optionalTrimmed(value) {
 	const trimmed = value?.trim();
 	return trimmed === void 0 || trimmed.length === 0 ? void 0 : trimmed;
@@ -2487,31 +2036,73 @@ async function mergedEnvironment(environment, legacyEnvironmentPath) {
 	}
 	return merged;
 }
-async function fileConfiguration(homeDirectory) {
+async function fileConfiguration(homeDirectory, fixedEndpoints = false) {
 	try {
 		return fileConfigSchema.parse(JSON.parse(await readFile(join(homeDirectory, "config.json"), "utf8")));
 	} catch (error) {
 		if (error.code === "ENOENT") return {};
+		if (fixedEndpoints && error instanceof z.ZodError) {
+			const field = error.issues.find((issue) => issue.path[0] === "sash_url" || issue.path[0] === "dashboard_url")?.path[0];
+			if (field !== void 0) throw invalidEndpointHint(`config.json ${String(field)}`);
+		}
 		throw invalidConfig("stored QMind configuration is invalid");
 	}
 }
 function defaultProcessEnvironment() {
 	return process.env;
 }
+function invalidEndpointHint(field) {
+	return invalidConfig(`${field} is invalid or conflicts with the selected target; remove ${field} and select the target with --env or paired --sash/--dashboard`, field);
+}
+function validateFixedEndpoints(options, environment, file) {
+	const target = options.fixedEndpoints;
+	if (target === void 0) return;
+	const checkOrigin = (raw, expected, field, deprecated = true) => {
+		if (raw === void 0) return;
+		let normalized;
+		try {
+			normalized = normalizeQMindOrigin(raw.trim(), field);
+		} catch {
+			throw invalidEndpointHint(field);
+		}
+		if (normalized !== expected) throw invalidEndpointHint(field);
+		if (deprecated) options.reporter?.warn(`warning: ${field} is deprecated and does not select a target; remove ${field}`);
+	};
+	checkOrigin(environment.QMIND_SASH_URL, target.sashOrigin, "QMIND_SASH_URL");
+	checkOrigin(environment.QMIND_DASHBOARD_URL, target.dashboardOrigin, "QMIND_DASHBOARD_URL");
+	checkOrigin(file.sash_url, target.sashOrigin, "config.json sash_url");
+	checkOrigin(file.dashboard_url, target.dashboardOrigin, "config.json dashboard_url");
+	checkOrigin(options.credentialSashOrigin, target.sashOrigin, "credentials.json sash_url", false);
+	if (environment.QMIND_ENV !== void 0) {
+		let legacy;
+		try {
+			legacy = resolveQMindProductEndpoints(options.productId ?? "", environment.QMIND_ENV.trim());
+		} catch {
+			throw invalidEndpointHint("QMIND_ENV");
+		}
+		if (legacy.sashOrigin !== target.sashOrigin || legacy.dashboardOrigin !== target.dashboardOrigin) throw invalidEndpointHint("QMIND_ENV");
+		options.reporter?.warn("warning: QMIND_ENV is deprecated and does not select a target; remove QMIND_ENV");
+	}
+}
 async function loadQMindCliConfig(options = {}) {
 	const initialEnvironment = options.environment ?? defaultProcessEnvironment();
 	const baseHome = options.homeDirectory ?? homedir();
 	const environment = await mergedEnvironment(initialEnvironment, options.legacyEnvironmentPath === void 0 ? join(baseHome, ".qmind-env") : options.legacyEnvironmentPath);
 	const configuredHome = optionalTrimmed(environment.QMIND_HOME);
 	const homeDirectory = resolve(options.homeDirectory ?? configuredHome ?? join(baseHome, ".qmind"));
-	const file = await fileConfiguration(homeDirectory);
+	const file = await fileConfiguration(homeDirectory, options.fixedEndpoints !== void 0);
+	validateFixedEndpoints(options, environment, file);
 	const flags = options.flags ?? {};
 	const stdinIsTTY = options.stdinIsTTY ?? process.stdin.isTTY === true;
 	const presetName = optionalTrimmed(environment.QMIND_ENV) ?? "prod";
-	const preset = PRESETS[presetName] ?? PRESETS.prod;
-	if (!(presetName in PRESETS)) options.reporter?.warn(`warning: unknown QMIND_ENV ${JSON.stringify(presetName)}, falling back to prod`);
-	const sashOrigin = normalizeOrigin$1(optionalTrimmed(flags.sash) ?? optionalTrimmed(environment.QMIND_SASH_URL) ?? optionalTrimmed(file.sash_url) ?? optionalTrimmed(options.credentialSashOrigin) ?? preset.sashOrigin, "sash");
-	const dashboardOrigin = normalizeOrigin$1(optionalTrimmed(flags.dashboard) ?? optionalTrimmed(environment.QMIND_DASHBOARD_URL) ?? optionalTrimmed(file.dashboard_url) ?? preset.dashboardOrigin, "dashboard");
+	const productId = optionalTrimmed(options.productId);
+	const defaultOrigin = (field) => {
+		const preset = productId === void 0 ? PRESETS[presetName] ?? PRESETS.prod : resolveQMindProductEndpoints(productId, presetName, field);
+		return field === "sash" ? preset.sashOrigin : preset.dashboardOrigin;
+	};
+	if (options.fixedEndpoints === void 0 && productId === void 0 && !(presetName in PRESETS)) options.reporter?.warn(`warning: unknown QMIND_ENV ${JSON.stringify(presetName)}, falling back to prod`);
+	const sashOrigin = normalizeQMindOrigin(options.fixedEndpoints?.sashOrigin ?? optionalTrimmed(flags.sash) ?? optionalTrimmed(environment.QMIND_SASH_URL) ?? optionalTrimmed(file.sash_url) ?? optionalTrimmed(options.credentialSashOrigin) ?? defaultOrigin("sash"), "sash");
+	const dashboardOrigin = normalizeQMindOrigin(options.fixedEndpoints?.dashboardOrigin ?? optionalTrimmed(flags.dashboard) ?? optionalTrimmed(environment.QMIND_DASHBOARD_URL) ?? optionalTrimmed(file.dashboard_url) ?? defaultOrigin("dashboard"), "dashboard");
 	const runtime = Object.freeze({
 		client: optionalTrimmed(flags.client) ?? optionalTrimmed(environment.QMIND_CLIENT) ?? optionalTrimmed(file.client) ?? "qmind",
 		dashboardOrigin,
@@ -2631,27 +2222,17 @@ async function optionalSecret(operation, fallback) {
 		return fallback;
 	}
 }
-function createOptionalKeyringSecretStore() {
-	const entry = async () => {
-		const { Entry } = await import("@napi-rs/keyring");
-		return new Entry("qmind-cli", "device-token");
-	};
+function createNoopQMindSecretStore() {
 	return Object.freeze({
-		async delete() {
-			await optionalSecret(async () => void (await entry()).deletePassword(), void 0);
-		},
-		async get() {
-			return await optionalSecret(async () => (await entry()).getPassword() ?? void 0, void 0);
-		},
-		async set(token) {
-			await optionalSecret(async () => void (await entry()).setPassword(token), void 0);
-		}
+		async delete() {},
+		async get() {},
+		async set(_token) {}
 	});
 }
 function createFileCredentialVault(options) {
 	const credentialsPath = join(options.homeDirectory, "credentials.json");
 	const legacyBackupPath = `${credentialsPath}.v1.bak`;
-	const secretStore = options.secretStore ?? createOptionalKeyringSecretStore();
+	const secretStore = options.secretStore ?? createNoopQMindSecretStore();
 	const now = options.now ?? Date.now;
 	const loadUnlocked = async () => {
 		let serialized;
@@ -2890,6 +2471,11 @@ function headersToRecord(headers) {
 	}
 	return result;
 }
+function normalizedRequestHeaders(headers) {
+	const result = {};
+	for (const [name, value] of Object.entries(headers ?? {})) result[name.toLowerCase()] = value;
+	return result;
+}
 function parseRawBody(rawBody) {
 	if (rawBody.trim().length === 0) return void 0;
 	try {
@@ -2958,7 +2544,7 @@ function byteLength(value) {
 	return Buffer.byteLength(value, "utf8");
 }
 function encodeBody(request, boundary) {
-	const initialHeaders = { ...request.headers };
+	const initialHeaders = normalizedRequestHeaders(request.headers);
 	const body = request.body;
 	if (body === void 0) return { headers: initialHeaders };
 	if (body.kind === "json") {
@@ -3323,8 +2909,10 @@ function configurationOptions(options, reporter) {
 		...options.credentialSashOrigin === void 0 ? {} : { credentialSashOrigin: options.credentialSashOrigin },
 		...options.environment === void 0 ? {} : { environment: options.environment },
 		...options.flags === void 0 ? {} : { flags: options.flags },
+		...options.fixedEndpoints === void 0 ? {} : { fixedEndpoints: options.fixedEndpoints },
 		...options.homeDirectory === void 0 ? {} : { homeDirectory: options.homeDirectory },
 		...options.legacyEnvironmentPath === void 0 ? {} : { legacyEnvironmentPath: options.legacyEnvironmentPath },
+		...options.productId === void 0 ? {} : { productId: options.productId },
 		...reporter === void 0 ? {} : { reporter },
 		...options.stdinIsTTY === void 0 ? {} : { stdinIsTTY: options.stdinIsTTY }
 	};
@@ -3335,7 +2923,7 @@ async function createQMindCliHost(options = {}) {
 	const vault = createFileCredentialVault({
 		homeDirectory: (await loadQMindCliConfig(configurationOptions(options))).runtime.homeDirectory,
 		now: () => clock.now(),
-		secretStore: options.adapters?.secretStore ?? createOptionalKeyringSecretStore()
+		secretStore: options.adapters?.secretStore ?? createNoopQMindSecretStore()
 	});
 	let credentials;
 	try {
@@ -3347,7 +2935,7 @@ async function createQMindCliHost(options = {}) {
 	}
 	const resolved = await loadQMindCliConfig({
 		...configurationOptions(options, reporter),
-		...credentials?.sashOrigin ? { credentialSashOrigin: credentials.sashOrigin } : {},
+		...options.adapters?.requestCredential === void 0 && credentials?.sashOrigin ? { credentialSashOrigin: credentials.sashOrigin } : {},
 		reporter
 	});
 	const ca = await tlsAuthority(resolved.tlsCaFile);
@@ -3374,6 +2962,7 @@ async function createQMindCliHost(options = {}) {
 		config: resolved.runtime,
 		credentials,
 		explicitToken: resolved.token,
+		...options.loginCommand === void 0 ? {} : { loginCommand: options.loginCommand },
 		reporter,
 		transport: rawTransport,
 		vault
@@ -3381,7 +2970,7 @@ async function createQMindCliHost(options = {}) {
 	const client = createQMindClient({
 		access: "sash",
 		client: resolved.runtime.client,
-		transport: createAuthenticatedQMindTransport(rawTransport, auth)
+		transport: createAuthenticatedQMindTransport(rawTransport, auth, options.adapters?.requestCredential)
 	});
 	return Object.freeze({
 		client,
@@ -3400,6 +2989,120 @@ async function createQMindCliHost(options = {}) {
 	});
 }
 //#endregion
+//#region src/argv.ts
+const SHORT_OPTIONS = /* @__PURE__ */ new Set([
+	"-h",
+	"-V",
+	"-o",
+	"-q"
+]);
+/**
+* Preserve the historical Go CLI spelling where long options used one dash.
+* The delimiter is an intentional hard boundary: everything after `--` is a
+* positional value and must remain byte-for-byte unchanged.
+*/
+function normalizeLegacyArgv(argv) {
+	let positionalOnly = false;
+	return argv.map((argument) => {
+		if (argument === "--") {
+			positionalOnly = true;
+			return argument;
+		}
+		if (positionalOnly || SHORT_OPTIONS.has(argument) || argument.startsWith("--")) return argument;
+		if (/^-[A-Za-z][A-Za-z0-9-]+(?:=.*)?$/.test(argument)) return `-${argument}`;
+		return argument;
+	});
+}
+/** Runtime errors use the JSON error envelope only when the caller explicitly
+* selected JSON, except folder sync whose compatibility default is JSON. */
+function requestsJsonOutput(argv) {
+	let explicitFormat;
+	let positionalOnly = false;
+	for (let index = 0; index < argv.length; index += 1) {
+		const argument = argv[index];
+		if (argument === "--") {
+			positionalOnly = true;
+			continue;
+		}
+		if (positionalOnly) continue;
+		if (argument === "--format" || argument === "-format") {
+			explicitFormat = argv[index + 1];
+			index += 1;
+			continue;
+		}
+		const match = argument?.match(/^--?format=(.*)$/);
+		if (match !== null && match !== void 0) explicitFormat = match[1];
+	}
+	if (explicitFormat !== void 0) return explicitFormat === "json";
+	return argv[0] === "upload-folder" || argv[0] === "sync";
+}
+//#endregion
+//#region src/build-info.ts
+/** Bundled identity, never inferred from argv, environment, or an endpoint. */
+const QMIND_CLI_DISTRIBUTION = "global";
+const QMIND_CLI_VERSION = "3.0.0";
+const QMIND_CLI_BUILD_TIME = "2026-09-01T07:33:25.000Z";
+function qmindCliPlatform() {
+	return process.platform === "win32" ? "windows" : process.platform;
+}
+function qmindCliArchitecture() {
+	return process.arch === "x64" ? "amd64" : process.arch;
+}
+//#endregion
+//#region src/distributions.ts
+/** Canonical runtime and release identity for every public CLI distribution. */
+const CLI_DISTRIBUTIONS = Object.freeze({
+	global: {
+		id: "global",
+		command: "qmind",
+		package: "@qoder-ai/qmind-cli",
+		productId: "qoder",
+		gitTagSlug: "qmind-cli",
+		readmeDirectory: ".",
+		productNames: {
+			en: "Qoder Global",
+			zhCN: "Qoder Global"
+		}
+	},
+	cn: {
+		id: "cn",
+		command: "qmind-cn",
+		package: "@qodercn-ai/qmind-cli",
+		productId: "qoder-cn",
+		gitTagSlug: "qmind-cli-cn",
+		readmeDirectory: "readmes/cn",
+		productNames: {
+			en: "Qoder China",
+			zhCN: "Qoder 中国版"
+		}
+	}
+});
+//#endregion
+//#region src/config.ts
+function cliHostConfiguration(distribution, flags, environment, stateRoot) {
+	const { productId, command } = CLI_DISTRIBUTIONS[distribution];
+	const custom = flags.sash !== void 0 || flags.dashboard !== void 0;
+	if (custom && (typeof flags.sash !== "string" || typeof flags.dashboard !== "string" || flags.env !== void 0)) throw new QMindError("INVALID_ARGUMENT", "--sash and --dashboard must be supplied together and cannot be combined with --env");
+	const preset = typeof flags.env === "string" ? flags.env.trim() : "prod";
+	const endpoints = custom ? {
+		dashboardOrigin: normalizeQMindOrigin(String(flags.dashboard).trim(), "--dashboard"),
+		sashOrigin: normalizeQMindOrigin(String(flags.sash).trim(), "--sash")
+	} : resolveQMindProductEndpoints(productId, preset);
+	const target = custom ? `custom-${createHash("sha256").update(JSON.stringify([endpoints.dashboardOrigin, endpoints.sashOrigin])).digest("hex")}` : preset;
+	return {
+		environment: {
+			...environment,
+			QMIND_TOKEN: target === "prod" ? environment.QMIND_TOKEN : environment.QMIND_DEBUG_TOKEN
+		},
+		flags,
+		fixedEndpoints: endpoints,
+		homeDirectory: join(resolve(stateRoot ?? (environment.QMIND_HOME?.trim() || join(homedir(), ".qmind"))), "cli", distribution, target),
+		legacyEnvironmentPath: false,
+		loginCommand: `${command} login${custom ? ` --sash ${endpoints.sashOrigin} --dashboard ${endpoints.dashboardOrigin}` : target === "prod" ? "" : ` --env ${target}`}`,
+		productId
+	};
+}
+//#endregion
 //#region src/folder-sync.ts
 const QMIND_FOLDER_SYNC_DEFAULT_EXTENSIONS = Object.freeze([
 	".mdx",
@@ -3761,13 +3464,6 @@ function table(writer, headers, rows, widths, separatorWidth) {
 }
 function goTimestamp(value) {
 	if (value === void 0 || value === null || value === "") return null;
-	if (typeof value === "object") {
-		const source = record(value);
-		return {
-			nanos: numberValue(source.nanos),
-			seconds: numberValue(source.seconds)
-		};
-	}
 	const text = stringValue(value);
 	const milliseconds = Date.parse(text);
 	if (!Number.isFinite(milliseconds)) return null;
@@ -4488,6 +4184,7 @@ function createQMindCliStreamRenderer(format) {
 }
 //#endregion
 //#region src/application.ts
+const distribution = CLI_DISTRIBUTIONS[QMIND_CLI_DISTRIBUTION];
 function processIO() {
 	return Object.freeze({
 		stdinIsTTY: process.stdin.isTTY === true,
@@ -4548,25 +4245,25 @@ function formatOf(options) {
 }
 function commonFlags(options) {
 	const client = optionalString(options, "client");
-	const dashboard = optionalString(options, "dashboard");
-	const sash = optionalString(options, "sash");
+	const dashboard = stringOption(options, "dashboard");
+	const sash = stringOption(options, "sash");
+	const env = stringOption(options, "env");
 	const token = optionalString(options, "token");
 	return {
 		...client === void 0 ? {} : { client },
+		...env === void 0 ? {} : { env },
 		...dashboard === void 0 ? {} : { dashboard },
 		...options.nonInteractive === true ? { nonInteractive: true } : {},
 		...sash === void 0 ? {} : { sash },
 		...token === void 0 ? {} : { token }
 	};
 }
-async function hostFor(context, options, environmentOverrides = {}) {
+async function hostFor(context, options) {
 	if (context.host !== void 0) return context.host;
-	const environment = {
-		...context.hostOptions.environment ?? process.env,
-		...environmentOverrides
-	};
+	const configuration = cliHostConfiguration(QMIND_CLI_DISTRIBUTION, commonFlags(options), context.hostOptions.environment ?? process.env, context.hostOptions.homeDirectory);
 	const adapters = {
 		...context.hostOptions.adapters,
+		secretStore: createNoopQMindSecretStore(),
 		reporter: context.hostOptions.adapters?.reporter ?? {
 			info(message) {
 				context.io.stderr(`${message}\n`);
@@ -4578,9 +4275,8 @@ async function hostFor(context, options, environmentOverrides = {}) {
 	};
 	context.host = await context.hostFactory({
 		...context.hostOptions,
+		...configuration,
 		adapters,
-		environment,
-		flags: commonFlags(options),
 		stdinIsTTY: context.io.stdinIsTTY
 	});
 	return context.host;
@@ -4589,7 +4285,7 @@ function render(context, options, presentation) {
 	context.io.stdout(renderQMindCliPresentation(presentation, formatOf(options)));
 }
 function withCommon(command, output = true) {
-	command.option("--token <token>", "Bearer access token").option("--sash <url>", "Sash server origin").option("--dashboard <url>", "Dashboard origin").option("--org <id>", "organization ID (deprecated and ignored)").option("--client <name>", "originating client identifier").option("--non-interactive", "never open a browser when credentials are missing");
+	command.option("--token <token>", "Bearer access token").option("--env <name>", "product environment: prod (default), test, or daily where supported").option("--sash <url>", "custom debug Sash origin (requires --dashboard; excludes --env)").option("--dashboard <url>", "custom debug Dashboard origin (requires --sash; excludes --env)").option("--org <id>", "organization ID (deprecated and ignored)").option("--client <name>", "originating client identifier").option("--non-interactive", "never open a browser when credentials are missing");
 	if (output) command.option("--format <format>", "output format: table | json | agent | ndjson", "table");
 	return command;
 }
@@ -4800,7 +4496,7 @@ function registerSourceCommands(context, program) {
 			kind: "source",
 			value
 		});
-		else context.io.stdout(`Site source created: ${value.id}\n  title : ${value.title}\n  status: ${value.status}\n  site  : ${rootUrl}\n\nSite import is running asynchronously. Use 'qmind source list' to check imported pages.\n`);
+		else context.io.stdout(`Site source created: ${value.id}\n  title : ${value.title}\n  status: ${value.status}\n  site  : ${rootUrl}\n\nSite import is running asynchronously. Use '${distribution.command} source list' to check imported pages.\n`);
 	});
 	const image = program.command("image").description("Notebook image presign operations");
 	withCommon(image.command("presign-upload").description("Presign or upload a notebook image"), false).option("--nb <id>", "notebook ID (required)").option("--source <id>", "source ID (required)").option("--filename <name>", "image filename (required unless --file is set)").option("--mime <type>", "MIME type (required unless --file is set)").option("--size <bytes>", "file size", integer, 0).option("--file <path>", "local image to upload").action(async (raw) => {
@@ -4897,19 +4593,19 @@ function syncText(stats) {
 	return `[upload-folder] 完成: 创建目录 ${stats.dirs_created} (复用 ${stats.dirs_reused}, 失败 ${stats.dirs_failed}), 上传文件 ${stats.files_uploaded}, 已存在跳过 ${stats.files_already_exist}, 不支持或忽略 ${stats.files_skipped}, 失败 ${stats.files_failed}, 时间戳刷新失败 ${stats.dirs_refresh_failed}` + (stats.files_deleted === void 0 ? "" : `, 删除文件 ${stats.files_deleted}, 删除目录 ${stats.dirs_deleted ?? 0}, 删除失败 ${stats.delete_failed ?? 0}`) + "\n";
 }
 function registerSyncCommand(context, program) {
-	withCommon(program.command("upload-folder").alias("sync").description("Synchronize a local folder"), false).option("--nb <id>", "notebook ID (required)").option("--dir <path>", "local directory (required)").option("--env <name>", "environment preset").option("--extensions <list>", "comma-separated extensions").option("--dir-ids <path>", "existing directory ID mapping").option("--skip-upload", "only refresh directory timestamps").option("--concurrency <number>", "parallel uploads", integer, 3).option("--save-dir-ids <path>", "directory ID mapping output").option("--ignore <patterns...>", "glob patterns to exclude").option("--delete", "delete remote entries absent from the local mirror").option("--dry-run", "calculate changes without mutating remote or local state").option("--format <format>", "summary output format: json | text", "json").addOption(new Option("--mode <mode>", "existing-file behavior").choices([
+	withCommon(program.command("upload-folder").alias("sync").description("Synchronize a local folder"), false).option("--nb <id>", "notebook ID (required)").option("--dir <path>", "local directory (required)").option("--extensions <list>", "comma-separated extensions").option("--dir-ids <path>", "existing directory ID mapping").option("--skip-upload", "only refresh directory timestamps").option("--concurrency <number>", "parallel uploads", integer, 3).option("--save-dir-ids <path>", "directory ID mapping output").option("--ignore <patterns...>", "glob patterns to exclude").option("--delete", "delete remote entries absent from the local mirror").option("--dry-run", "calculate changes without mutating remote or local state").option("--format <format>", "summary output format: json | text", "json").addOption(new Option("--mode <mode>", "existing-file behavior").choices([
 		"skip",
 		"overwrite",
 		"if-changed"
 	]).default("skip")).action(async (raw) => {
-		const environment = optionalString(raw, "env");
-		const host = await hostFor(context, raw, environment === void 0 ? {} : { QMIND_ENV: environment });
+		const host = await hostFor(context, raw);
 		const ignoreValues = Array.isArray(raw.ignore) ? raw.ignore.flatMap((value) => splitCsv(String(value))) : [];
 		const directoryIdsPath = optionalString(raw, "dirIds");
 		const saveDirectoryIdsPath = optionalString(raw, "saveDirIds");
 		const extensions = splitCsv(optionalString(raw, "extensions"));
 		const result = await synchronizeQMindFolder(host, {
 			baseDirectory: requiredString(raw.dir, "--dir"),
+			cacheDirectory: join(host.config.homeDirectory, "cache"),
 			concurrency: Math.max(1, numberOption(raw, "concurrency", 3)),
 			delete: raw.delete === true,
 			dryRun: raw.dryRun === true,
@@ -4930,42 +4626,30 @@ function registerSyncCommand(context, program) {
 		if (result.exitCode === 1) context.exitCode = 1;
 	});
 }
-function registerUpdateCommand(context, program) {
-	program.command("self-update").description("Show the supported qmind CLI upgrade path").option("--url <url>", "channel manifest or CLI base URL", QMIND_CLI_UPDATE_BASE_URL).addOption(new Option("--channel <channel>", "release channel").choices([
+function registerUpdateCommand(program) {
+	program.command("self-update").description("Show the supported qmind CLI upgrade path").option("--url <url>", "legacy update URL (ignored)").addOption(new Option("--channel <channel>", "legacy release channel (ignored)").choices([
 		"stable",
 		"beta",
 		"daily"
-	]).default("stable")).option("--public-key <key>", "Ed25519 public key file, PEM, or base64").option("--check", "only check and verify the available update").option("--force", "reinstall the same version").option("--allow-downgrade", "explicitly allow installing an older signed version").action(async (raw) => {
-		if (context.selfUpdater === void 0) throw new QMindError("UNSUPPORTED_OPERATION", "self-update is unavailable for npm installs; run npm update --global @qoder-ai/qmind-cli");
-		const result = await context.selfUpdater.update({
-			allowDowngrade: raw.allowDowngrade === true,
-			baseUrl: String(raw.url),
-			channel: String(raw.channel),
-			check: raw.check === true,
-			currentVersion: QMIND_CLI_VERSION,
-			force: raw.force === true,
-			publicKey: String(raw.publicKey ?? "")
-		});
-		if (result.updated) context.io.stdout(`[self-update] updated ${QMIND_CLI_VERSION} -> ${result.version}\n`);
-		else if (result.version === "2.0.0".replace(/^v/, "")) context.io.stdout(`[self-update] already current: ${result.version}\n`);
-		else context.io.stdout(`[self-update] verified available version: ${result.version}\n`);
+	]).default("stable")).option("--public-key <key>", "legacy public key (ignored)").option("--check", "legacy check mode (ignored)").option("--force", "legacy reinstall mode (ignored)").option("--allow-downgrade", "legacy downgrade mode (ignored)").action(() => {
+		throw new QMindError("UNSUPPORTED_OPERATION", `self-update is unavailable for npm installs; run npm update --global ${distribution.package}`);
 	});
 }
 /** Internal parser adapter. Product consumers should call runQMindCli(). */
 function createQMindCliProgram(context) {
-	const program = new Command().name("qmind").description("QMind knowledge CLI").version(QMIND_CLI_VERSION).showHelpAfterError().exitOverride().configureOutput({
+	const program = new Command().name(distribution.command).description("QMind knowledge CLI").version(QMIND_CLI_VERSION).showHelpAfterError().exitOverride().configureOutput({
 		writeErr: (value) => context.io.stderr(value),
 		writeOut: (value) => context.io.stdout(value)
 	});
 	program.command("version").description("Print version and build information").action(() => {
-		context.io.stdout(`qmind ${QMIND_CLI_VERSION} (built ${QMIND_CLI_BUILD_TIME}, ${qmindCliPlatform()}/${qmindCliArchitecture()})\n`);
+		context.io.stdout(`${distribution.command} ${QMIND_CLI_VERSION} (built ${QMIND_CLI_BUILD_TIME}, ${qmindCliPlatform()}/${qmindCliArchitecture()})\n`);
 	});
 	registerCoreCommands(context, program);
 	registerSourceCommands(context, program);
 	registerSceneCommands(context, program);
 	registerTaskCommands(context, program);
 	registerSyncCommand(context, program);
-	registerUpdateCommand(context, program);
+	registerUpdateCommand(program);
 	return program;
 }
 async function runQMindCli(argv, options = {}) {
@@ -4976,8 +4660,7 @@ async function runQMindCli(argv, options = {}) {
 		host: void 0,
 		hostFactory: options.hostFactory ?? createQMindCliHost,
 		hostOptions: options.hostOptions ?? {},
-		io,
-		...options.selfUpdater === void 0 ? {} : { selfUpdater: options.selfUpdater }
+		io
 	};
 	const normalized = normalizeLegacyArgv(argv);
 	const requiresLegacyAction = normalized.length === 0 || normalized.length === 1 && (/* @__PURE__ */ new Set([