dsh-lark-agent 0.2.0 → 0.3.1

package/dist/onboarding/updates.d.ts

@@ -0,0 +1,23 @@
+/** True when `next` is a later release than `current`; a prerelease comes before its release. */
+export declare function newerVersion(next: string, current: string): boolean;
+/** npm's `latest` tag for a package, when it names a stable release. Sends only the package name. */
+export declare function npmLatest(name: string, signal: AbortSignal): Promise<string | undefined>;
+/**
+ * Whether a newer release of this plugin is available, for the settings page.
+ * A status read never waits for the registry: it returns what is known and
+ * starts a background check when one is due. Failures just show no notice.
+ */
+export declare class UpdateCheck {
+    private readonly current;
+    private readonly lookup;
+    private readonly now;
+    private latest?;
+    private nextCheck;
+    private running;
+    constructor(current: string | undefined, lookup: (signal: AbortSignal) => Promise<string | undefined>, now?: () => number);
+    status(): {
+        current: string;
+        latest: string;
+    } | undefined;
+    private refresh;
+}

package/dist/onboarding/updates.js

@@ -0,0 +1,67 @@
+// Read only while the settings page polls, and at most this often once a check succeeds.
+const CHECK_EVERY_MS = 6 * 60 * 60_000;
+// A failed check (offline, blocked registry) waits this long before the next try.
+const RETRY_AFTER_MS = 30 * 60_000;
+const VERSION = /^(\d{1,9})\.(\d{1,9})\.(\d{1,9})(?:-([0-9A-Za-z.-]{1,40}))?$/;
+/** True when `next` is a later release than `current`; a prerelease comes before its release. */
+export function newerVersion(next, current) {
+    const a = VERSION.exec(next), b = VERSION.exec(current);
+    if (!a || !b)
+        return false;
+    for (let index = 1; index <= 3; index++) {
+        const left = Number(a[index]), right = Number(b[index]);
+        if (left !== right)
+            return left > right;
+    }
+    return !a[4] && Boolean(b[4]);
+}
+/** npm's `latest` tag for a package, when it names a stable release. Sends only the package name. */
+export async function npmLatest(name, signal) {
+    const response = await fetch(`https://registry.npmjs.org/-/package/${name.replace('/', '%2f')}/dist-tags`, { signal, headers: { accept: 'application/json' } });
+    if (!response.ok)
+        return;
+    const tags = await response.json();
+    const latest = tags?.latest;
+    return typeof latest === 'string' && VERSION.test(latest) && !latest.includes('-') ? latest : undefined;
+}
+/**
+ * Whether a newer release of this plugin is available, for the settings page.
+ * A status read never waits for the registry: it returns what is known and
+ * starts a background check when one is due. Failures just show no notice.
+ */
+export class UpdateCheck {
+    current;
+    lookup;
+    now;
+    latest;
+    nextCheck = 0;
+    running = false;
+    constructor(current, lookup, now = Date.now) {
+        this.current = current;
+        this.lookup = lookup;
+        this.now = now;
+    }
+    status() {
+        if (!this.current || !VERSION.test(this.current))
+            return;
+        if (!this.running && this.now() >= this.nextCheck)
+            void this.refresh();
+        return this.latest && newerVersion(this.latest, this.current) ? { current: this.current, latest: this.latest } : undefined;
+    }
+    async refresh() {
+        this.running = true;
+        this.nextCheck = this.now() + RETRY_AFTER_MS;
+        try {
+            const latest = await this.lookup(AbortSignal.timeout(10_000));
+            if (latest && VERSION.test(latest)) {
+                this.latest = latest;
+                this.nextCheck = this.now() + CHECK_EVERY_MS;
+            }
+        }
+        catch { /* Offline or blocked: no notice, and a later poll tries again. */ }
+        finally {
+            this.running = false;
+        }
+    }
+}
+//# sourceMappingURL=updates.js.map

package/dist/permission-controls.d.ts

@@ -5,9 +5,16 @@ export interface PermissionView {
     options: PermissionOption[];
     current?: string;
 }
+/** Where the card is: idle, switching to an option, switched, refused with a reason, or refreshed with a notice. */
+export interface PanelState {
+    changed?: boolean;
+    pending?: string;
+    error?: string;
+    notice?: string;
+}
 /** Presets that let Harness act without asking get a second confirmation. */
 export declare const unattended: (id: string) => boolean;
 export declare function permissionStateText(view: PermissionView): string;
 type Issue = (label: string, command: string, primary: boolean, confirm?: ReplyAction['confirm']) => ReplyAction | undefined;
-export declare function permissionPanel(view: PermissionView, issue: Issue, changed?: boolean): ReplyPanel;
+export declare function permissionPanel(view: PermissionView, issue: Issue, state?: PanelState): ReplyPanel;
 export {};

package/dist/permission-controls.js

@@ -3,24 +3,35 @@ export const unattended = (id) => /full|danger|auto/.test(id);
 function currentName(view) {
     if (!view.current)
         return '跟随电脑上的默认设置';
-    return view.options.find(option => option.id === view.current)?.name ?? '自定义（在电脑上调整过）';
+    return optionName(view, view.current) ?? '自定义（在电脑上调整过）';
 }
+const optionName = (view, id) => view.options.find(option => option.id === id)?.name;
 export function permissionStateText(view) {
     return `当前权限模式：${currentName(view)}。\n可选：${view.options.map(option => option.name).join('、')}。只影响这个私聊里的对话。`;
 }
-export function permissionPanel(view, issue, changed = false) {
+export function permissionPanel(view, issue, state = {}) {
     const actions = [];
     for (const option of view.options) {
         const current = option.id === view.current;
-        const action = issue(`${current ? '✓ ' : ''}${option.name}`, `/permission use ${option.id}`, current, !current && unattended(option.id) ? { title: `切换到「${option.name}」？`,
+        // While a switch runs nothing is clickable; afterwards the current option is shown, not offered.
+        if (state.pending || current) {
+            actions.push({ label: `${option.id === state.pending ? '⏳ ' : current ? '✓ ' : ''}${option.name}`, value: {}, disabled: true });
+            continue;
+        }
+        const action = issue(option.name, `/permission use ${option.id}`, false, unattended(option.id) ? { title: `切换到「${option.name}」？`,
             text: '之后 Harness 执行命令、修改文件都不再询问，在飞书发一句话就能直接操作这台电脑。随时可以切回。' } : undefined);
         if (action)
             actions.push(action);
     }
-    const summary = `当前：${currentName(view)}`;
-    return { title: changed ? '权限模式已更新' : '权限模式', subtitle: '只影响这个私聊里的对话', summary,
-        sections: [{ text: summary }, ...view.options.filter(option => option.description).map(option => ({ title: option.name, text: option.description }))],
+    const pendingName = state.pending ? optionName(view, state.pending) ?? state.pending : undefined;
+    const status = state.error ? { text: state.error, tone: 'error' }
+        : pendingName ? { text: `正在切换到「${pendingName}」…`, tone: 'pending' }
+            : state.changed ? { text: `已切换到「${currentName(view)}」`, tone: 'success' }
+                : { text: state.notice ? `${state.notice}\n当前：${currentName(view)}` : `当前：${currentName(view)}` };
+    return { title: state.changed && !state.error ? '权限模式已更新' : '权限模式', subtitle: '只影响这个私聊里的对话',
+        tone: status.tone ?? 'normal', status, summary: status.text,
+        sections: view.options.filter(option => option.description).map(option => ({ title: option.name, text: option.description })),
         actions, actionColumns: 1,
-        note: '需要确认的操作由这里的模式决定；电脑上其他会话和默认设置不受影响。' };
+        note: state.pending ? '完成后会在这张卡片上更新，无需重复点击。' : '需要确认的操作由这里的模式决定；电脑上其他会话和默认设置不受影响。' };
 }
 //# sourceMappingURL=permission-controls.js.map

package/dist/replies.d.ts

@@ -17,11 +17,21 @@ export interface ReplyAction {
         title: string;
         text: string;
     };
+    /** Shown but not clickable, such as the current choice or every option while a switch runs. */
+    disabled?: boolean;
 }
+/** normal: blue; pending: a switch is running; success: green; error: red; muted: closed or expired. */
+export type PanelTone = 'normal' | 'pending' | 'success' | 'error' | 'muted';
 export interface ReplyPanel {
     title: string;
     summary: string;
     subtitle?: string;
+    tone?: PanelTone;
+    /** One highlighted line under the header: the current choice, a running switch, or its result. */
+    status?: {
+        text: string;
+        tone?: PanelTone;
+    };
     metrics?: {
         label: string;
         value: string;

package/dist/replies.js

@@ -157,15 +157,27 @@ const column = (elements, extra = {}) => ({
     tag: 'column', width: 'weighted', weight: 1, direction: 'vertical',
     vertical_spacing: '4px', padding: '0px', margin: '0px', elements, ...extra,
 });
+const TONES = {
+    normal: { header: 'blue', background: 'grey-50', icon: 'info_outlined', color: 'grey' },
+    pending: { header: 'wathet', background: 'blue-50', icon: 'loading_outlined', color: 'blue' },
+    success: { header: 'green', background: 'green-50', icon: 'done_outlined', color: 'green' },
+    error: { header: 'red', background: 'red-50', icon: 'warning_outlined', color: 'red' },
+    muted: { header: 'grey', background: 'grey-50', icon: 'time_outlined', color: 'grey' },
+};
 /** Trusted application panels only. Model strings never choose components or callback values. */
 export function renderPanel(panel) {
     const metrics = (panel.metrics ?? []).filter(metric => metric.label.trim() || metric.value.trim());
-    const fallbackText = safePlainText([panel.title, panel.subtitle,
+    const fallbackText = safePlainText([panel.title, panel.subtitle, panel.status?.text,
         ...metrics.map(metric => [`${metric.label}：${metric.value}`, metric.note].filter(Boolean).join('\n')),
         ...panel.sections.map(section => [section.title, section.text].filter(Boolean).join('\n')), panel.note]
         .filter(Boolean).join('\n\n'));
     const elements = [];
     const actions = panel.actions ?? [];
+    if (panel.status?.text.trim()) {
+        const tone = TONES[panel.status.tone ?? 'normal'];
+        elements.push({ tag: 'column_set', flex_mode: 'none', margin: '0px', columns: [column([{ ...md(panel.status.text),
+                        icon: { tag: 'standard_icon', token: tone.icon, color: tone.color } }], { background_style: tone.background, padding: '8px 12px 8px 12px' })] });
+    }
     for (let start = 0; start < metrics.length; start += 2) {
         elements.push({ tag: 'column_set', flex_mode: 'none', horizontal_spacing: '8px', margin: '0px',
             columns: metrics.slice(start, start + 2).map(metric => column([
@@ -206,8 +218,8 @@ export function renderPanel(panel) {
     for (let start = 0; start < actions.length; start += actionColumns) {
         elements.push({ tag: 'column_set', flex_mode: panel.actionColumns ? 'none' : 'flow', horizontal_spacing: '8px', margin: '0px', columns: actions.slice(start, start + actionColumns).map(action => column([
                 { tag: 'button', text: title(plainLabel(action.label, panel.actionColumns === 1 ? 64 : 24)), type: action.primary ? 'primary' : 'default', width: 'fill', margin: '0px',
-                    behaviors: [{ type: 'callback', value: { ...action.value } }],
-                    ...(action.confirm ? {
+                    ...(action.disabled ? { disabled: true } : { behaviors: [{ type: 'callback', value: { ...action.value } }] }),
+                    ...(action.confirm && !action.disabled ? {
                         icon: { tag: 'standard_icon', token: 'warning_outlined' },
                         confirm: { title: title(plainLabel(action.confirm.title, 80)), text: title(plainLabel(action.confirm.text, 300)) },
                     } : {}),
@@ -222,9 +234,10 @@ export function renderPanel(panel) {
         return { kind: 'text', text: fallbackText };
     const card = {
         schema: '2.0',
-        config: { compact_width: false, width_mode: 'default', enable_forward: false, enable_forward_interaction: false,
+        // Shared from the start, so a click can update this same card in place.
+        config: { update_multi: true, compact_width: false, width_mode: 'default', enable_forward: false, enable_forward_interaction: false,
             enable_markdown_autolink: false, summary: { content: summary } },
-        header: { template: 'blue', title: title(plainLabel(panel.title, 80)), padding: '10px 16px 10px 16px',
+        header: { template: TONES[panel.tone ?? 'normal'].header, title: title(plainLabel(panel.title, 80)), padding: '10px 16px 10px 16px',
             ...(panel.subtitle?.trim() ? { subtitle: title(safePlainText(panel.subtitle)), vertical_spacing: '4px' } : {}) },
         body: { direction: 'vertical', vertical_spacing: '8px', padding: '12px 16px 12px 16px', elements },
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-lark-agent",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Reach your DeepSeek Harness assistant from Feishu / Lark: a dsh plugin built on the official Lark CLI",
   "keywords": [
     "deepseek",
@@ -73,13 +73,13 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "4.0.1 || 4.0.5",
-    "@deepseek-ai/dsh-agent": "0.1.1-rc.2 || 0.2.1-rc.2",
-    "@deepseek-ai/dsh-llm": "0.1.1-rc.2 || 0.2.1-rc.2",
-    "@deepseek-ai/dsh-session": "0.1.1-rc.2 || 0.2.1-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "0.1.1-rc.2 || 0.2.1-rc.2",
-    "@deepseek-ai/dsh-tools": "0.1.1-rc.2 || 0.2.1-rc.2",
+    "@deepseek-ai/dsh-agent": "0.1.1-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3",
+    "@deepseek-ai/dsh-llm": "0.1.1-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3",
+    "@deepseek-ai/dsh-session": "0.1.1-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3",
+    "@deepseek-ai/dsh-system-prompt": "0.1.1-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3",
+    "@deepseek-ai/dsh-tools": "0.1.1-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3",
     "@deepseek-ai/schemastery": "3.18.1 || 3.18.5",
-    "@deepseek-ai/dsh-session-persistence": "0.1.1-rc.2 || 0.2.1-rc.2"
+    "@deepseek-ai/dsh-session-persistence": "0.1.1-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.1",