@modesto_ma/dsh-channels 0.1.0 → 0.2.0

package/lib/index.js

@@ -6460,13 +6460,21 @@ var FeishuService = class {
 	started = false;
 	/** Epoch ms when `start()` completed (uptime for `/status`). */
 	startedAt;
-	/** Last failed `boot()` message, surfaced in the Web settings panel. */
+	/** Last failed connection attempt, surfaced in the Web settings panel. */
 	lastStartError;
+	/** Whether both Feishu application credentials currently resolve. */
+	configured = false;
+	/** Names of the missing credential references (never their values). */
+	missingConfigItems = [];
+	/** Guards the panel's explicit connect action (distinct from a restart). */
+	connecting = false;
 	/** Effective config captured at the last successful connect (restart-pending diff). */
 	runningConfig;
 	/** Guards overlapping panel-triggered reconnects. */
 	restarting = false;
 	unlisten;
+	/** Disposers for host-scoped listeners registered by `start()`. */
+	unlistenHost = [];
 	/** Periodic route-GC timer (unref'd; only armed when `routeTtlMs > 0`). */
 	gcTimer;
 	/** Periodic workspace-retention timer (only armed when auto cleanup is on). */
@@ -6565,24 +6573,82 @@ var FeishuService = class {
 		});
 	}
 	/**
-	* Load the Web overlay, then open the channel. Startup errors are recorded
-	* for the settings panel and the partial service is torn down before the
-	* error is rethrown (the plugin fiber still fails the same way).
+	* Load the Web overlay and open the long connection when — and only when —
+	* the Feishu application credentials are complete.
+	*
+	* An incomplete configuration is a normal state, not an error: the plugin
+	* stays loaded so the Web settings panel can guide the user through the
+	* credentials form, and no connection is attempted. A failed connection
+	* attempt is recorded for the panel instead of failing the plugin fiber.
 	*/
 	async boot() {
+		if (this.connecting || this.restarting) return;
+		this.connecting = true;
 		try {
 			await this.loadOverlay();
+			await this.refreshReadiness();
+			if (!this.configured) {
+				this.lastStartError = void 0;
+				this.runningConfig = void 0;
+				this.ctx.logger?.info?.("dsh-channels: 飞书应用凭据未配置完整（缺少 %s），本次不连接飞书；请在 Web 设置面板 → 飞书渠道中配置，保存后会自动连接", this.missingConfigItems.join("、"));
+				return;
+			}
+			await this.openConnection();
+		} catch {} finally {
+			this.connecting = false;
+		}
+	}
+	/**
+	* Refresh the cached configuration readiness from the credentials seam.
+	* Only presence is checked (describe/resolve), never values; the secrets
+	* themselves are resolved by `start()` when a connection is opened.
+	*/
+	async refreshReadiness() {
+		const states = await this.credentialStates();
+		const missing = [];
+		if (!states.appId.configured) missing.push(`${this.config.appId}（飞书 App ID）`);
+		if (!states.appSecret.configured) missing.push(`${this.config.appSecret}（飞书 App Secret）`);
+		this.missingConfigItems = missing;
+		this.configured = missing.length === 0;
+	}
+	/**
+	* Open the connection with the live config. A failure tears the partial
+	* service down and records the reason for the panel before rethrowing it to
+	* the caller; the plugin fiber is never failed by a connection problem.
+	*/
+	async openConnection() {
+		try {
 			await this.start();
 			this.lastStartError = void 0;
 			this.runningConfig = { ...this.config };
 		} catch (error) {
 			this.lastStartError = messageOf$3(error);
+			this.ctx.logger?.error?.("dsh-channels: 飞书连接失败：%s", String(error));
+			console.error("[dsh-channels] feishu connection failed:", error);
 			try {
 				await this.shutdown();
 			} catch {}
 			throw error;
 		}
 	}
+	/**
+	* Panel action: open the long connection when the channel is stopped.
+	* Credentials are re-checked first — an incomplete pair throws a message the
+	* panel shows next to the credentials form instead of attempting a connect.
+	*/
+	async connect() {
+		if (this.started) return;
+		if (this.connecting || this.restarting) throw new Error("飞书连接正在连接或重启，请稍候再试");
+		this.connecting = true;
+		try {
+			await this.loadOverlay();
+			await this.refreshReadiness();
+			if (!this.configured) throw new Error(`飞书应用凭据尚未配置完整：缺少 ${this.missingConfigItems.join("、")}`);
+			await this.openConnection();
+		} finally {
+			this.connecting = false;
+		}
+	}
 	/** Re-read the Web overlay over the profile config (no channel touch). */
 	async loadOverlay() {
 		const overlay = this.overlay === void 0 ? {} : await this.overlay.load();
@@ -6613,22 +6679,24 @@ var FeishuService = class {
 		});
 		this.refreshRetentionTimer();
 	}
-	/** Tear the connection down and bring it back with the latest config. */
+	/**
+	* Tear the connection down and bring it back with the latest config. When the
+	* credentials are no longer complete the channel simply stays stopped (no
+	* error): the panel then shows the configuration guide instead of a failure.
+	*/
 	async restart() {
-		if (this.restarting) throw new Error("飞书连接正在重启，请稍候再试");
+		if (this.restarting || this.connecting) throw new Error("飞书连接正在连接或重启，请稍候再试");
 		this.restarting = true;
 		try {
 			await this.shutdown();
 			await this.loadOverlay();
-			await this.start();
-			this.lastStartError = void 0;
-			this.runningConfig = { ...this.config };
-		} catch (error) {
-			this.lastStartError = messageOf$3(error);
-			try {
-				await this.shutdown();
-			} catch {}
-			throw error;
+			await this.refreshReadiness();
+			if (!this.configured) {
+				this.lastStartError = void 0;
+				this.runningConfig = void 0;
+				return;
+			}
+			await this.openConnection();
 		} finally {
 			this.restarting = false;
 		}
@@ -6639,6 +6707,18 @@ var FeishuService = class {
 	isRestarting() {
 		return this.restarting;
 	}
+	/** True while the panel's explicit connect action is in flight. */
+	isConnecting() {
+		return this.connecting;
+	}
+	/** Whether both Feishu application credentials currently resolve. */
+	isConfigured() {
+		return this.configured;
+	}
+	/** Names of the missing configuration items (never values). */
+	missingConfig() {
+		return this.missingConfigItems;
+	}
 	startedAtMs() {
 		return this.startedAt;
 	}
@@ -6662,6 +6742,7 @@ var FeishuService = class {
 		const admin = this.config.adminOpenId;
 		return {
 			mode: this.config.accessMode,
+			loaded: this.domain !== void 0,
 			admin: {
 				...admin === void 0 ? {} : { openId: admin },
 				configured: admin !== void 0
@@ -6706,7 +6787,7 @@ var FeishuService = class {
 		const admin = this.config.adminOpenId;
 		if (admin === void 0) return {
 			ok: false,
-			error: "请先在常用配置中设置管理员 open_id"
+			error: "请先在「访问授权」标签页设置管理员 open_id"
 		};
 		try {
 			if (!this.accessStore.hasGroup(id)) await this.accessStore.addGroup({
@@ -6757,7 +6838,7 @@ var FeishuService = class {
 		const admin = this.config.adminOpenId;
 		if (admin === void 0) return {
 			ok: false,
-			error: "请先在常用配置中设置管理员 open_id"
+			error: "请先在「访问授权」标签页设置管理员 open_id"
 		};
 		try {
 			if (!this.accessStore.hasUser(id)) await this.accessStore.addUser({
@@ -6808,7 +6889,7 @@ var FeishuService = class {
 		const actor = this.config.adminOpenId;
 		if (actor === void 0) return {
 			ok: false,
-			error: "请先配置管理员 open_id"
+			error: "请先在「访问授权」标签页配置管理员 open_id"
 		};
 		try {
 			const result = await requests.resolve(token, decision, actor);
@@ -6853,6 +6934,13 @@ var FeishuService = class {
 			...window === void 0 ? {} : { thresholdMs: window },
 			auto: this.config.workspaceRetentionAuto
 		};
+		if (this.domain === void 0) return {
+			...base,
+			workspaces: 0,
+			candidates: 0,
+			candidateBytes: 0,
+			error: "飞书连接建立后即可预览和清理工作区"
+		};
 		try {
 			const workspaces = this.ctx.workspaceRegistry.list().filter((workspace) => this.isPluginWorkspace(workspace));
 			const plan = await planWorkspaceCleanup(this.cleanupDeps());
@@ -6886,6 +6974,10 @@ var FeishuService = class {
 			freedBytes: 0,
 			failures: []
 		};
+		if (this.domain === void 0) return {
+			...empty,
+			error: "飞书连接建立后才能清理工作区"
+		};
 		if (retentionMs(this.config.workspaceRetention) === void 0) return {
 			...empty,
 			error: "未启用工作区清理阈值（workspaceRetention 为 off）"
@@ -7051,6 +7143,7 @@ var FeishuService = class {
 		} catch (error) {
 			throw new Error(`写入凭据引用 ${ref} 失败：${messageOf$3(error)}`);
 		}
+		await this.refreshReadiness();
 	}
 	/** Remove the stored value of one Feishu credential reference. */
 	async clearCredential(field) {
@@ -7062,6 +7155,7 @@ var FeishuService = class {
 		} catch (error) {
 			throw new Error(`移除凭据引用 ${ref} 失败：${messageOf$3(error)}`);
 		}
+		await this.refreshReadiness();
 	}
 	/** The overlay-independent ref name backing one editable credential slot. */
 	credentialRef(field) {
@@ -7136,12 +7230,12 @@ var FeishuService = class {
 			answerer.onCardAction(event);
 			questions.onCardAction(event);
 		});
-		this.ctx.on("session/event", (session, event) => {
+		this.unlistenHost.push(this.ctx.on("session/event", (session, event) => {
 			this.streamer?.onSessionEvent(session, event);
-		});
-		this.ctx.on("agent/assistant-stream", ({ agent, frame }) => {
+		}));
+		this.unlistenHost.push(this.ctx.on("agent/assistant-stream", ({ agent, frame }) => {
 			this.streamer?.onAssistantFrame(agent.session, frame);
-		});
+		}));
 		this.unlisten = channel.onMessage((message) => {
 			this.inbound.handle(message).catch((error) => {
 				this.ctx.logger?.warn?.("dsh-channels inbound error: %s", String(error));
@@ -7198,6 +7292,7 @@ var FeishuService = class {
 		this.unlistenApproval = void 0;
 		this.unlistenQuestions?.();
 		this.unlistenQuestions = void 0;
+		for (const dispose of this.unlistenHost.splice(0)) dispose();
 		this.approvalAnswerer?.dispose();
 		this.approvalAnswerer = void 0;
 		this.questionAnswerer?.dispose();
@@ -8168,6 +8263,9 @@ const FEISHU_LOGGER_LEVELS = [
 ];
 /** Same shape as the host credentials seam's `CredentialRef` (shell identifier). */
 const CREDENTIAL_REF_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** Conventional credential-reference names used when the loader passes no config. */
+const DEFAULT_APP_ID_REF = "FEISHU_APP_ID";
+const DEFAULT_APP_SECRET_REF = "FEISHU_APP_SECRET";
 /** Default route-table GC threshold: 30 days without activity. */
 const DEFAULT_ROUTE_TTL_MS = 720 * 60 * 60 * 1e3;
 /** Default HITL approval decision window: 5 minutes per question. */
@@ -8177,10 +8275,10 @@ const DEFAULT_QUESTION_TIMEOUT_MS = 300 * 1e3;
 /** A credential reference: `FEISHU_APP_ID`-style name resolved through ctx.credentials. */
 const credentialRefSchema = z.string().regex(CREDENTIAL_REF_PATTERN, "must be a credential reference name such as FEISHU_APP_ID (resolved through the dsh credentials seam, e.g. $DSH_HOME/.credentials.yaml) — plaintext secrets are not accepted");
 const configSchema = z.object({
-	/** Feishu app id credential reference (e.g. `FEISHU_APP_ID`). */
-	appId: credentialRefSchema,
-	/** Feishu app secret credential reference (e.g. `FEISHU_APP_SECRET`). */
-	appSecret: credentialRefSchema,
+	/** Feishu app id credential reference (defaults to `FEISHU_APP_ID`). */
+	appId: credentialRefSchema.default(DEFAULT_APP_ID_REF),
+	/** Feishu app secret credential reference (defaults to `FEISHU_APP_SECRET`). */
+	appSecret: credentialRefSchema.default(DEFAULT_APP_SECRET_REF),
 	/**
 	* Root directory for per-(user, chat) workspace directories — the filesystem
 	* root where files produced by channel sessions land. Read per session
@@ -8323,6 +8421,14 @@ const configSchema = z.object({
 	questionTimeoutMs: z.number().int().min(1e4).max(36e5).default(DEFAULT_QUESTION_TIMEOUT_MS)
 });
 /**
+* DSH loader-facing schema. The bundle patch inserts this plugin without a
+* `config` object; the loader validates that row with `undefined` before the
+* user's patch layer supplies values. Accept that absence and fill the same
+* defaults as {@link resolveConfig}, so enabling the plugin from the Web UI
+* cannot fail with "expected object, received undefined".
+*/
+const pluginConfigSchema = configSchema.prefault({});
+/**
 * Validate the raw loader config. Values stay credential *references*; the
 * secrets themselves resolve through `ctx.credentials` at startup.
 * @param raw - the config object the cordis loader passed (may be undefined).
@@ -8351,6 +8457,11 @@ const STATUS_ROUTE = "/dsh-channels/status";
 const PANEL_ROUTE = "/dsh-channels/panel";
 const CONFIG_ROUTE = "/dsh-channels/config";
 const CREDENTIALS_ROUTE = "/dsh-channels/credentials";
+/**
+* Connection lifecycle action (POST). While the channel runs it restarts the
+* long connection; while it is stopped it opens one — so the panel has exactly
+* one "connect / reconnect" button. Credentials are resolved again either way.
+*/
 const RECONNECT_ROUTE = "/dsh-channels/reconnect";
 /** 模型/推理档位/预设选择器的宿主目录（provider → model → effort 级联刷新）。 */
 const CATALOG_ROUTE = "/dsh-channels/catalog";
@@ -8365,6 +8476,14 @@ const ACCESS_USERS_ROUTE = "/dsh-channels/access/users";
 /** 结算一条待处理授权申请（POST，body `{ token, decision }`）。 */
 const ACCESS_REQUESTS_ROUTE = "/dsh-channels/access/requests";
 /**
+* 打开宿主机的系统目录选择框（POST，无请求体），返回绝对路径。
+*
+* 只有宿主挂载了 `directoryPicker` 的 native 后端（桌面/本地 GUI 会话）才
+* 会注册实际选择逻辑；远程/无头会话的 browse 后端不可用，面板不下发
+* [`EditableFieldWire.browse`]，保留手写输入。
+*/
+const PICK_DIRECTORY_ROUTE = "/dsh-channels/pick-directory";
+/**
 * 可由 Web 面板覆盖的配置项。全部是 `src/config.ts` 里已存在的字段；
 * 覆盖值写进 `$DSH_HOME/dsh-channels/settings.json`，优先级高于 profile
 * 的 `cordis.patch.yml`（见 README「Web 设置面板」）。
@@ -8412,22 +8531,55 @@ const RESTART_KEYS = [
 /** Display labels for the panel header/cards (kept on the wire so the client owns no copy). */
 const PANEL_COPY = {
 	title: "飞书渠道",
-	description: "飞书长连接状态、应用凭据与常用配置。凭据写入 DSH 凭据库且不回显；标注「需重连」的项需重启飞书连接生效。",
+	description: "飞书长连接、应用凭据与渠道配置。凭据只写入 DSH 凭据库且不回显；标注「需重连」的项在连接建立时读取。",
 	statusCard: "连接状态",
+	phaseUnconfigured: "待配置",
+	phaseIdle: "未连接",
+	phaseConnecting: "连接中",
+	phaseConnected: "已连接",
+	phaseError: "连接失败",
+	configuredBadge: "凭据已配置",
+	unconfiguredBadge: "凭据未配置",
+	statusSummaryConnected: "飞书长连接已建立，机器人可以收发消息。",
+	statusSummaryUnconfigured: "尚未配置飞书应用凭据：插件已加载，但不会连接飞书。填写凭据并保存后会自动连接。",
+	statusSummaryIdle: "飞书应用凭据已就绪，但当前没有建立长连接。",
+	statusSummaryConnecting: "正在连接飞书长连接…",
+	statusSummaryError: "最近一次连接飞书失败，请检查凭据与网络后重试。",
+	lastError: "最近一次连接失败",
+	missingConfig: "缺少配置",
+	statusHintUnconfigured: "配置完成后插件会自动连接；也可以稍后在本页手动连接。",
+	connectionInfo: "连接信息",
+	connectionStateLabel: "飞书长连接",
+	botOpenId: "Bot open_id",
+	uptime: "运行时长",
+	routeCount: "话题路由",
+	liveAgentCount: "活动会话",
+	inflightTurnCount: "在途回复",
+	healthReasons: "健康判定",
+	unknownValue: "—",
+	connect: "连接飞书",
+	connecting: "连接中…",
+	onboardingTitle: "开始使用飞书渠道",
+	onboardingIntro: "只需三步：在飞书开放平台创建自建应用，把 App ID / App Secret 填入本页，保存后自动连接。",
+	onboardingStep1Title: "创建飞书自建应用",
+	onboardingStep1Text: "在飞书开放平台创建企业自建应用，开启机器人能力；事件订阅选择「长连接」，订阅 im.message.receive_v1（接收消息）。",
+	onboardingStep2Title: "填写应用凭据",
+	onboardingStep2Text: "把应用的 App ID（cli_ 开头）与 App Secret 填入下方「飞书应用凭据」，值会写入 DSH 凭据库。",
+	onboardingStep3Title: "保存并等待连接",
+	onboardingStep3Text: "两项凭据都保存后插件会自动连接；状态变为「已连接」即可在飞书里私聊机器人。",
+	onboardingDocsHint: "开放平台地址：open.feishu.cn/app；应用需要开通 im:message、im:message:send_as_bot 等消息权限。",
 	credentialsCard: "飞书应用凭据",
-	modelCard: "模型与推理",
-	modelCardHelp: "模型服务商、模型 id、推理档位与新会话的 Agent 预设。下拉选项来自宿主机实时目录；保存后对新会话生效。",
-	configCard: "常用配置",
-	advancedCard: "只读与高级信息",
+	credentialsCardHelp: "凭据值经 DSH 凭据服务写入本机凭据库；面板只显示「已配置 / 未配置」，永不回显已存值。两项都配置后才会连接飞书。",
 	appIdLabel: "飞书 App ID",
 	appSecretLabel: "飞书 App Secret",
-	credentialsHelp: "值通过 DSH 凭据服务写入本机凭据库；面板只显示是否已配置，永不回显已存值。留空表示保持当前值。",
 	credentialsRef: "凭据引用",
 	saveCredentials: "保存凭据",
 	savingCredentials: "保存中…",
 	credentialSaved: "凭据已保存",
-	credentialSavedReconnected: "凭据已保存，已自动重连飞书通道",
+	credentialSavedReconnected: "凭据已保存，飞书已连接",
 	credentialSavedPending: "凭据已保存，重启飞书连接后生效",
+	credentialSavedUnconfigured: "凭据已保存；还缺少另一项凭据，补齐后会自动连接",
+	credentialAutoConnectFailed: "凭据已保存，但自动连接失败",
 	credentialRemoved: "已移除存储的凭据",
 	credentialRemovedPending: "已移除存储的凭据，重启飞书连接后生效",
 	removeCredential: "移除已存值",
@@ -8437,35 +8589,56 @@ const PANEL_COPY = {
 	credentialReadOnly: "当前凭据存储不可写",
 	appIdPlaceholder: "输入 App ID（cli_…）",
 	appSecretPlaceholder: "输入 App Secret",
-	save: "保存配置",
-	saveAll: "保存全部配置",
-	saveModel: "保存模型配置",
-	modelActionsHint: "只保存模型与推理字段",
+	credentialsPendingHint: "填写后点「保存凭据」；两项齐全时插件会自动连接飞书。",
+	connectionTabHelp: "连接状态与飞书应用凭据。凭据不完整时不会连接飞书。",
+	sessionsTabHelp: "私聊、群聊触发方式与入站内容；「需重连」项在下次连接时读取。",
+	modelTabHelp: "飞书会话使用的模型服务商、模型、推理档位与 Agent 预设；下拉选项来自宿主机实时目录，保存后对新会话生效。",
+	workspaceTabHelp: "每个飞书话题一个独立工作区（模型/工具产生文件的落点）；只影响之后新建的话题。",
+	accessTabHelp: "准入采用 fail-closed：管理员不受白名单限制，非管理员私聊会被拒绝，群聊需要「群已授权 + 用户在白名单」两层同时命中。",
+	advancedTabHelp: "流式刷新等低层参数、Web 覆盖文件与只读信息。",
+	save: "保存更改",
 	saving: "保存中…",
+	saveHintDirty: "只保存改动过的字段；标注「需重连」的项在下次连接时生效。",
+	discardTab: "放弃本页更改",
+	saveHintClean: "没有未保存的更改。",
+	dirtyCount: "未保存项",
+	browseDirectory: "选择目录…",
+	browsingDirectory: "选择中…",
+	directoryPicked: "已选择目录",
+	directoryPickFailed: "无法打开系统目录选择器",
+	saved: "已保存",
+	cleared: "已清除 Web 覆盖，恢复为 profile 配置",
 	clear: "清除 Web 覆盖",
 	clearing: "清除中…",
+	noOverrides: "当前没有 Web 覆盖",
+	overridden: "Web 覆盖",
+	inherited: "继承 profile",
+	restartTag: "需重连",
+	restartBanner: "以下配置需重启飞书连接后生效：",
+	restartWarning: "重启会断开当前飞书长连接并中断进行中的回复，请确认空闲时操作。",
 	reconnect: "重启飞书连接",
 	reconnecting: "重连中…",
 	refresh: "刷新状态",
 	retry: "重试",
+	pollFailed: "状态刷新失败",
+	connectDone: "已连接飞书",
+	reconnectDone: "已重启飞书连接",
+	saveInvalid: "请先修正标红的配置项",
+	enabled: "已启用",
+	disabled: "已关闭",
+	credentialRemoveConfirm: "确定移除已存储的凭据值？移除后不会回显，需要时须重新填写。",
+	accessNotLoaded: "飞书连接建立后加载授权列表",
 	loading: "加载中…",
 	loadFailed: "设置面板加载失败",
-	saved: "已保存",
-	savedModel: "模型配置已保存",
-	cleared: "已清除 Web 覆盖，恢复为 profile 配置",
 	catalogFailed: "模型目录加载失败，已退回手填。",
 	catalogLoading: "正在读取宿主机选项…",
 	catalogUnavailable: "宿主机未提供可选项，请手填。",
-	noOverrides: "当前没有 Web 覆盖",
-	overridden: "Web 覆盖",
-	inherited: "继承 profile",
-	restartTag: "需重连",
-	restartBanner: "以下配置需重启飞书连接后生效：",
-	restartWarning: "重启会断开当前飞书长连接并中断进行中的回复，请确认空闲时操作。",
-	lastError: "最近一次启动失败",
-	notRunning: "未运行",
 	version: "插件版本",
 	overlayPath: "覆盖文件",
+	overlayPathHelp: "可以直接编辑该 JSON 文件；面板保存会整体重写它，「清除 Web 覆盖」会删除它并回落到 profile 配置。",
+	advancedCard: "只读与高级信息",
+	advancedHelp: "这些值来自 profile 配置，不能在面板里编辑。",
+	readOnlyCard: "部署级参数",
 	cleanupCard: "工作区清理",
 	cleanupCardHelp: "删除超过保留期且不再活跃的飞书工作区目录；只会删除本插件在「工作区根目录」下创建的目录，DSH 会话日志不删除。删除不可恢复：相关旧话题会失效并提示已过期，工作区列表记录同步移除。",
 	cleanupRetention: "保留期",
@@ -8480,7 +8653,7 @@ const PANEL_COPY = {
 	cleanupRunning: "清理中…",
 	cleanupConfirm: "确定清理过期工作区吗？该操作不可恢复，会删除这些工作区内的全部文件（包括 attachments/ 附件）。",
 	cleanupConfirmHint: "删除前会再次确认；保留期为「关闭」或没有过期工作区时按钮不可用。",
-	cleanupDisabledOff: "保留策略为「关闭」：请先在「常用配置 → 工作区与文件」中选择保留天数。",
+	cleanupDisabledOff: "保留策略为「关闭」：请先在上方「过期工作区保留期」中选择保留天数。",
 	cleanupDisabledEmpty: "没有超过保留期的过期工作区。",
 	cleanupPreviewFailed: "无法读取清理预览",
 	cleanupDone: "清理完成",
@@ -8490,12 +8663,9 @@ const PANEL_COPY = {
 	cleanupFreed: "释放空间",
 	cleanupFailures: "以下工作区未能删除：",
 	accessCard: "访问与授权",
-	accessCardHelp: "准入采用 fail-closed：管理员不受白名单限制（私聊、任意群聊都可直接对话）；非管理员私聊会被拒绝，群聊需要「群已授权 + 用户在白名单」两层同时命中。管理员 open_id 在「常用配置 → 行为」中填写，私聊机器人发送 /userid 获取。",
+	accessCardHelp: "准入采用 fail-closed：管理员不受白名单限制（私聊、任意群聊都可直接对话）；非管理员私聊会被拒绝，群聊需要「群已授权 + 用户在白名单」两层同时命中。管理员与准入模式在上方「准入与授权」中编辑；私聊机器人发送 /userid 获取自己的 open_id。",
 	accessModeOpenWarning: "当前准入模式为开放（open）：应用可用范围内的任何人都能开启对话。该模式不安全，仅建议调试时使用。",
-	accessAdminMissingWarning: "当前准入=guarded 但未配置管理员，所有对话都会被拒绝。请先在「常用配置 → 行为 → 管理员 open_id」填写。",
-	accessAdminLabel: "管理员",
-	accessAdminMissing: "未配置",
-	accessAdminHint: "修改管理员请到「常用配置 → 行为 → 管理员 open_id」；私聊机器人发送 /userid 可查看自己的 open_id（ou_ 开头，不是 user_id/邮箱）。",
+	accessAdminMissingWarning: "当前准入=guarded 但未配置管理员，所有对话都会被拒绝。请在上方「准入与授权」填写管理员 open_id。",
 	accessGroupsTitle: "已授权群",
 	accessGroupsEmpty: "尚未授权任何群。机器人被拉进群后，管理员会收到带 chat_id 的群信息卡；也可在群内发送 /groupid 获取。",
 	accessUsersTitle: "已授权用户",
@@ -8951,7 +9121,7 @@ function registerSettingsRoutes(server, surface) {
 					return;
 				}
 				const result = await surface.reconnect();
-				sendJson(res, result.ok ? 200 : 500, result);
+				sendJson(res, result.ok ? 200 : result.unconfigured === true ? 400 : 500, result);
 			})
 		}),
 		server.register({
@@ -8967,6 +9137,41 @@ function registerSettingsRoutes(server, surface) {
 				sendJson(res, result.ok ? 200 : 500, result);
 			})
 		}),
+		server.register({
+			kind: "exact",
+			path: PICK_DIRECTORY_ROUTE,
+			handler: guarded(async (req, res) => {
+				if (!allowOnly(req, res, ["POST"])) return;
+				if (!isSameOriginRequest(req)) {
+					forbiddenWrite(res);
+					return;
+				}
+				const controller = new AbortController();
+				let answered = false;
+				if (typeof res.on === "function") res.on("close", () => {
+					if (!answered) controller.abort();
+				});
+				let path;
+				try {
+					path = await surface.pickDirectory(controller.signal);
+				} catch (error) {
+					answered = true;
+					if (controller.signal.aborted) {
+						res.end();
+						return;
+					}
+					throw error;
+				}
+				answered = true;
+				sendJson(res, 200, path === null ? {
+					ok: true,
+					canceled: true
+				} : {
+					ok: true,
+					path
+				});
+			})
+		}),
 		server.register({
 			kind: "exact",
 			path: ACCESS_ROUTE,
@@ -9180,7 +9385,7 @@ const FIELD_META = {
 	},
 	authRequestTtlDays: {
 		label: "授权申请有效期（天）",
-		help: "入群/用户授权申请卡的有效期，1–30 天；过期后卡片需重新触发申请（也可直接在「访问与授权」面板处理）。",
+		help: "入群/用户授权申请卡的有效期，1–30 天；过期后卡片需重新触发申请（也可在本页下方「待处理申请」中处理）。",
 		min: 1,
 		max: 30,
 		step: 1
@@ -9245,9 +9450,9 @@ const GROUP_OF = {
 	threadFallback: "behavior",
 	welcomeOnboarding: "behavior",
 	allowPermissionSwitch: "behavior",
-	adminOpenId: "behavior",
-	accessMode: "behavior",
-	authRequestTtlDays: "behavior",
+	adminOpenId: "access",
+	accessMode: "access",
+	authRequestTtlDays: "access",
 	acceptAttachments: "content",
 	provider: "model",
 	model: "model",
@@ -9343,6 +9548,22 @@ function withCurrentOption(options, value) {
 		...rest
 	];
 }
+/**
+* Mark the workspace-root field as browsable when the host can open its native
+* directory chooser. Every other host (no `directoryPicker`, or the `browse`
+* backend of remote/headless sessions) keeps the plain text input.
+*
+* @param fields - Host field descriptors after the selector catalog is applied.
+* @param available - whether a native directory chooser can be opened.
+* @returns the descriptors with `browse: 'directory'` on `baseDir` when usable.
+*/
+function withDirectoryBrowse(fields, available) {
+	if (!available) return [...fields];
+	return fields.map((field) => field.key === "baseDir" ? {
+		...field,
+		browse: "directory"
+	} : field);
+}
 function messageOf$1(error) {
 	return error instanceof Error ? error.message : String(error);
 }
@@ -9467,12 +9688,28 @@ function readOnlyFields(config) {
 		}
 	];
 }
+/**
+* Derive the panel phase from readiness + runtime facts. The order matters:
+* an incomplete configuration always wins (no connection is attempted), and a
+* failed attempt is only reported while the channel is stopped.
+*/
+function phaseOf(target) {
+	if (target.isRestarting()) return "connecting";
+	if (target.isConnecting()) return target.isConfigured() ? "connecting" : "unconfigured";
+	if (target.isRunning()) return "connected";
+	if (!target.isConfigured()) return "unconfigured";
+	if (target.startError() !== void 0) return "error";
+	return "idle";
+}
 /** Assemble the status half of the panel payload. */
 function buildStatus(target, overlayPath) {
 	const health = target.health();
 	const connection = health.connection;
 	return {
 		running: target.isRunning(),
+		configured: target.isConfigured(),
+		phase: phaseOf(target),
+		missingConfig: [...target.missingConfig()],
 		level: health.level,
 		startedAt: target.startedAtMs(),
 		uptimeMs: target.uptimeMs(),
@@ -9490,7 +9727,7 @@ function buildStatus(target, overlayPath) {
 		reasons: health.reasons,
 		version: DSH_CHANNELS_VERSION,
 		overlayPath,
-		busy: target.isRestarting()
+		busy: target.isRestarting() || target.isConnecting()
 	};
 }
 /**
@@ -9505,14 +9742,41 @@ var SettingsSurface = class {
 	store;
 	logger;
 	catalog;
-	constructor(target, store, logger, catalog) {
+	directoryPicker;
+	constructor(target, store, logger, catalog, directoryPicker) {
 		this.target = target;
 		this.store = store;
 		this.logger = logger;
 		this.catalog = catalog;
+		this.directoryPicker = directoryPicker;
+	}
+	/**
+	* Re-read credential presence. The credentials store is hot-reloaded from
+	* disk, so a value edited outside the panel becomes visible within one poll
+	* instead of only after a restart/connect.
+	*/
+	async syncReadiness() {
+		try {
+			await this.target.refreshReadiness();
+		} catch (error) {
+			this.logger?.warn?.("dsh-channels: 凭据状态刷新失败：%s", messageOf$1(error));
+		}
+	}
+	/**
+	* Reject panel writes while the connection lifecycle is in flight: saving an
+	* overlay or credentials then would race `applyOverlay()`/`start()` and can
+	* record a running-config snapshot that never took effect.
+	*/
+	writeBusy() {
+		if (!this.target.isRestarting() && !this.target.isConnecting()) return void 0;
+		return {
+			ok: false,
+			error: "飞书连接正在连接或重启，请稍候再试"
+		};
 	}
 	/** Wire status only (used by the client's 5 s poll). */
 	async status() {
+		await this.syncReadiness();
 		return buildStatus(this.target, this.store.file);
 	}
 	/**
@@ -9531,6 +9795,7 @@ var SettingsSurface = class {
 	}
 	/** Status + editable config with provenance + read-only facts. */
 	async panel() {
+		await this.syncReadiness();
 		const base = this.target.baseConfigSnapshot();
 		const effective = this.target.configSnapshot();
 		const overlay = await this.store.load();
@@ -9538,12 +9803,12 @@ var SettingsSurface = class {
 		const overriddenKeys = EDITABLE_KEYS.filter((key) => overlay[key] !== void 0);
 		const restartPendingKeys = this.target.isRunning() && running !== void 0 ? RESTART_KEYS.filter((key) => effective[key] !== running[key]) : [];
 		const catalog = await this.catalogFor(effective.provider, effective.model);
-		const fields = applyCatalog(FIELD_DESCRIPTORS, catalog, {
+		const fields = withDirectoryBrowse(applyCatalog(FIELD_DESCRIPTORS, catalog, {
 			provider: effective.provider,
 			model: effective.model,
 			reasoningEffort: effective.reasoningEffort,
 			agentPreset: effective.agentPreset
-		});
+		}), this.directoryPicker?.available === true);
 		let credentialStates = {
 			appId: {
 				configured: false,
@@ -9591,6 +9856,7 @@ var SettingsSurface = class {
 			access = {
 				mode: effective.accessMode,
 				admin: { configured: false },
+				loaded: false,
 				groups: [],
 				users: [],
 				requests: []
@@ -9614,6 +9880,8 @@ var SettingsSurface = class {
 	}
 	/** Validate + persist a partial edit; live fields take effect immediately. */
 	async save(values) {
+		const busy = this.writeBusy();
+		if (busy !== void 0) return busy;
 		const unknown = Object.keys(values).filter((key) => !EDITABLE_KEYS.includes(key));
 		if (unknown.length > 0) return {
 			ok: false,
@@ -9696,6 +9964,8 @@ var SettingsSurface = class {
 	}
 	/** Drop every Web override and fall back to the profile config. */
 	async clear() {
+		const busy = this.writeBusy();
+		if (busy !== void 0) return busy;
 		try {
 			await this.store.clear();
 		} catch (error) {
@@ -9712,6 +9982,8 @@ var SettingsSurface = class {
 	}
 	/** Write provided credential values through the host seam (never echoed back). */
 	async saveCredentials(values) {
+		const busy = this.writeBusy();
+		if (busy !== void 0) return busy;
 		const writes = [];
 		const issues = [];
 		for (const field of ["appId", "appSecret"]) {
@@ -9751,6 +10023,8 @@ var SettingsSurface = class {
 	}
 	/** Remove the stored value behind one credential reference. */
 	async clearCredential(field) {
+		const busy = this.writeBusy();
+		if (busy !== void 0) return busy;
 		if (field !== "appId" && field !== "appSecret") return {
 			ok: false,
 			error: "未知的凭据字段"
@@ -9766,9 +10040,11 @@ var SettingsSurface = class {
 		return this.finishCredentialChange("clear");
 	}
 	/**
-	* Credential values are resolved on connect. When the channel is stopped,
-	* retry immediately (nothing to interrupt); when it is running, ask the user
-	* to reconnect. A failed retry still reports the save as successful.
+	* Credential values are resolved on connect. Opening a connection is gated on
+	* readiness: saving one half of the pair stores the value but keeps the
+	* plugin idle until the other half exists. When the channel is stopped and
+	* the pair is complete, connect immediately (nothing to interrupt); when it
+	* is running, the user reconnects to pick the value up.
 	*/
 	async finishCredentialChange(kind) {
 		if (this.target.isRunning()) return {
@@ -9776,13 +10052,13 @@ var SettingsSurface = class {
 			panel: await this.panel(),
 			reconnect: "pending"
 		};
-		if (kind === "clear") return {
+		if (kind === "clear" || !this.target.isConfigured()) return {
 			ok: true,
 			panel: await this.panel(),
-			reconnect: "not-needed"
+			reconnect: kind === "clear" ? "not-needed" : "unconfigured"
 		};
 		try {
-			await this.target.restart();
+			await this.target.connect();
 			return {
 				ok: true,
 				panel: await this.panel(),
@@ -9792,21 +10068,39 @@ var SettingsSurface = class {
 			return {
 				ok: true,
 				panel: await this.panel(),
-				reconnect: "auto",
+				reconnect: "failed",
 				autoReconnectError: messageOf$1(error)
 			};
 		}
 	}
-	/** Close and reopen the Feishu long connection with the latest config. */
+	/**
+	* The panel's single connect/reconnect action: reopen a running connection,
+	* or open the first one when the channel is stopped. Credentials must be
+	* complete — otherwise the panel points the user back at the credentials form
+	* instead of surfacing a startup error.
+	*/
 	async reconnect() {
+		await this.syncReadiness();
+		if (!this.target.isConfigured()) return {
+			ok: false,
+			error: "飞书应用凭据尚未配置完整，请先填写 App ID 与 App Secret 并保存",
+			unconfigured: true
+		};
+		const wasRunning = this.target.isRunning();
 		try {
-			await this.target.restart();
+			if (wasRunning) await this.target.restart();
+			else await this.target.connect();
 		} catch (error) {
 			return {
 				ok: false,
-				error: `重连失败：${messageOf$1(error)}`
+				error: `${wasRunning ? "重连" : "连接"}失败：${messageOf$1(error)}`
 			};
 		}
+		if (!this.target.isRunning()) return {
+			ok: false,
+			unconfigured: !this.target.isConfigured(),
+			error: this.target.startError() ?? (this.target.isConfigured() ? "飞书连接未建立" : "飞书应用凭据尚未配置完整，请先填写并保存凭据")
+		};
 		return {
 			ok: true,
 			panel: await this.panel()
@@ -9890,11 +10184,24 @@ var SettingsSurface = class {
 		}
 	}
 	/**
+	* Open the host's native directory chooser (the panel's「选择目录…」button).
+	*
+	* @param signal - caller lifetime; abort closes the OS dialog.
+	* @returns the chosen absolute path, or `null` when the operator cancels.
+	* @throws when the host provides no native directory chooser.
+	*/
+	async pickDirectory(signal) {
+		if (this.directoryPicker === void 0) throw new Error(PANEL_COPY.directoryPickFailed);
+		return await this.directoryPicker.pick(signal);
+	}
+	/**
 	* Run the workspace-retention cleanup once. Irreversible deletions are the
 	* target's responsibility; the surface only reports the outcome and returns
 	* a refreshed panel (its cleanup preview then reflects the remaining workspaces).
 	*/
 	async runCleanup() {
+		const busy = this.writeBusy();
+		if (busy !== void 0) return busy;
 		let result;
 		try {
 			result = await this.target.runWorkspaceCleanup();
@@ -10158,6 +10465,68 @@ function createHostCatalog(ctx, warn) {
 	} };
 }
 //#endregion
+//#region src/settings/directory-picker.ts
+/** 取出 native 能力；服务缺失、后端为 browse 或 capability 抛错都返回 undefined。 */
+function nativeCapability(service) {
+	if (service === void 0 || typeof service.capability !== "function") return void 0;
+	let capability;
+	try {
+		capability = service.capability();
+	} catch {
+		return;
+	}
+	if (typeof capability !== "object" || capability === null) return void 0;
+	const record = capability;
+	if (record.kind !== "native" || typeof record.pick !== "function") return void 0;
+	return capability;
+}
+/**
+* 从宿主上下文取出可用的系统目录选择器。
+*
+* 解析是**惰性**的：插件可能先于 `dsh-web-app` 的 directory-picker 行完成
+* apply，而设置面板只会在宿主全部加载完成后被请求。因此 `available` 与
+* `pick()` 每次都按需解析（成功结果缓存；失败不缓存，晚挂载的服务仍能被
+* 发现），避免把加载时序固化成「永远没有按钮」。
+*
+* @param ctx - 宿主上下文；`ctx.get('directoryPicker')` 是可选服务。
+* @returns picker；`available` 为 false 时面板保留手写输入。
+*/
+function createSettingsDirectoryPicker(ctx) {
+	let resolved;
+	const resolve = () => {
+		if (resolved !== void 0) return resolved;
+		try {
+			const service = ctx.get?.("directoryPicker");
+			resolved = nativeCapability(service);
+		} catch {
+			resolved = void 0;
+		}
+		return resolved;
+	};
+	/** 互斥：一个原生模态框同时只应存在一个（双击/多标签页不得叠窗）。 */
+	let picking = false;
+	return {
+		get available() {
+			return resolve() !== void 0;
+		},
+		async pick(signal) {
+			const capability = resolve();
+			if (capability === void 0) throw new Error("当前宿主机不提供系统目录选择器");
+			if (picking) throw new Error("已有目录选择窗口正在打开");
+			if (signal.aborted) return null;
+			picking = true;
+			try {
+				const picked = await capability.pick.call(capability, signal);
+				if (picked === null || picked === void 0) return null;
+				if (typeof picked !== "string" || picked.trim() === "") throw new Error("目录选择器返回了无效路径");
+				return picked;
+			} finally {
+				picking = false;
+			}
+		}
+	};
+}
+//#endregion
 //#region src/index.ts
 /** Cordis function-plugin name. */
 const name = "channels";
@@ -10188,7 +10557,7 @@ const inject = [
 * its `resolveConfig()` fallback for direct invocation (unit tests, embedded
 * hosts) where config has not been pre-validated.
 */
-const Config = configSchema;
+const Config = pluginConfigSchema;
 /**
 * Install the bridge. Credentials stay references here — the actual secrets
 * resolve through `ctx.credentials` (env > `$DSH_HOME/.credentials.yaml`
@@ -10202,16 +10571,16 @@ function apply(ctx, config) {
 	const warn = (message, ...args) => {
 		ctx.logger?.warn?.(message, ...args);
 	};
-	mountSettingsRoutes(ctx, new SettingsSurface(service, overlay, { warn }, createHostCatalog(ctx, warn)));
+	mountSettingsRoutes(ctx, new SettingsSurface(service, overlay, { warn }, createHostCatalog(ctx, warn), createSettingsDirectoryPicker(ctx)));
 	ctx.effect(() => {
 		service.boot().catch((error) => {
-			ctx.logger?.error?.("dsh-channels failed to start: %s", String(error));
-			console.error("[dsh-channels] failed to start:", error);
+			ctx.logger?.error?.("dsh-channels failed to boot: %s", String(error));
+			console.error("[dsh-channels] failed to boot:", error);
 		});
 		return () => service.shutdown();
 	}, "dsh-channels");
 }
 //#endregion
-export { AccessController, AccessRequests, AccessStore, ApprovalAnswerer, CARD_MAX_BYTES, CARD_PANEL_RESERVE_BYTES, CARD_TARGET_BYTES, CATALOG_ROUTE, CHANNEL_COMMAND_NAMES, CLEANUP_ROUTE, CONFIG_ROUTE, CREDENTIALS_ROUTE, Config, DM_DENY_TEXT, DM_UNCONFIGURED_TEXT, DSH_CHANNELS_VERSION, EDITABLE_KEYS, EMPTY_TOTALS, FIELD_DESCRIPTORS, FeishuService, HEALTH_DEPENDENCY_NAMES, INTERRUPTION_NOTICE, LOGICAL_EXPORT_FORMAT, LOGICAL_EXPORT_FORMAT_VERSION, MAX_QUESTION_OPTIONS, MAX_TABLES_PER_CARD, OverlayStore, PANEL_CHEVRON_TOKEN, PANEL_COPY, PANEL_ROUTE, PANEL_TITLES, QuestionAnswerer, REASONING_MAX_BYTES, RECONNECT_ROUTE, RESTART_KEYS, RouteOperationQueue, SESSION_HISTORY_DISPLAY_LIMIT, STATUS_ROUTE, SUPPORTED_COMMAND_NAMES, SettingsSurface, TRUNCATION_SUFFIX, TurnStreamer, accessGroupRecordSchema, accessRequestRecordSchema, accessUserRecordSchema, addUsage, appendSessionHistory, apply, applyCatalog, applyProjectionViews, armModelCommand, averageDecodeTokensPerSecond, averageTtftMs, buildApprovalCard, buildApprovalSettledCard, buildCard, buildCommandResultCard, buildCompactComparisonCard, buildGroupInfoCard, buildHealthCard, buildInterruptionCard, buildQuestionCard, buildQuestionSettledCard, buildRenewCard, buildRequestSettledCard, buildSessionHistoryCard, buildSessionStatusCard, buildUserRequestCard, buildWorkDirCard, cacheHitPct, cardJsonBytes, chatRouteKey, commandResultCardKind, compactFailureContext, countFiberStates, createHostCatalog, createLogicalSessionExport, decideAccess, defaultOverlayPath, emptyCatalog, ensureWorkspace, expiredRouteRecordSchema, feishuDomain, foldAll, foldEvent, foldHealthSnapshot, foldSessionStats, inflightSnapshotSchema, inject, isAdminOpenId, isSameOriginRequest, isSupportedCommand, maskOpenIdTail, measureSessionContext, mergeOverlay, mountSettingsRoutes, name, normalizeCredentialValue, normalizeOverlay, normalizeRouteRecord, normalizeSessionHistory, parseOverlay, parseSlashCommand, pickEditable, processedRecordSchema, querySessionHistory, readOnlyFields, readProjectionViews, registerChannelCommands, registerModelCommand, registerSettingsRoutes, resolveDshHome, resolveWorkDir, routeRecordSchema, segmentCardContent, serializeLogicalSession, sessionHistoryEntrySchema, splitBodyForCard, stagingPathFor, stripTables, supportedCommandHelp, supportedCommandList, tableBlocks, topicTokenFor, usageFromBuckets, workspacePathFor, workspaceTitleFor };
+export { AccessController, AccessRequests, AccessStore, ApprovalAnswerer, CARD_MAX_BYTES, CARD_PANEL_RESERVE_BYTES, CARD_TARGET_BYTES, CATALOG_ROUTE, CHANNEL_COMMAND_NAMES, CLEANUP_ROUTE, CONFIG_ROUTE, CREDENTIALS_ROUTE, Config, DM_DENY_TEXT, DM_UNCONFIGURED_TEXT, DSH_CHANNELS_VERSION, EDITABLE_KEYS, EMPTY_TOTALS, FIELD_DESCRIPTORS, FeishuService, HEALTH_DEPENDENCY_NAMES, INTERRUPTION_NOTICE, LOGICAL_EXPORT_FORMAT, LOGICAL_EXPORT_FORMAT_VERSION, MAX_QUESTION_OPTIONS, MAX_TABLES_PER_CARD, OverlayStore, PANEL_CHEVRON_TOKEN, PANEL_COPY, PANEL_ROUTE, PANEL_TITLES, PICK_DIRECTORY_ROUTE, QuestionAnswerer, REASONING_MAX_BYTES, RECONNECT_ROUTE, RESTART_KEYS, RouteOperationQueue, SESSION_HISTORY_DISPLAY_LIMIT, STATUS_ROUTE, SUPPORTED_COMMAND_NAMES, SettingsSurface, TRUNCATION_SUFFIX, TurnStreamer, accessGroupRecordSchema, accessRequestRecordSchema, accessUserRecordSchema, addUsage, appendSessionHistory, apply, applyCatalog, applyProjectionViews, armModelCommand, averageDecodeTokensPerSecond, averageTtftMs, buildApprovalCard, buildApprovalSettledCard, buildCard, buildCommandResultCard, buildCompactComparisonCard, buildGroupInfoCard, buildHealthCard, buildInterruptionCard, buildQuestionCard, buildQuestionSettledCard, buildRenewCard, buildRequestSettledCard, buildSessionHistoryCard, buildSessionStatusCard, buildUserRequestCard, buildWorkDirCard, cacheHitPct, cardJsonBytes, chatRouteKey, commandResultCardKind, compactFailureContext, countFiberStates, createHostCatalog, createLogicalSessionExport, createSettingsDirectoryPicker, decideAccess, defaultOverlayPath, emptyCatalog, ensureWorkspace, expiredRouteRecordSchema, feishuDomain, foldAll, foldEvent, foldHealthSnapshot, foldSessionStats, inflightSnapshotSchema, inject, isAdminOpenId, isSameOriginRequest, isSupportedCommand, maskOpenIdTail, measureSessionContext, mergeOverlay, mountSettingsRoutes, name, normalizeCredentialValue, normalizeOverlay, normalizeRouteRecord, normalizeSessionHistory, parseOverlay, parseSlashCommand, pickEditable, processedRecordSchema, querySessionHistory, readOnlyFields, readProjectionViews, registerChannelCommands, registerModelCommand, registerSettingsRoutes, resolveDshHome, resolveWorkDir, routeRecordSchema, segmentCardContent, serializeLogicalSession, sessionHistoryEntrySchema, splitBodyForCard, stagingPathFor, stripTables, supportedCommandHelp, supportedCommandList, tableBlocks, topicTokenFor, usageFromBuckets, withDirectoryBrowse, workspacePathFor, workspaceTitleFor };
 
 //# sourceMappingURL=index.js.map