@dsh-cove/dsh-web-all 0.0.0-stage → 0.4.3

package/lib/types/client/conversation/worktree/lane-workspace-sweeper.js

@@ -0,0 +1,116 @@
+/**
+ * Retire the sidebar row of a lane whose conversations are all archived.
+ *
+ * Why a lane ever has a workspace row
+ *   The platform accounts a session to a workspace only while the session's cwd
+ *   equals that workspace's path (`WorkspaceEntity.sessionIds` filters by the
+ *   session's path, and `attachSession` refuses any other cwd), and a blank
+ *   conversation that no workspace accounts for renders an inert composer
+ *   ("choose a workspace to start"). So the lane's directory must BE a workspace
+ *   while a conversation runs in it — that part is a platform requirement, not a
+ *   taste, and no plugin can avoid the row.
+ *
+ * What this owns
+ *   The row's LIFETIME. Once every conversation the lane accounts for is
+ *   archived, the registration is dead weight: the directory, the branch and the
+ *   manifest binding stay, so picking that branch again re-registers the
+ *   directory in one call. The host half retires the same way from archive
+ *   events; this half runs where the archive set is visible to the browser, so it
+ *   also cleans up rows an earlier build left behind — including on an
+ *   installation whose host bundle predates that change.
+ *
+ * Safety rules
+ *   - only paths that are this plugin's lane directories (`<repo>/.dsh/workspaces/<branch>`);
+ *   - only workspaces that account for at least one conversation (a lane created
+ *     moments ago has none yet, and must not be retired from under its setup);
+ *   - only when every accounted conversation is archived. A lane with a live
+ *     conversation keeps its workspace, or that conversation loses the workspace
+ *     it runs in.
+ * @module @dsh-cove/dsh-client-ui-worktree/client/lane-workspace-sweeper
+ */
+import { isLaneDirectory } from "../../../core/worktree/paths.js";
+/**
+ * The lane workspaces whose conversations are all archived, in snapshot order.
+ * @param snapshot - the client workspace snapshot.
+ * @returns workspace ids to retire.
+ */
+export function laneWorkspacesToRetire(snapshot) {
+    if (snapshot === undefined || snapshot.phase !== 'ready')
+        return [];
+    const archived = new Set(snapshot.archivedSessionIds ?? []);
+    const retiring = [];
+    for (const workspace of snapshot.items ?? []) {
+        const id = workspace.workspaceId;
+        const path = workspace.path;
+        const sessionIds = workspace.sessionIds ?? [];
+        if (id === undefined || path === undefined)
+            continue;
+        if (!isLaneDirectory(path))
+            continue;
+        // A lane created moments ago accounts for no conversation yet: its workspace
+        // is being set up and must survive the sweep.
+        if (sessionIds.length === 0)
+            continue;
+        // A live conversation needs the workspace it runs in.
+        if (!sessionIds.every((sessionId) => archived.has(sessionId)))
+            continue;
+        retiring.push(id);
+    }
+    return retiring;
+}
+/**
+ * Sweep once: delete the registration of every lane whose conversations are all
+ * archived. A failure is reported and does not stop the rest.
+ * @param faces - the workspace face and the warning sink.
+ * @returns the workspace ids that were retired.
+ */
+export async function sweepLaneWorkspaces(faces) {
+    const list = faces.workspaces?.list;
+    const remove = faces.workspaces?.delete;
+    if (list?.getSnapshot === undefined || remove === undefined)
+        return [];
+    const candidates = laneWorkspacesToRetire(list.getSnapshot());
+    const retired = [];
+    for (const workspaceId of candidates) {
+        try {
+            await remove.call(faces.workspaces, workspaceId);
+            retired.push(workspaceId);
+        }
+        catch (error) {
+            faces.warn?.('[dsh-worktree] could not retire a lane workspace:', error);
+        }
+    }
+    return retired;
+}
+/**
+ * Sweep on mount and on every workspace-list change (an archive, a new lane, a
+ * deletion). Sweeps never overlap: a change arriving mid-sweep queues one more
+ * pass, so the pass always sees the list the changes produced.
+ * @param faces - the workspace face and the warning sink.
+ * @returns the disposer (unsubscribes).
+ */
+export function mountLaneWorkspaceSweeper(faces) {
+    const list = faces.workspaces?.list;
+    if (list?.getSnapshot === undefined || list.subscribe === undefined)
+        return () => { };
+    let running = false;
+    let queued = false;
+    const run = () => {
+        if (running) {
+            queued = true;
+            return;
+        }
+        running = true;
+        void sweepLaneWorkspaces(faces).catch((error) => {
+            faces.warn?.('[dsh-worktree] lane workspace sweep failed:', error);
+        }).finally(() => {
+            running = false;
+            if (queued) {
+                queued = false;
+                run();
+            }
+        });
+    };
+    run();
+    return list.subscribe(run);
+}

package/lib/types/client/conversation/worktree/lifecycle.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Worktree lifecycle stage derivation (pure, shared with tests): given the
+ * disk truth and the latest status probe, classify a linked worktree into
+ * one of the four panel stages that drive its primary action.
+ *
+ * Also the single place that turns a client/host failure into localized copy:
+ * the panel and the dialogs must never print the host's English `message`
+ * verbatim in a Chinese UI, and a fence refusal must not read like a git bug.
+ * @module @dsh-cove/dsh-client-ui-worktree/client/lifecycle
+ */
+import type { Translate } from '@deepseek-ai/dsh-client-ui-slots';
+import type { WorktreeStatusView, WorktreeView } from '../../../core/worktree/types.ts';
+import type { WorktreeKey } from './locales.ts';
+/** Lifecycle stage of one linked worktree — drives the row's primary action. */
+export type WorktreeStage = 'missing' | 'developing' | 'in-review' | 'merged';
+export declare function stageOfWorktree(worktree: Pick<WorktreeView, 'exists' | 'branch'>, status: WorktreeStatusView | undefined): WorktreeStage;
+/**
+ * The localized key explaining one failure, or null when the error carries no
+ * known shape (the caller then shows its own message).
+ */
+export declare function worktreeErrorKeyOf(error: unknown): WorktreeKey | null;
+/**
+ * Render one failure as user-facing copy.
+ * @param error - any thrown value from the worktree API.
+ * @param t - the `worktree` namespace translator.
+ * @returns localized text, with the raw detail attached for the git/unreachable cases.
+ */
+export declare function worktreeErrorMessage(error: unknown, t: Translate<WorktreeKey>): string;
+//# sourceMappingURL=lifecycle.d.ts.map

package/lib/types/client/conversation/worktree/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../../src/client/conversation/worktree/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAA;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAGvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,gFAAgF;AAChF,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAA;AAE7E,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,QAAQ,CAAC,EACjD,MAAM,EAAE,kBAAkB,GAAG,SAAS,GACrC,aAAa,CAOf;AAmBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAOrE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,MAAM,CAMtF"}

package/lib/types/client/conversation/worktree/lifecycle.js

@@ -0,0 +1,67 @@
+/**
+ * Worktree lifecycle stage derivation (pure, shared with tests): given the
+ * disk truth and the latest status probe, classify a linked worktree into
+ * one of the four panel stages that drive its primary action.
+ *
+ * Also the single place that turns a client/host failure into localized copy:
+ * the panel and the dialogs must never print the host's English `message`
+ * verbatim in a Chinese UI, and a fence refusal must not read like a git bug.
+ * @module @dsh-cove/dsh-client-ui-worktree/client/lifecycle
+ */
+import { WorktreeApiError } from "./api.js";
+export function stageOfWorktree(worktree, status) {
+    if (!worktree.exists)
+        return 'missing';
+    if (status?.merged === true)
+        return 'merged';
+    // A pushed branch with a recorded PR url is under review; anything else
+    // is still developing (submit-PR is the next step).
+    if (status?.prUrl != null && status.prUrl !== '')
+        return 'in-review';
+    return 'developing';
+}
+/** The localized key for one domain error code. */
+function codeKeyOf(code) {
+    switch (code) {
+        case 'worktree-exists': return 'error.worktreeExists';
+        case 'worktree-not-found': return 'error.worktreeNotFound';
+        case 'not-a-repository': return 'error.notARepository';
+        case 'workspace-unknown': return 'error.workspaceUnknown';
+        case 'invalid-branch': return 'error.invalidBranch';
+        case 'worktree-busy': return 'error.worktreeBusy';
+        case 'not-merged': return 'error.notMerged';
+        case 'session-create-failed':
+        case 'session-unknown': return 'error.laneSession';
+        case 'lane-mismatch': return 'error.laneMismatch';
+        default: return 'error.gitFailed';
+    }
+}
+/**
+ * The localized key explaining one failure, or null when the error carries no
+ * known shape (the caller then shows its own message).
+ */
+export function worktreeErrorKeyOf(error) {
+    if (error instanceof WorktreeApiError) {
+        if (error.kind === 'permission')
+            return 'error.permissionDenied';
+        if (error.kind === 'malformed' || error.kind === 'transport')
+            return 'error.unreachable';
+        return codeKeyOf(error.code);
+    }
+    return null;
+}
+/**
+ * Render one failure as user-facing copy.
+ * @param error - any thrown value from the worktree API.
+ * @param t - the `worktree` namespace translator.
+ * @returns localized text, with the raw detail attached for the git/unreachable cases.
+ */
+export function worktreeErrorMessage(error, t) {
+    const detail = error instanceof Error ? error.message : String(error);
+    const key = worktreeErrorKeyOf(error);
+    if (key === null)
+        return detail;
+    if (key === 'error.gitFailed' || key === 'error.unreachable')
+        return t(key, { error: detail });
+    return t(key);
+}

package/lib/types/client/conversation/worktree/locales.d.ts

@@ -0,0 +1,58 @@
+/**
+ * `worktree` namespace dictionaries: the conversation header chip's popover
+ * (facts, the PR action, and one delete action) and the dialogs it opens.
+ * zh is the key-set source of truth; en must keep the exact same key set.
+ *
+ * Copy rule (issue: the names were unreadable): these strings are what the user
+ * reads, so they say "分支目录 / branch directory" and never the implementation
+ * words `worktree` or `lane`. `tests/worktree-client-locales.spec.ts` enforces
+ * that on both dictionaries.
+ */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'menu.aria': string;
+    'menu.path': string;
+    'menu.pr': string;
+    'menu.delete': string;
+    'menu.refresh': string;
+    'menu.running': string;
+    'menu.selfTeardown': string;
+    'worktree.prTitle': string;
+    'worktree.prDescription': string;
+    'worktree.prBase': string;
+    'worktree.prConfirm': string;
+    'worktree.prOpen': string;
+    'worktree.prSuccess': string;
+    'worktree.deleteTitle': string;
+    'worktree.deleteDescription': string;
+    'worktree.deleteBranch': string;
+    'worktree.deleteBranchHint': string;
+    'worktree.deleteForce': string;
+    'worktree.deleteForceWarning': string;
+    'worktree.deleteConfirm': string;
+    'dialog.close': string;
+    'dialog.cancel': string;
+    'dialog.confirm': string;
+    'error.gitFailed': string;
+    'error.worktreeExists': string;
+    'error.worktreeNotFound': string;
+    'error.notARepository': string;
+    'error.workspaceUnknown': string;
+    'error.invalidBranch': string;
+    'error.worktreeBusy': string;
+    'error.notMerged': string;
+    'error.laneSession': string;
+    'error.laneMismatch': string;
+    'error.permissionDenied': string;
+    'error.unreachable': string;
+};
+/** The worktree namespace key union. */
+export type WorktreeKey = keyof typeof zh;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        worktree: WorktreeKey;
+    }
+}
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: Record<WorktreeKey, string>;
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/conversation/worktree/locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../../../src/client/conversation/worktree/locales.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,mEAAmE;AACnE,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCmB,CAAA;AAElC,wCAAwC;AACxC,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAA;AAEzC,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,kBAAkB;QAC1B,QAAQ,EAAE,WAAW,CAAA;KACtB;CACF;AAED,mEAAmE;AACnE,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAoC1C,CAAA"}

package/lib/types/client/conversation/worktree/locales.js

@@ -0,0 +1,86 @@
+/**
+ * `worktree` namespace dictionaries: the conversation header chip's popover
+ * (facts, the PR action, and one delete action) and the dialogs it opens.
+ * zh is the key-set source of truth; en must keep the exact same key set.
+ *
+ * Copy rule (issue: the names were unreadable): these strings are what the user
+ * reads, so they say "分支目录 / branch directory" and never the implementation
+ * words `worktree` or `lane`. `tests/worktree-client-locales.spec.ts` enforces
+ * that on both dictionaries.
+ */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export const zh = {
+    'menu.aria': '管理该分支的目录（{branch}）',
+    'menu.path': '目录',
+    'menu.pr': '提交 PR',
+    'menu.delete': '删除…',
+    'menu.refresh': '检查是否已合并',
+    'menu.running': '当前对话正在运行：请先停止本轮，再删除。',
+    'menu.selfTeardown': '该目录属于当前对话：删除会一并归档本对话。',
+    'worktree.prTitle': '为「{name}」提交 PR',
+    'worktree.prDescription': '推送该分支并创建 pull request。默认打开 GitHub 对比页；配置了 GitHub token 时直接调用 API 创建。',
+    'worktree.prBase': '目标分支（base）',
+    'worktree.prConfirm': '推送并创建 PR',
+    'worktree.prOpen': '打开 PR',
+    'worktree.prSuccess': '分支已推送，PR 已就绪：',
+    'worktree.deleteTitle': '删除「{name}」',
+    'worktree.deleteDescription': '删除该分支的目录与记录，并归档它的对话。',
+    'worktree.deleteBranch': '同时删除本地分支',
+    'worktree.deleteBranchHint': '不勾选时只删目录，本地分支保留，之后还能再用它建目录。',
+    'worktree.deleteForce': '强制删除（丢弃未提交改动；未合并的分支也删）',
+    'worktree.deleteForceWarning': '强制会丢弃未提交改动；未合并的分支也会被删除，不可恢复。',
+    'worktree.deleteConfirm': '删除',
+    'dialog.close': '关闭',
+    'dialog.cancel': '取消',
+    'dialog.confirm': '确定',
+    'error.gitFailed': 'git 操作失败：{error}',
+    'error.worktreeExists': '同名分支已存在，请换个名字，或先删掉旧分支。',
+    'error.worktreeNotFound': '没有找到这个目录。',
+    'error.notARepository': '这个目录不是 git 仓库。',
+    'error.workspaceUnknown': '这个目录不在你的 DSH 工作区里，无法在这里操作。',
+    'error.invalidBranch': '分支名不可用。',
+    'error.worktreeBusy': '这个目录还有正在运行的对话，或存在未提交改动；请先停止对话，或勾选强制删除。',
+    'error.notMerged': '这个分支还没合并；请先合并 PR，或勾选强制删除。',
+    'error.laneSession': '没能把对话绑定到这个目录：主机没有这条绑定记录（目录可能不在清单里，或会话服务不可用）。',
+    'error.laneMismatch': '这个对话不在该分支目录里，无法绑定。',
+    'error.permissionDenied': '操作被拒绝：只有本机，或带浏览器会话的受信入口才允许修改分支目录。',
+    'error.unreachable': '连不上分支目录服务：{error}',
+};
+/** English dictionary, checked complete against the zh key set. */
+export const en = {
+    'menu.aria': 'Manage the directory for this branch ({branch})',
+    'menu.path': 'Directory',
+    'menu.pr': 'Open PR',
+    'menu.delete': 'Delete…',
+    'menu.refresh': 'Check whether it is merged',
+    'menu.running': 'This conversation is running: stop the current turn before deleting.',
+    'menu.selfTeardown': 'This directory belongs to this conversation: deleting archives the conversation too.',
+    'worktree.prTitle': 'Open a pull request for "{name}"',
+    'worktree.prDescription': 'Pushes the branch and creates a pull request. Opens the GitHub compare page by default; uses the REST API when a GitHub token is configured.',
+    'worktree.prBase': 'Target branch (base)',
+    'worktree.prConfirm': 'Push and create PR',
+    'worktree.prOpen': 'Open PR',
+    'worktree.prSuccess': 'Branch pushed, PR ready:',
+    'worktree.deleteTitle': 'Delete "{name}"',
+    'worktree.deleteDescription': "Deletes this branch's directory and its record, and archives its conversation.",
+    'worktree.deleteBranch': 'Also delete the local branch',
+    'worktree.deleteBranchHint': 'Leave it unchecked to keep the local branch, so a directory can be made for it again later.',
+    'worktree.deleteForce': 'Force delete (discard uncommitted changes; delete an unmerged branch too)',
+    'worktree.deleteForceWarning': 'Force discards uncommitted changes and deletes an unmerged branch. This cannot be undone.',
+    'worktree.deleteConfirm': 'Delete',
+    'dialog.close': 'Close',
+    'dialog.cancel': 'Cancel',
+    'dialog.confirm': 'Confirm',
+    'error.gitFailed': 'git failed: {error}',
+    'error.worktreeExists': 'A local branch with that name already exists; choose another name or delete the old branch first.',
+    'error.worktreeNotFound': 'No such directory.',
+    'error.notARepository': 'This directory is not a git repository.',
+    'error.workspaceUnknown': 'This directory is not one of your DSH workspaces, so it cannot be used here.',
+    'error.invalidBranch': 'That branch name is not valid.',
+    'error.worktreeBusy': 'A running conversation or uncommitted changes block this directory; stop the conversation, or use force delete.',
+    'error.notMerged': 'The branch is not merged yet; merge the pull request first, or use force delete.',
+    'error.laneSession': 'Could not bind the conversation to this directory: the host recorded no binding (the directory may be missing from its manifest, or the sessions service is unavailable).',
+    'error.laneMismatch': 'This conversation is not running in that branch directory, so it cannot be bound to it.',
+    'error.permissionDenied': 'Permission denied: only this machine, or a deployment-declared browser entry with a session, may change a branch directory.',
+    'error.unreachable': 'The branch directory service did not answer: {error}',
+};

package/lib/types/client/conversation/worktree/semantic.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Semantic attribute values for the worktree capability. Its surface is the
+ * conversation header chip and the popover that chip opens: there is no
+ * sidebar entry and no management panel anymore.
+ */
+export declare const WORKTREE_PLUGIN = "worktree";
+/** Conversation header chip showing the session's branch (lane or main checkout). */
+export declare const WORKTREE_PART_LANE_CHIP = "lane-chip";
+/** Popover opened from the lane chip: the lane's facts plus its teardown actions. */
+export declare const WORKTREE_PART_LANE_MENU = "lane-menu";
+//# sourceMappingURL=semantic.d.ts.map

package/lib/types/client/conversation/worktree/semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../../../../src/client/conversation/worktree/semantic.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,eAAe,aAAa,CAAA;AACzC,qFAAqF;AACrF,eAAO,MAAM,uBAAuB,cAAc,CAAA;AAClD,qFAAqF;AACrF,eAAO,MAAM,uBAAuB,cAAc,CAAA"}

package/lib/types/client/conversation/worktree/semantic.js

@@ -0,0 +1,10 @@
+/**
+ * Semantic attribute values for the worktree capability. Its surface is the
+ * conversation header chip and the popover that chip opens: there is no
+ * sidebar entry and no management panel anymore.
+ */
+export const WORKTREE_PLUGIN = 'worktree';
+/** Conversation header chip showing the session's branch (lane or main checkout). */
+export const WORKTREE_PART_LANE_CHIP = 'lane-chip';
+/** Popover opened from the lane chip: the lane's facts plus its teardown actions. */
+export const WORKTREE_PART_LANE_MENU = 'lane-menu';

package/lib/types/client/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * dsh-web-all — browser half.
+ *
+ * 全家桶实体插件的 client 半区：按 dsh 注入位置组织，位置是第一维度。
+ * 三个位置模块（sidebar / settings / conversation）各自负责一个
+ * 注入位置的全部注册与编排；本文件只做装配：挂 compat 补标、加载位置模块。
+ *
+ * 不再存在任何独立插件行：cordis.patch.yml 只有一行 `web-all`。
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+/** Required services shared by the position modules (each may declare more). */
+export declare const inject: readonly ["slots", "locale", "sessions", "theme", "connection", "remote", "workspaces"];
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AASnE,gFAAgF;AAChF,eAAO,MAAM,MAAM,yFAQT,CAAA;AAmBV,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAW9C"}

package/lib/types/client/index.js

@@ -0,0 +1,45 @@
+import { mountCompat } from "./compat.js";
+import { mountGatewayTrust } from "./trust.js";
+import { mountSidebar } from "./sidebar/index.js";
+import { mountConversation } from "./conversation/index.js";
+import { mountLarkSettings } from "./settings/lark-inbox.js";
+import { mountNotifySettings } from "./settings/notify.js";
+/** Required services shared by the position modules (each may declare more). */
+export const inject = [
+    'slots',
+    'locale',
+    'sessions',
+    'theme',
+    'connection',
+    'remote',
+    'workspaces',
+];
+/**
+ * Application entry：装配四个位置模块 + compat shim。
+ * 每个位置模块直接挂载其完整能力并共享同一 Cordis 生命周期。
+ * @param ctx - client root context。
+ */
+/** 单模块挂载隔离：任一位置模块抛错不再拖垮整块客户端（并留下可诊断日志）。 */
+function mountPosition(ctx, label, fn) {
+    ctx.effect(() => {
+        try {
+            return fn();
+        }
+        catch (error) {
+            console.error(`[web-all] ${label} mount threw:`, error);
+            return () => { };
+        }
+    }, `web-all: ${label}`);
+}
+export function apply(ctx) {
+    // 最先挂：网关页面的宿主信任（否则 0.2 会把设置面降级成内存态，模型页读不到配置）。
+    mountPosition(ctx, 'gateway trust', () => mountGatewayTrust(ctx));
+    // 家族只在设置页保留飞书配置（内置插件标签页），其余能力全部走默认值。
+    mountPosition(ctx, 'compat', () => mountCompat());
+    mountPosition(ctx, 'sidebar position', () => mountSidebar(ctx));
+    mountPosition(ctx, 'conversation position', () => mountConversation(ctx));
+    mountPosition(ctx, 'settings position', () => mountLarkSettings(ctx));
+    // 通知是飞书接入的出站半边，与「飞书」页并列成第二个标签页：两者配置同一个
+    // 机器人，但一个是「怎么收」、一个是「怎么发」，混在一页里两边的说明都会变糊。
+    mountPosition(ctx, 'settings position (notify)', () => mountNotifySettings(ctx));
+}

package/lib/types/client/lark-inbox/i18n.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 飞书设置页的本地字典（连接向导 + 命名空间配置表单）。
+ *
+ * 家族设置卡已移除，向导与配置页自带一份最小字典，不依赖设置位置的 locale
+ * 命名空间。zh 是键集来源，en 必须保持同一键集。
+ */
+export declare const zh: {
+    readonly 'settings.tab': "飞书";
+    readonly 'settings.title': "飞书连接与配置";
+    readonly 'settings.intro': "连接飞书机器人，并调整事件进入会话的方式。凭据由上方向导写入，不在此显示。";
+    readonly 'settings.summary': "连接飞书机器人并配置事件投递。";
+    readonly 'settings.enabled': "启用飞书接入";
+    readonly 'settings.enabledHint': "关闭后不再建立长连接，已有事件保留在队列中。";
+    readonly 'settings.announce': "在系统提示中告知 Agent";
+    readonly 'settings.announceHint': "开启后当前会话会收到一段飞书事件使用说明。";
+    readonly 'settings.domain': "开放平台域名";
+    readonly 'settings.domainHint': "feishu（飞书）或 lark（Lark 国际版）。留空使用默认值 feishu。";
+    readonly 'settings.requireMention': "群聊需 @ 机器人";
+    readonly 'settings.requireMentionHint': "关闭后群里的所有消息都会进入队列。";
+    readonly 'settings.allowedOpenIds': "允许的发送者 open_id";
+    readonly 'settings.allowedOpenIdsHint': "一行一个（也支持逗号/分号分隔）。留空表示不限制发送者。";
+    readonly 'settings.queueDir': "事件队列目录";
+    readonly 'settings.queueDirHint': "存放待处理事件的目录。留空使用插件默认目录。";
+    readonly 'settings.maxAttempts': "最大投递尝试次数";
+    readonly 'settings.maxAttemptsHint': "单条事件失败后最多重试几次。留空使用默认值。";
+    readonly 'settings.staleTimeout': "过期超时（毫秒）";
+    readonly 'settings.staleTimeoutHint': "事件超过该时长仍未处理则视为过期。留空使用默认值。";
+    readonly 'settings.save': "保存";
+    readonly 'settings.saving': "保存中…";
+    readonly 'settings.saveFailed': "本部署没有接受这些值，已保留供你修改。";
+    readonly 'settings.readOnly': "本部署的设置为只读。";
+    readonly 'settings.unavailable': "宿主当前未提供飞书配置，暂时无法编辑。";
+    readonly 'settings.overridden': "已覆盖";
+    readonly 'settings.reset': "恢复默认";
+    readonly 'settings.invalid': "该值不被接受，请修改或清空以恢复默认。";
+    readonly 'settings.invalidNumber': "请填数字；留空表示使用默认值。";
+    readonly 'wizard.createNew': "创建新 bot";
+    readonly 'wizard.bindExisting': "绑定已有 bot";
+    readonly 'wizard.appId': "App ID";
+    readonly 'wizard.appIdHint': "飞书开放平台应用的 App ID。";
+    readonly 'wizard.appSecret': "App Secret";
+    readonly 'wizard.appSecretHint': "应用的 App Secret，仅用于本次绑定，不会写入日志。";
+    readonly 'wizard.confirmBind': "确认绑定";
+    readonly 'wizard.finishBind': "完成绑定";
+    readonly 'wizard.openLinkHint': "打开授权链接：";
+    readonly 'wizard.awaitingHint': "请在飞书中完成授权，页面每 2 秒自动刷新状态。";
+    readonly 'wizard.openConsoleHint': "打开开放平台后台，确认应用并复制 App Secret：";
+    readonly 'wizard.qrAlt': "飞书授权二维码";
+    readonly 'wizard.connected': "已连接 {appId}";
+    readonly 'wizard.connectedHint': "凭据已就绪，飞书事件将进入当前会话。";
+    readonly 'wizard.needsSecretHint': "应用已创建，请在下方 App Secret 字段粘贴一次密钥后保存。";
+    readonly 'wizard.cancel': "取消";
+    readonly 'wizard.back': "返回";
+    readonly 'wizard.failed': "连接失败";
+    readonly 'wizard.installHint': "若尚未安装 lark-cli，请先在命令行安装并登录，然后重试。";
+    readonly 'wizard.busy': "处理中…";
+};
+export type LarkKey = keyof typeof zh;
+export declare const en: Record<LarkKey, string>;
+export type Translate = (key: LarkKey, params?: Record<string, string | number>) => string;
+/** 取字典：`<html lang>` 以 zh 开头用中文，否则英文。 */
+export declare function makeT(doc?: Document | undefined): Translate;
+//# sourceMappingURL=i18n.d.ts.map

package/lib/types/client/lark-inbox/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../../src/client/lark-inbox/i18n.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDL,CAAA;AAEV,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,EAAE,CAAA;AAErC,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAkDtC,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAA;AAE1F,yCAAyC;AACzC,wBAAgB,KAAK,CAAC,GAAG,GAAE,QAAQ,GAAG,SAAkE,GAAG,SAAS,CAQnH"}