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

package/lib/types/client/lark-inbox/i18n.js

@@ -0,0 +1,119 @@
+/**
+ * 飞书设置页的本地字典（连接向导 + 命名空间配置表单）。
+ *
+ * 家族设置卡已移除，向导与配置页自带一份最小字典，不依赖设置位置的 locale
+ * 命名空间。zh 是键集来源，en 必须保持同一键集。
+ */
+export const zh = {
+    'settings.tab': '飞书',
+    'settings.title': '飞书连接与配置',
+    'settings.intro': '连接飞书机器人，并调整事件进入会话的方式。凭据由上方向导写入，不在此显示。',
+    'settings.summary': '连接飞书机器人并配置事件投递。',
+    'settings.enabled': '启用飞书接入',
+    'settings.enabledHint': '关闭后不再建立长连接，已有事件保留在队列中。',
+    'settings.announce': '在系统提示中告知 Agent',
+    'settings.announceHint': '开启后当前会话会收到一段飞书事件使用说明。',
+    'settings.domain': '开放平台域名',
+    'settings.domainHint': 'feishu（飞书）或 lark（Lark 国际版）。留空使用默认值 feishu。',
+    'settings.requireMention': '群聊需 @ 机器人',
+    'settings.requireMentionHint': '关闭后群里的所有消息都会进入队列。',
+    'settings.allowedOpenIds': '允许的发送者 open_id',
+    'settings.allowedOpenIdsHint': '一行一个（也支持逗号/分号分隔）。留空表示不限制发送者。',
+    'settings.queueDir': '事件队列目录',
+    'settings.queueDirHint': '存放待处理事件的目录。留空使用插件默认目录。',
+    'settings.maxAttempts': '最大投递尝试次数',
+    'settings.maxAttemptsHint': '单条事件失败后最多重试几次。留空使用默认值。',
+    'settings.staleTimeout': '过期超时（毫秒）',
+    'settings.staleTimeoutHint': '事件超过该时长仍未处理则视为过期。留空使用默认值。',
+    'settings.save': '保存',
+    'settings.saving': '保存中…',
+    'settings.saveFailed': '本部署没有接受这些值，已保留供你修改。',
+    'settings.readOnly': '本部署的设置为只读。',
+    'settings.unavailable': '宿主当前未提供飞书配置，暂时无法编辑。',
+    'settings.overridden': '已覆盖',
+    'settings.reset': '恢复默认',
+    'settings.invalid': '该值不被接受，请修改或清空以恢复默认。',
+    'settings.invalidNumber': '请填数字；留空表示使用默认值。',
+    'wizard.createNew': '创建新 bot',
+    'wizard.bindExisting': '绑定已有 bot',
+    'wizard.appId': 'App ID',
+    'wizard.appIdHint': '飞书开放平台应用的 App ID。',
+    'wizard.appSecret': 'App Secret',
+    'wizard.appSecretHint': '应用的 App Secret，仅用于本次绑定，不会写入日志。',
+    'wizard.confirmBind': '确认绑定',
+    'wizard.finishBind': '完成绑定',
+    'wizard.openLinkHint': '打开授权链接：',
+    'wizard.awaitingHint': '请在飞书中完成授权，页面每 2 秒自动刷新状态。',
+    'wizard.openConsoleHint': '打开开放平台后台，确认应用并复制 App Secret：',
+    'wizard.qrAlt': '飞书授权二维码',
+    'wizard.connected': '已连接 {appId}',
+    'wizard.connectedHint': '凭据已就绪，飞书事件将进入当前会话。',
+    'wizard.needsSecretHint': '应用已创建，请在下方 App Secret 字段粘贴一次密钥后保存。',
+    'wizard.cancel': '取消',
+    'wizard.back': '返回',
+    'wizard.failed': '连接失败',
+    'wizard.installHint': '若尚未安装 lark-cli，请先在命令行安装并登录，然后重试。',
+    'wizard.busy': '处理中…',
+};
+export const en = {
+    'settings.tab': 'Feishu',
+    'settings.title': 'Feishu connection and settings',
+    'settings.intro': 'Connect the Feishu bot and control how its events reach the session. Credentials are written by the wizard above and never shown here.',
+    'settings.summary': 'Connect the Feishu bot and configure event delivery.',
+    'settings.enabled': 'Enable Feishu intake',
+    'settings.enabledHint': 'When off, the long connection is not opened and queued events stay in the queue.',
+    'settings.announce': 'Tell the agent about Feishu events',
+    'settings.announceHint': 'When on, the current session receives a short guide for Feishu events.',
+    'settings.domain': 'Open platform domain',
+    'settings.domainHint': 'feishu or lark. Leave blank to use the default (feishu).',
+    'settings.requireMention': 'Groups require an @mention',
+    'settings.requireMentionHint': 'When off, every group message enters the queue.',
+    'settings.allowedOpenIds': 'Allowed sender open_ids',
+    'settings.allowedOpenIdsHint': 'One per line (comma or semicolon also works). Leave blank to accept every sender.',
+    'settings.queueDir': 'Event queue directory',
+    'settings.queueDirHint': 'Directory holding pending events. Leave blank for the plugin default.',
+    'settings.maxAttempts': 'Maximum delivery attempts',
+    'settings.maxAttemptsHint': 'How many times one event may be retried. Leave blank for the default.',
+    'settings.staleTimeout': 'Stale timeout (ms)',
+    'settings.staleTimeoutHint': 'An event older than this is treated as stale. Leave blank for the default.',
+    'settings.save': 'Save',
+    'settings.saving': 'Saving…',
+    'settings.saveFailed': 'The deployment did not accept these values; they were left for you to correct.',
+    'settings.readOnly': 'This deployment stores settings read-only.',
+    'settings.unavailable': 'The host does not serve Feishu settings right now, so they cannot be edited.',
+    'settings.overridden': 'Overridden',
+    'settings.reset': 'Reset to default',
+    'settings.invalid': 'This value is not accepted; change it or clear it to use the default.',
+    'settings.invalidNumber': 'Enter a number, or leave blank to use the default.',
+    'wizard.createNew': 'Create new bot',
+    'wizard.bindExisting': 'Bind existing bot',
+    'wizard.appId': 'App ID',
+    'wizard.appIdHint': 'The App ID of the Feishu Open Platform application.',
+    'wizard.appSecret': 'App Secret',
+    'wizard.appSecretHint': "The app's App Secret, used only for this bind and never written to logs.",
+    'wizard.confirmBind': 'Confirm bind',
+    'wizard.finishBind': 'Finish bind',
+    'wizard.openLinkHint': 'Open the authorization link: ',
+    'wizard.awaitingHint': 'Complete the authorization in Feishu; this page refreshes status every 2 seconds.',
+    'wizard.openConsoleHint': 'Open the Open Platform console, confirm the app, and copy the App Secret: ',
+    'wizard.qrAlt': 'Feishu authorization QR code',
+    'wizard.connected': 'Connected {appId}',
+    'wizard.connectedHint': 'Credentials are ready; Feishu events will arrive in the current session.',
+    'wizard.needsSecretHint': 'The app was created; paste its secret once into the App Secret field below and save.',
+    'wizard.cancel': 'Cancel',
+    'wizard.back': 'Back',
+    'wizard.failed': 'Connection failed',
+    'wizard.installHint': 'If lark-cli is not installed yet, install and log in from the command line, then retry.',
+    'wizard.busy': 'Working…',
+};
+/** 取字典：`<html lang>` 以 zh 开头用中文，否则英文。 */
+export function makeT(doc = typeof document === 'undefined' ? undefined : document) {
+    const lang = doc?.documentElement?.lang?.toLowerCase() ?? '';
+    const table = lang.startsWith('zh') ? zh : en;
+    return (key, params) => {
+        const text = table[key] ?? key;
+        if (params === undefined)
+            return text;
+        return text.replace(/\{(\w+)\}/gu, (match, name) => params[name] === undefined ? match : String(params[name]));
+    };
+}

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

@@ -0,0 +1,19 @@
+import { type ReactNode } from 'react';
+import type { Translate } from './i18n.ts';
+export type WizardPhase = 'idle' | 'awaiting-browser' | 'awaiting-secret' | 'done' | 'failed';
+export interface WizardStatus {
+    phase: WizardPhase;
+    mode?: 'new' | 'bind';
+    consoleUrl?: string;
+    needsSecretPaste?: boolean;
+    appId?: string;
+    error?: string;
+}
+export declare const WIZARD_POLL_INTERVAL_MS = 2000;
+export interface LarkInboxWizardProps {
+    t: Translate;
+    disabled?: boolean;
+}
+export declare function LarkInboxWizard({ t, disabled }: LarkInboxWizardProps): ReactNode;
+export declare const LARK_WIZARD_ROUTE_BASE = "/lark-inbox/wizard";
+//# sourceMappingURL=wizard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../../../src/client/lark-inbox/wizard.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAG1C,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE7F,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,CAAA;IAClB,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAcD,eAAO,MAAM,uBAAuB,OAAO,CAAA;AA2B3C,MAAM,WAAW,oBAAoB;IACnC,CAAC,EAAE,SAAS,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,wBAAgB,eAAe,CAAC,EAAE,CAAC,EAAE,QAAgB,EAAE,EAAE,oBAAoB,GAAG,SAAS,CA6IxF;AAUD,eAAO,MAAM,sBAAsB,uBAAc,CAAA"}

package/lib/types/client/lark-inbox/wizard.js

@@ -0,0 +1,158 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import styles from './lark-wizard.module.css';
+const WIZARD_BASE = '/lark-inbox/wizard';
+export const WIZARD_POLL_INTERVAL_MS = 2000;
+async function readJson(response) {
+    const body = await response.json();
+    if (!response.ok)
+        throw new Error(body.error ?? `lark-inbox wizard request failed (${response.status})`);
+    return body;
+}
+function request(path, init) {
+    return fetch(`${WIZARD_BASE}${path}`, init).then((readJson));
+}
+function post(path, payload) {
+    return request(path, {
+        method: 'POST',
+        ...(payload === undefined ? {} : { headers: { 'content-type': 'application/json' }, body: JSON.stringify(payload) }),
+    });
+}
+function get(path) {
+    return request(path, { cache: 'no-store' });
+}
+function summarize(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function LarkInboxWizard({ t, disabled = false }) {
+    const [view, setView] = useState({ kind: 'idle' });
+    const [busy, setBusy] = useState(false);
+    const [bindAppId, setBindAppId] = useState('');
+    const [bindAppSecret, setBindAppSecret] = useState('');
+    useEffect(() => {
+        let live = true;
+        void get('/status').then((next) => {
+            if (!live)
+                return;
+            if (next.phase === 'done')
+                setView({ kind: 'connected', appId: next.appId, needsSecretPaste: next.needsSecretPaste === true });
+            else if (next.phase === 'awaiting-browser')
+                setView({ kind: 'creating', qr: null });
+            else if (next.phase === 'awaiting-secret')
+                setView({ kind: 'connected', appId: next.appId, needsSecretPaste: true });
+            else if (next.phase === 'failed')
+                setView({ kind: 'failed', error: next.error });
+        }).catch(() => undefined);
+        return () => { live = false; };
+    }, []);
+    useEffect(() => {
+        if (view.kind !== 'creating')
+            return;
+        let live = true;
+        const tick = async () => {
+            try {
+                const next = await get('/status');
+                if (!live || next.phase === 'awaiting-browser')
+                    return;
+                if (next.phase === 'done')
+                    setView({ kind: 'connected', appId: next.appId, needsSecretPaste: next.needsSecretPaste === true });
+                else if (next.phase === 'awaiting-secret')
+                    setView({ kind: 'connected', appId: next.appId, needsSecretPaste: true });
+                else if (next.phase === 'failed')
+                    setView({ kind: 'failed', error: next.error });
+                else
+                    setView({ kind: 'idle' });
+            }
+            catch (error) {
+                if (live)
+                    setView({ kind: 'failed', error: summarize(error) });
+            }
+        };
+        void tick();
+        const interval = globalThis.setInterval(() => { void tick(); }, WIZARD_POLL_INTERVAL_MS);
+        return () => { live = false; globalThis.clearInterval(interval); };
+    }, [view.kind]);
+    const createNew = async () => {
+        if (busy)
+            return;
+        setBusy(true);
+        try {
+            const result = await post('/start-new');
+            setView({ kind: 'creating', verificationUrl: result.verificationUrl, qr: result.qr });
+        }
+        catch (error) {
+            setView({ kind: 'failed', error: summarize(error) });
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const confirmBind = async () => {
+        if (busy)
+            return;
+        setBusy(true);
+        try {
+            const result = await post('/start-bind', { appId: bindAppId.trim() });
+            setView({ kind: 'bind-awaiting', consoleUrl: result.consoleUrl });
+        }
+        catch (error) {
+            setView({ kind: 'failed', error: summarize(error) });
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const finishBind = async () => {
+        if (busy)
+            return;
+        setBusy(true);
+        try {
+            await post('/finish-bind', { appSecret: bindAppSecret });
+            setView({ kind: 'connected', appId: bindAppId.trim(), needsSecretPaste: false });
+        }
+        catch (error) {
+            setView({ kind: 'failed', error: summarize(error) });
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const clear = () => {
+        setView({ kind: 'idle' });
+        setBindAppId('');
+        setBindAppSecret('');
+    };
+    const cancel = async () => {
+        try {
+            await post('/cancel');
+        }
+        catch { /* best effort */ }
+        clear();
+    };
+    const cancelButton = _jsx("button", { type: "button", className: styles.secondary, disabled: busy, onClick: () => { void cancel(); }, children: t('wizard.cancel') });
+    let body;
+    if (view.kind === 'idle') {
+        body = _jsxs("div", { className: styles.actions, "data-dsh-part": "actions", children: [_jsx("button", { type: "button", className: styles.primary, disabled: disabled || busy, onClick: () => { void createNew(); }, children: t('wizard.createNew') }), _jsx("button", { type: "button", className: styles.secondary, disabled: disabled || busy, onClick: () => { setBindAppId(''); setBindAppSecret(''); setView({ kind: 'bind-form' }); }, children: t('wizard.bindExisting') })] });
+    }
+    else if (view.kind === 'creating') {
+        body = _jsxs("div", { className: styles.panel, "data-dsh-part": "authorization", children: [view.verificationUrl ? _jsxs("p", { className: styles.hint, children: [t('wizard.openLinkHint'), _jsx("a", { href: view.verificationUrl, target: "_blank", rel: "noreferrer", className: styles.link, children: view.verificationUrl })] }) : null, view.qr !== null ? _jsx("img", { src: `${WIZARD_BASE}/qr.png`, alt: t('wizard.qrAlt'), className: styles.qr }) : null, _jsx("p", { className: styles.hint, children: t('wizard.awaitingHint') }), _jsx("div", { className: styles.actions, children: cancelButton })] });
+    }
+    else if (view.kind === 'bind-form') {
+        body = _jsxs("div", { className: styles.panel, "data-dsh-part": "bind-form", children: [_jsx(WizardField, { id: "lark-inbox-wizard-bind-appid", label: t('wizard.appId'), hint: t('wizard.appIdHint'), value: bindAppId, disabled: disabled, onChange: setBindAppId }), _jsx(WizardField, { id: "lark-inbox-wizard-bind-appsecret", label: t('wizard.appSecret'), hint: t('wizard.appSecretHint'), value: bindAppSecret, disabled: disabled, secret: true, onChange: setBindAppSecret }), _jsxs("div", { className: styles.actions, children: [_jsx("button", { type: "button", className: styles.primary, disabled: disabled || busy || bindAppId.trim() === '' || bindAppSecret.trim() === '', onClick: () => { void confirmBind(); }, children: t('wizard.confirmBind') }), cancelButton] })] });
+    }
+    else if (view.kind === 'bind-awaiting') {
+        body = _jsxs("div", { className: styles.panel, "data-dsh-part": "bind-finish", children: [_jsxs("p", { className: styles.meta, children: [t('wizard.appId'), ": ", bindAppId.trim()] }), view.consoleUrl ? _jsxs("p", { className: styles.hint, children: [t('wizard.openConsoleHint'), _jsx("a", { href: view.consoleUrl, target: "_blank", rel: "noreferrer", className: styles.link, children: view.consoleUrl })] }) : null, _jsx(WizardField, { id: "lark-inbox-wizard-finish-appsecret", label: t('wizard.appSecret'), hint: t('wizard.appSecretHint'), value: bindAppSecret, disabled: disabled, secret: true, onChange: setBindAppSecret }), _jsxs("div", { className: styles.actions, children: [_jsx("button", { type: "button", className: styles.primary, disabled: disabled || busy || bindAppSecret.trim() === '', onClick: () => { void finishBind(); }, children: t('wizard.finishBind') }), cancelButton] })] });
+    }
+    else if (view.kind === 'connected') {
+        body = _jsxs("div", { className: styles.panel, "data-dsh-part": "result", children: [view.needsSecretPaste ? _jsx("p", { className: styles.hint, children: t('wizard.needsSecretHint') }) : _jsxs(_Fragment, { children: [_jsx("p", { className: styles.success, children: t('wizard.connected', { appId: view.appId ?? '' }) }), _jsx("p", { className: styles.hint, children: t('wizard.connectedHint') })] }), _jsx("div", { className: styles.actions, children: _jsx("button", { type: "button", className: styles.secondary, onClick: clear, children: t('wizard.back') }) })] });
+    }
+    else {
+        body = _jsxs("div", { className: styles.panel, "data-dsh-part": "result", children: [_jsx("p", { className: styles.error, role: "alert", children: t('wizard.failed') }), view.error ? _jsx("p", { className: styles.errorDetail, children: view.error }) : null, _jsx("p", { className: styles.hint, children: t('wizard.installHint') }), _jsx("div", { className: styles.actions, children: _jsx("button", { type: "button", className: styles.secondary, onClick: clear, children: t('wizard.back') }) })] });
+    }
+    // 标题由面板外壳（LarkPanel）提供，这里不再重复渲染。
+    return _jsxs("div", { className: styles.wizard, "data-dsh-plugin": "lark-inbox", "data-dsh-part": "wizard", children: [body, busy ? _jsx("p", { className: styles.hint, role: "status", children: t('wizard.busy') }) : null] });
+}
+function WizardField(props) {
+    return _jsxs("div", { className: styles.wizardField, children: [_jsx("label", { className: styles.label, htmlFor: props.id, children: props.label }), _jsx("input", { id: props.id, className: styles.input, type: props.secret ? 'password' : 'text', value: props.value, autoComplete: "off", spellCheck: false, disabled: props.disabled, onChange: event => { props.onChange(event.target.value); } }), _jsx("p", { className: styles.hint, children: props.hint })] });
+}
+export const LARK_WIZARD_ROUTE_BASE = WIZARD_BASE;

package/lib/types/client/notify/i18n.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 通知设置页的本地字典（飞书推送配置）。
+ *
+ * 与飞书设置页同一套约定：zh 是键集来源，en 必须保持同一键集；页面自带字典，
+ * 不依赖设置位置的 locale 命名空间。
+ */
+export declare const zh: {
+    readonly 'settings.tab': "通知";
+    readonly 'settings.title': "运行结束通知";
+    readonly 'settings.intro': "会话运行结束后，把结果推送到飞书，并让桌面端与手机端的机器列表标出未查看的结果。";
+    readonly 'settings.summary': "运行结束后推送到飞书，并在机器列表标出未查看的结果。";
+    readonly 'settings.enabled': "启用通知";
+    readonly 'settings.enabledHint': "关闭后不记录运行结果，机器列表也不再显示未查看标记；已记录的结果会被清空。";
+    readonly 'settings.feedLimit': "单次读取返回条数";
+    readonly 'settings.feedLimitHint': "客户端一次拉取最多拿到多少条结果。留空使用默认值 20。";
+    readonly 'settings.feishuEnabled': "推送到飞书";
+    readonly 'settings.feishuEnabledHint': "开启后，运行结束会由机器人发送消息给你。需要下面填好应用凭据与收件人。";
+    readonly 'settings.feishuAppId': "飞书 App ID";
+    readonly 'settings.feishuAppIdHint': "留空则沿用「飞书」页配置的机器人应用。";
+    readonly 'settings.feishuAppSecret': "飞书 App Secret";
+    readonly 'settings.feishuAppSecretHint': "可填 env:变量名 从环境变量读取。留空则沿用「飞书」页配置的应用。";
+    readonly 'settings.feishuDomain': "开放平台域名";
+    readonly 'settings.feishuDomainHint': "feishu（飞书）或 lark（Lark 国际版）。留空使用默认值 feishu。";
+    readonly 'settings.feishuRecipients': "收件人";
+    readonly 'settings.feishuRecipientsHint': "一行一个 open_id（ou_ 开头）或 chat_id（oc_ 开头）。留空表示不推送。";
+    readonly 'settings.feishuMode': "推送时机";
+    readonly 'settings.feishuModeHint': "idle：等这一轮工作彻底停下后合并成一条；each-turn：每结束一轮就发一条。留空使用默认值 idle。";
+    readonly 'settings.feishuOutcomes': "推送哪些结果";
+    readonly 'settings.feishuOutcomesHint': "一行一个：completed（已完成）、failed（出错）、stopped（已结束）。留空使用默认值 completed 与 failed。";
+    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 'settings.feed': "客户端读取地址";
+    readonly 'settings.feedHint': "桌面端与手机端按这个地址拉取运行结果；它只读，且需要本机或已声明入口的访问权限。";
+};
+export type NotifyKey = keyof typeof zh;
+export declare const en: Record<NotifyKey, string>;
+export type Translate = (key: NotifyKey, 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/notify/i18n.d.ts.map

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

package/lib/types/client/notify/i18n.js

@@ -0,0 +1,87 @@
+/**
+ * 通知设置页的本地字典（飞书推送配置）。
+ *
+ * 与飞书设置页同一套约定：zh 是键集来源，en 必须保持同一键集；页面自带字典，
+ * 不依赖设置位置的 locale 命名空间。
+ */
+export const zh = {
+    'settings.tab': '通知',
+    'settings.title': '运行结束通知',
+    'settings.intro': '会话运行结束后，把结果推送到飞书，并让桌面端与手机端的机器列表标出未查看的结果。',
+    'settings.summary': '运行结束后推送到飞书，并在机器列表标出未查看的结果。',
+    'settings.enabled': '启用通知',
+    'settings.enabledHint': '关闭后不记录运行结果，机器列表也不再显示未查看标记；已记录的结果会被清空。',
+    'settings.feedLimit': '单次读取返回条数',
+    'settings.feedLimitHint': '客户端一次拉取最多拿到多少条结果。留空使用默认值 20。',
+    'settings.feishuEnabled': '推送到飞书',
+    'settings.feishuEnabledHint': '开启后，运行结束会由机器人发送消息给你。需要下面填好应用凭据与收件人。',
+    'settings.feishuAppId': '飞书 App ID',
+    'settings.feishuAppIdHint': '留空则沿用「飞书」页配置的机器人应用。',
+    'settings.feishuAppSecret': '飞书 App Secret',
+    'settings.feishuAppSecretHint': '可填 env:变量名 从环境变量读取。留空则沿用「飞书」页配置的应用。',
+    'settings.feishuDomain': '开放平台域名',
+    'settings.feishuDomainHint': 'feishu（飞书）或 lark（Lark 国际版）。留空使用默认值 feishu。',
+    'settings.feishuRecipients': '收件人',
+    'settings.feishuRecipientsHint': '一行一个 open_id（ou_ 开头）或 chat_id（oc_ 开头）。留空表示不推送。',
+    'settings.feishuMode': '推送时机',
+    'settings.feishuModeHint': 'idle：等这一轮工作彻底停下后合并成一条；each-turn：每结束一轮就发一条。留空使用默认值 idle。',
+    'settings.feishuOutcomes': '推送哪些结果',
+    'settings.feishuOutcomesHint': '一行一个：completed（已完成）、failed（出错）、stopped（已结束）。留空使用默认值 completed 与 failed。',
+    'settings.save': '保存',
+    'settings.saving': '保存中…',
+    'settings.saveFailed': '本部署没有接受这些值，已保留供你修改。',
+    'settings.readOnly': '本部署的设置为只读。',
+    'settings.unavailable': '宿主当前未提供通知配置，暂时无法编辑。',
+    'settings.overridden': '已覆盖',
+    'settings.reset': '恢复默认',
+    'settings.invalid': '该值不被接受，请修改或清空以恢复默认。',
+    'settings.invalidNumber': '请填数字；留空表示使用默认值。',
+    'settings.feed': '客户端读取地址',
+    'settings.feedHint': '桌面端与手机端按这个地址拉取运行结果；它只读，且需要本机或已声明入口的访问权限。',
+};
+export const en = {
+    'settings.tab': 'Notifications',
+    'settings.title': 'Run-finished notifications',
+    'settings.intro': 'When a session finishes running, push the result to Feishu and mark the unseen results in the desktop and mobile machine lists.',
+    'settings.summary': 'Push finished runs to Feishu and mark unseen results in the machine list.',
+    'settings.enabled': 'Enable notifications',
+    'settings.enabledHint': 'When off, run results are not recorded and the machine list stops marking unseen ones; already recorded results are dropped.',
+    'settings.feedLimit': 'Notices per read',
+    'settings.feedLimitHint': 'How many results a client receives in one pull. Leave blank to use the default of 20.',
+    'settings.feishuEnabled': 'Push to Feishu',
+    'settings.feishuEnabledHint': 'When on, the bot messages you when a run finishes. Requires the credentials and recipients below.',
+    'settings.feishuAppId': 'Feishu App ID',
+    'settings.feishuAppIdHint': 'Leave blank to reuse the bot configured on the Feishu page.',
+    'settings.feishuAppSecret': 'Feishu App Secret',
+    'settings.feishuAppSecretHint': 'Accepts env:NAME to read an environment variable. Leave blank to reuse the application configured on the Feishu page.',
+    'settings.feishuDomain': 'Open platform domain',
+    'settings.feishuDomainHint': 'feishu or lark. Leave blank to use the default (feishu).',
+    'settings.feishuRecipients': 'Recipients',
+    'settings.feishuRecipientsHint': 'One open_id (starts with ou_) or chat_id (starts with oc_) per line. Leave blank to push nothing.',
+    'settings.feishuMode': 'When to push',
+    'settings.feishuModeHint': 'idle waits until the work has fully stopped and sends one message; each-turn sends one message per finished turn. Leave blank for the default (idle).',
+    'settings.feishuOutcomes': 'Which results to push',
+    'settings.feishuOutcomesHint': 'One per line: completed, failed, stopped. Leave blank for the default (completed and failed).',
+    'settings.save': 'Save',
+    'settings.saving': 'Saving…',
+    'settings.saveFailed': 'The deployment did not accept these values; they were left for you to correct.',
+    'settings.readOnly': 'This deployment stores settings read-only.',
+    'settings.unavailable': 'The host does not serve notification settings right now, so they cannot be edited.',
+    'settings.overridden': 'Overridden',
+    'settings.reset': 'Reset to default',
+    'settings.invalid': 'This value is not accepted; change it or clear it to use the default.',
+    'settings.invalidNumber': 'Enter a number, or leave blank to use the default.',
+    'settings.feed': 'Client read address',
+    'settings.feedHint': 'The desktop and mobile clients pull run results from this address. It is read-only and requires local access or a declared entry.',
+};
+/** 取字典：`<html lang>` 以 zh 开头用中文，否则英文。 */
+export function makeT(doc = typeof document === 'undefined' ? undefined : document) {
+    const lang = doc?.documentElement?.lang?.toLowerCase() ?? '';
+    const table = lang.startsWith('zh') ? zh : en;
+    return (key, params) => {
+        const text = table[key] ?? key;
+        if (params === undefined)
+            return text;
+        return text.replace(/\{(\w+)\}/gu, (match, name) => params[name] === undefined ? match : String(params[name]));
+    };
+}

package/lib/types/client/settings/family-scope.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 家族设置作用域：把 `web-all` 聚合条目的读写面收窄到一个能力域命名空间。
+ *
+ * DSH 0.2 的客户端设置面按命名空间寻址，而家族的全部能力域聚合在单个 `web-all`
+ * 条目里（顶层 volatile 子键就是能力域，见 host 的 `family-config.ts`）。这里做
+ * 一次路径前缀适配：读侧下钻子对象，写侧给每个路径加上子键前缀，于是官方
+ * `SettingsFormModel` / `SettingsForm` 的 staged 编辑、保存与 revision 闸门都能
+ * 原样复用，每个能力域不必各自实现一遍。
+ *
+ * 该适配只做路径搬运，不解释值：字段的格式化与校验仍由各页自己的 `SettingsFieldSpec`
+ * 负责。
+ */
+import type { SettingsFormScope } from './primitives-0.2.ts';
+/** 家族聚合条目在宿主 settings 镜像里的条目 id（host 的 `FAMILY_ENTRY_ID`）。 */
+export declare const FAMILY_SETTINGS_NAMESPACE = "web-all";
+/**
+ * 把聚合条目的作用域收窄到一个命名空间。
+ * @param entry - `configForms.get('web-all')` 返回的聚合读写面。
+ * @param namespace - 能力域在条目里的子键。
+ * @returns 只读写该命名空间的等价作用域。
+ */
+export declare function familyNamespaceScope<T>(entry: SettingsFormScope<Record<string, unknown>>, namespace: string): SettingsFormScope<T>;
+//# sourceMappingURL=family-scope.d.ts.map

package/lib/types/client/settings/family-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"family-scope.d.ts","sourceRoot":"","sources":["../../../../src/client/settings/family-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAA6B,MAAM,qBAAqB,CAAA;AAEvF,8DAA8D;AAC9D,eAAO,MAAM,yBAAyB,YAAY,CAAA;AAElD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAqBlI"}

package/lib/types/client/settings/family-scope.js

@@ -0,0 +1,30 @@
+/** 家族聚合条目在宿主 settings 镜像里的条目 id（host 的 `FAMILY_ENTRY_ID`）。 */
+export const FAMILY_SETTINGS_NAMESPACE = 'web-all';
+/**
+ * 把聚合条目的作用域收窄到一个命名空间。
+ * @param entry - `configForms.get('web-all')` 返回的聚合读写面。
+ * @param namespace - 能力域在条目里的子键。
+ * @returns 只读写该命名空间的等价作用域。
+ */
+export function familyNamespaceScope(entry, namespace) {
+    const section = (snapshot) => {
+        const value = snapshot.value;
+        const base = snapshot.base;
+        const user = snapshot.user;
+        return {
+            status: snapshot.status,
+            value: value?.[namespace],
+            base: base?.[namespace],
+            user: user?.[namespace],
+            writable: snapshot.writable,
+            revision: snapshot.revision,
+        };
+    };
+    return {
+        getSnapshot: () => section(entry.getSnapshot()),
+        subscribe: listener => entry.subscribe(listener),
+        mutate: (ops, expectedRevision) => entry.mutate(ops.map((op) => op.op === 'set'
+            ? { op: 'set', path: [namespace, ...op.path], value: op.value }
+            : { op: 'unset', path: [namespace, ...op.path] }), expectedRevision),
+    };
+}

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

@@ -0,0 +1,73 @@
+/**
+ * 飞书设置页（DSH 0.2）。
+ *
+ * 位置：设置 → 内置插件 的「飞书」标签页（官方 `settings.plugins.tab`），
+ * 只在宿主确实提供 `lark-inbox` 命名空间时才出现（`configForms.whileServed`，
+ * 与官方 Agent loop / Subagent 等配置页同一套机制）。
+ *
+ * 数据：表单走官方 `SettingsFormModel` + `SettingsForm`（staged 编辑、保存时才
+ * 落盘、写入带 revision 闸门），凭据仍由连接向导经宿主 loopback 路由写入。
+ */
+import { type ReactNode } from 'react';
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+import { type SettingsFieldState, type SettingsFormScope, type SettingsFormShell } from './primitives-0.2.ts';
+import { type Translate } from '../lark-inbox/i18n.ts';
+import { FAMILY_SETTINGS_NAMESPACE } from './family-scope.ts';
+/** 家族聚合条目在宿主 settings 镜像里的命名空间（host FAMILY_ENTRY_ID）。 */
+export { FAMILY_SETTINGS_NAMESPACE };
+/** 条目里飞书能力域的子键（host 的 family namespace）。 */
+export declare const LARK_INBOX_NAMESPACE = "lark-inbox";
+/** 面板编辑的字段子集。 */
+export interface LarkInboxSettings {
+    enabled?: boolean;
+    announceToAgent?: boolean;
+    domain?: 'feishu' | 'lark';
+    requireMentionInGroup?: boolean;
+    allowedOpenIds?: string[];
+    queueDir?: string;
+    maxAttempts?: number;
+    staleTimeoutMs?: number;
+}
+/** 设置页投影给组件的状态。 */
+interface LarkCardState extends SettingsFormShell {
+    enabled: SettingsFieldState;
+    announceToAgent: SettingsFieldState;
+    domain: SettingsFieldState;
+    requireMentionInGroup: SettingsFieldState;
+    allowedOpenIds: SettingsFieldState;
+    queueDir: SettingsFieldState;
+    maxAttempts: SettingsFieldState;
+    staleTimeoutMs: SettingsFieldState;
+}
+/** 页面控制器：把 `lark-inbox` 命名空间桥到官方 staged 表单。 */
+export declare class LarkSettingsController {
+    private readonly form;
+    private readonly store;
+    constructor(scope: SettingsFormScope<LarkInboxSettings>);
+    private projection;
+    /** 槽注入面：投影 store + 表单动作。 */
+    inject(): Record<string, unknown>;
+    dispose(): void;
+}
+interface LarkPageProps {
+    view?: 'summary' | 'full';
+    useLarkCard<T>(select: (state: LarkCardState) => T): T;
+    edit(field: string, text: string): void;
+    resetField(field: string): void;
+    save(): void;
+    discard(): void;
+    t: Translate;
+}
+/** 未设置该字段表示沿用默认（启用）；显式关闭即不显示连接向导。 */
+export declare function larkWizardVisible(state: Pick<LarkCardState, 'enabled'>): boolean;
+/** 设置标签页主体：连接向导 + 命名空间配置表单。 */
+export declare function LarkSettingsPage(props: LarkPageProps): ReactNode;
+/**
+ * 把 `web-all` 条目的读写面收窄到 `lark-inbox` 子键。
+ *
+ * 前缀适配的实现在 `family-scope.ts`，与其它能力域共用。
+ */
+export declare function larkInboxScope(entry: SettingsFormScope<Record<string, unknown>>): SettingsFormScope<LarkInboxSettings>;
+/** 注册「内置插件 → 飞书」标签页；宿主不再提供该命名空间时自动撤下。 */
+export declare function mountLarkSettings(ctx: ClientContext): () => void;
+//# sourceMappingURL=lark-inbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lark-inbox.d.ts","sourceRoot":"","sources":["../../../../src/client/settings/lark-inbox.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGnE,OAAO,EAQL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAE7D,OAAO,EAAE,yBAAyB,EAAwB,MAAM,mBAAmB,CAAA;AAEnF,yDAAyD;AACzD,OAAO,EAAE,yBAAyB,EAAE,CAAA;AAEpC,4CAA4C;AAC5C,eAAO,MAAM,oBAAoB,eAAe,CAAA;AAEhD,iBAAiB;AACjB,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;IAC1B,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AA4BD,mBAAmB;AACnB,UAAU,aAAc,SAAQ,iBAAiB;IAC/C,OAAO,EAAE,kBAAkB,CAAA;IAC3B,eAAe,EAAE,kBAAkB,CAAA;IACnC,MAAM,EAAE,kBAAkB,CAAA;IAC1B,qBAAqB,EAAE,kBAAkB,CAAA;IACzC,cAAc,EAAE,kBAAkB,CAAA;IAClC,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,WAAW,EAAE,kBAAkB,CAAA;IAC/B,cAAc,EAAE,kBAAkB,CAAA;CACnC;AAQD,+CAA+C;AAC/C,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsC;IAC3D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,KAAK,EAAE,iBAAiB,CAAC,iBAAiB,CAAC;IAcvD,OAAO,CAAC,UAAU;IAclB,4BAA4B;IAC5B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIjC,OAAO,IAAI,IAAI;CAGhB;AAED,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACzB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,CAAC,GAAG,CAAC,CAAA;IACtD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,IAAI,IAAI,IAAI,CAAA;IACZ,OAAO,IAAI,IAAI,CAAA;IACf,CAAC,EAAE,SAAS,CAAA;CACb;AAkCD,qCAAqC;AACrC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,GAAG,OAAO,CAEhF;AAED,+BAA+B;AAC/B,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CA6FhE;AAYD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,CAEtH;AAED,yCAAyC;AACzC,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,IAAI,CAmBhE"}