dsh-lark-agent 0.3.2 → 0.4.0

package/README.md

@@ -30,8 +30,6 @@ Before you start:
 
 In the sidebar, open **插件 → 添加插件** (Plugins → Add plugin), enter `dsh-lark-agent`, click **安装** (Install), then **立即启用** (Enable now). Restart if the app asks.
 
-<img src="https://raw.githubusercontent.com/Nirvana-Jie/dsh-lark-agent/main/assets/readme/desktop-install-02.jpg" width="720" alt="The Add plugin dialog in the DeepSeek Harness desktop app">
-
 ### Install with the `dsh` CLI
 
 [`dsh plugin`](https://www.npmjs.com/package/@deepseek-ai/dsh) runs pnpm, so pnpm must be on your PATH:
@@ -68,7 +66,7 @@ Button labels are quoted in Chinese, as they appear, with an English gloss.
 3. Click **打开飞书私聊** (open private chat) and, from the account that scanned, send the pairing word (`DSH-…`, valid for 10 minutes) as a plain-text message on its own, exactly as shown. If asked, confirm with **这是我，完成连接** (this is me).
 4. When the page shows **已连接** (connected), send the bot a message.
 
-The Feishu entry works only while the host is online: not when the app is closed, the web host is stopped, or the computer sleeps.
+The connection's model check does not create a “飞书连接测试” conversation in Harness. The Feishu entry works only while the host is online: not when the app is closed, the web host is stopped, or the computer sleeps.
 
 ## What it can do
 
@@ -80,7 +78,7 @@ The Feishu entry works only while the host is online: not when the app is closed
 | Use `/permission`, or **设置 → 权限模式** (Settings → Permission mode) in the bottom menu | Switches between read-only, workspace edits and full access, like the app's permission selector; full access stops asking. The card you tap updates in place and turns green when done |
 | Ask for the result file | Sends files from its workspace straight to the chat |
 | Say "lead with the conclusion from now on" | Remembers the preference |
-| Keep chatting, or use `/sessions`, `/new` | Continues the topic, returns to an earlier one, or starts fresh |
+| Continue inside a topic, or use `/sessions`, `/new` | Keeps each conversation in its own native Feishu topic; reply beneath a new topic's entry card, or use the searchable, paged dropdown to reopen an earlier topic |
 | Ask for a bar chart of some numbers | Replies with a native Feishu chart card |
 | Ask it to let you pick between options first | Sends a form card and continues once you submit |
 | Ask for an architecture diagram or a report | Creates a Feishu doc (with a whiteboard for diagrams) shared read-only with you alone; in App `0.2.1-rc.2` / `rc.3`, opening that Feishu session in the app also shows a local preview |
@@ -88,6 +86,8 @@ The Feishu entry works only while the host is online: not when the app is closed
 
 By default it answers only your own private chat. In that chat the assistant is your Harness itself: the tools it can use and the actions that need your confirmation follow the permission settings on your computer. Sessions and memory stay on the computer running Harness; messages pass through Feishu and your model provider.
 
+A new request in the main chat opens a topic; continue inside that topic to keep its context. Authorized group chats work the same way and still require an @mention on each message. `/new` opens another topic and keeps the earlier ones available.
+
 ## Good to know
 
 - **More docs**: commands, privacy, upgrades, the chat bottom menu, team deployment and troubleshooting are in [DEVELOPMENT.md](https://github.com/Nirvana-Jie/dsh-lark-agent/blob/main/DEVELOPMENT.md) (Chinese).

package/dist/bot-menu.d.ts

@@ -10,6 +10,12 @@ export declare const BOT_MENU_COMMANDS: Readonly<{
 }>;
 export type BotMenuCommand = (typeof BOT_MENU_COMMANDS)[keyof typeof BOT_MENU_COMMANDS];
 export declare function botMenuCommand(eventKey: unknown): BotMenuCommand | undefined;
+/** A menu entry as the owner adds it in the developer console. */
+export interface BotMenuEntry {
+    label: string;
+    eventKey: string;
+    parent?: string;
+}
 export interface BotMenuNode {
     menu_id: string;
     parent_menu_id?: string;
@@ -32,6 +38,12 @@ export declare function buildBotMenuAbility(): {
         bot_menus: BotMenuNode[];
     };
 };
+/**
+ * The entries a published menu lacks, by label. A menu configured by hand
+ * before a release added an entry stays without it; none is reported when
+ * no dsh entry was configured at all.
+ */
+export declare function missingBotMenuEntries(eventKeys: readonly string[]): BotMenuEntry[];
 /** Pure review/export plan: this module never invokes an API or changes an app. */
 export declare function buildBotMenuPlan(appId: string): {
     scope: string;

package/dist/bot-menu.js

@@ -29,6 +29,20 @@ export function buildBotMenuAbility() {
                 { menu_id: 'dsh_permission', parent_menu_id: 'dsh_settings', sort: 2, default_name: '权限模式', menu_content_type: 2, event_key: 'dsh.permission' },
             ] } };
 }
+/**
+ * The entries a published menu lacks, by label. A menu configured by hand
+ * before a release added an entry stays without it; none is reported when
+ * no dsh entry was configured at all.
+ */
+export function missingBotMenuEntries(eventKeys) {
+    const nodes = buildBotMenuAbility().bot.bot_menus, entries = nodes.filter(node => node.event_key);
+    if (!entries.some(node => eventKeys.includes(node.event_key)))
+        return [];
+    return entries.filter(node => !eventKeys.includes(node.event_key)).map(node => {
+        const parent = nodes.find(candidate => candidate.menu_id === node.parent_menu_id)?.default_name;
+        return { label: node.default_name, eventKey: node.event_key, ...(parent ? { parent } : {}) };
+    });
+}
 /** Pure review/export plan: this module never invokes an API or changes an app. */
 export function buildBotMenuPlan(appId) {
     if (typeof appId !== 'string' || !/^cli_[A-Za-z0-9_-]{1,128}$/.test(appId))

package/dist/bot-service.js

@@ -14,6 +14,7 @@ import { ModelPreferencesStore } from './model-preferences.js';
 import { ArtifactStore } from './artifacts.js';
 import { LarkArtifactPublisher } from './artifact-publisher.js';
 import { PermissionPreferencesStore } from './permission-preferences.js';
+import { TopicStore } from './topic-store.js';
 /** A failed close is still an owned service, never a disposable startup error. */
 export class BotServiceStartError extends Error {
     service;
@@ -38,6 +39,7 @@ export async function createBotService(ctx, config, onHealth = () => undefined,
             config.cardInteractions ? CardActions.open(config.stateDir, JSON.stringify([config.profile, config.botOpenId])) : undefined,
             DirectChatsStore.open(config.stateDir), ModelPreferencesStore.open(config.stateDir), ArtifactStore.open(config.stateDir),
             PermissionPreferencesStore.open(config.stateDir),
+            TopicStore.open(config.stateDir),
         ];
         // An opener may create signing state: finish all openers before releasing
         // ownership after a sibling fails, so no old writer outlives the lock.
@@ -45,7 +47,7 @@ export async function createBotService(ctx, config, onHealth = () => undefined,
         const failed = openedStores.find(result => result.status === 'rejected');
         if (failed?.status === 'rejected')
             throw failed.reason;
-        const [sessions, memories, actions, directChats, modelPreferences, artifacts, permissionPreferences] = await Promise.all(openingStores);
+        const [sessions, memories, actions, directChats, modelPreferences, artifacts, permissionPreferences, topics] = await Promise.all(openingStores);
         if (startup?.directChat) {
             const { openId, chatId } = startup.directChat;
             if (!config.users.some(user => user.openId === openId && user.direct))
@@ -61,7 +63,7 @@ export async function createBotService(ctx, config, onHealth = () => undefined,
             ? new LarkCli({ profile: config.profile, executable: config.executable, eventKey: 'application.bot.menu_v6' }) : undefined;
         const progressTransport = config.loadingReaction
             ? new LarkCli({ profile: config.profile, executable: config.executable, commandTimeoutMs: 5_000 }) : undefined;
-        const bridge = new BotBridge(config, new DshRuntime(ctx), transport, ledger, { sessions, memories, actions, directChats, modelPreferences, artifacts, permissionPreferences }, event => console.info(`[im-larkbot] ${JSON.stringify(event)}`), progressTransport, new LarkArtifactPublisher(config.profile, config.botOpenId, { executable: config.executable }));
+        const bridge = new BotBridge(config, new DshRuntime(ctx), transport, ledger, { sessions, memories, actions, directChats, modelPreferences, artifacts, permissionPreferences, topics }, event => console.info(`[im-larkbot] ${JSON.stringify(event)}`), progressTransport, new LarkArtifactPublisher(config.profile, config.botOpenId, { executable: config.executable }));
         let stopped = false, started = false, healthy = false;
         const readiness = { messages: false, cards: !callbacks, menu: !menu };
         let stopping;

package/dist/bridge.d.ts

@@ -10,6 +10,7 @@ import { type ModelPreferencesStore } from './model-preferences.js';
 import type { PermissionPreferencesStore } from './permission-preferences.js';
 import type { ArtifactStore } from './artifacts.js';
 import type { ArtifactPublisher } from './artifact-publisher.js';
+import { type TopicStore, type TopicReceipt } from './topic-store.js';
 export interface Runtime {
     create(policy: AgentPolicy): Promise<RuntimeSession>;
     resume(policy: AgentPolicy, id: string): Promise<RuntimeSession>;
@@ -32,6 +33,7 @@ export interface BotState {
     };
     artifacts?: Pick<ArtifactStore, 'add' | 'get' | 'list' | 'claimPublish' | 'publication' | 'submit'>;
     permissionPreferences?: Pick<PermissionPreferencesStore, 'get' | 'set'>;
+    topics?: Pick<TopicStore, 'get' | 'list' | 'record' | 'occupied'>;
 }
 export interface Transport {
     reply(messageId: string, text: string, options: {
@@ -69,6 +71,15 @@ export interface Transport {
         inThread: boolean;
         image: boolean;
     }): Promise<void>;
+    openTopic?(target: {
+        chatId: string;
+        messageId?: string;
+    }, title: string, options: {
+        idempotencyKey: string;
+        chatType?: 'p2p' | 'group';
+        textOnly?: boolean;
+    }): Promise<TopicReceipt>;
+    topicLink?(messageId: string): Promise<string | undefined>;
 }
 export type Audit = (event: {
     stage: string;
@@ -97,6 +108,8 @@ export declare class BotBridge {
     private readonly progress;
     private readonly interactions;
     private liveUnavailableUntil;
+    private readonly topicCreations;
+    private readonly topicResumes;
     constructor(config: BotConfig, runtime: Runtime, transport: Transport, ledger: MessageLedger, state: BotState, audit?: Audit, progressTransport?: ProgressTransport, artifactPublisher?: ArtifactPublisher | undefined);
     setCardActionsReady(ready: boolean): void;
     private parseIncoming;
@@ -131,8 +144,19 @@ export declare class BotBridge {
     /** Redraw a stale card with the current state, without running its command. */
     private refreshPanel;
     private commandFeedback;
+    private topicsEnabled;
+    private topicScope;
+    private newTopicKey;
+    private entryKey;
+    private reserveTopic;
+    private createTopic;
     private context;
     private sessionContext;
+    private catalogContext;
+    /** Only this user's chat and current disclosure epoch participate in the picker. */
+    private topicSessions;
+    private continueTopic;
+    private topicNavigation;
     private policy;
     private ensureSession;
     private bindRestoredSession;
@@ -154,6 +178,7 @@ export declare class BotBridge {
     private permissionCommand;
     /** Bring a newly opened harness session to the chat's choice, or a new one without a choice to the App's default. */
     private applyPermission;
+    private permissionContext;
     /** A preset changed in the App on this chat's live session becomes the chat's choice, so new sessions keep it. */
     private adoptPermission;
     private modelState;