dsh-lark-agent 0.2.0 → 0.3.1

package/README.md

@@ -16,7 +16,7 @@ dsh-lark-agent adds a Feishu / Lark private chat to a running DeepSeek Harness:
 
 Before you start:
 
-- DeepSeek Harness is running, can chat, and has a default model selected: PC App `0.2.1-rc.2`, or Web / `dsh` CLI `0.1.1-rc.2`.
+- DeepSeek Harness is running, can chat, and has a default model selected: PC App `0.2.1-rc.3` (`0.2.1-rc.2` also works), or Web / `dsh` CLI `0.1.1-rc.2`.
 - The official Lark CLI is installed on the same machine **before** you enable the plugin (needs Node.js / npm):
 
   ```sh
@@ -53,6 +53,8 @@ Then restart `dsh web`.
 
 ### Update
 
+When a new version is out, the Feishu settings page shows a notice with these steps (in the desktop app it also opens the plugin list for you).
+
 1. On the Feishu settings page, click **暂停连接** (pause) and back up as described in [Upgrade](https://github.com/Nirvana-Jie/dsh-lark-agent/blob/main/DEVELOPMENT.md#升级).
 2. Desktop app: the Add plugin dialog says third-party plugins must be uninstalled before a new version is installed, so uninstall `dsh-lark-agent` on the Plugins page and add it again (this in-app upgrade hasn't been tested end to end yet; an earlier source build is listed as `dsh-larkbot`). CLI: run `dsh plugin --profile web update dsh-lark-agent@latest`, then restart `dsh web`.
 3. Click **恢复连接** (resume) and check that the bot replies.
@@ -72,24 +74,24 @@ The Feishu entry works only while the host is online: not when the app is closed
 
 | In Feishu, you… | The assistant… |
 | --- | --- |
-| Send a request | Works on it with Harness's own tools (web search, reading pages, workspace files and more), streaming the reply live into one card, with its thinking and tool steps folded inside |
+| Send a request | Works on it with Harness's own tools (web search, reading pages, workspace files and more), streaming the reply live into one card; its thinking and tool steps are folded inside, step by step as in the app, and the card ends with the model, thinking depth and permission mode it used |
 | Ask for something that needs your OK | Sends a confirmation card: tap **允许一次** (allow once) or **拒绝** (deny); no answer within 5 minutes means it won't run |
 | Get asked to choose by Harness | Sends a choice card: tap an option, or fill it in and submit |
-| Use `/permission`, or 权限模式 in the model settings card | Switches between read-only, workspace edits and full access, like the app's permission selector; full access stops asking |
+| 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 |
 | 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`, opening that Feishu session in the app also shows a local preview |
-| Use `/model`, `/thinking` | Switches between the host's configured models and thinking depth |
+| 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 |
+| Use `/model`, `/thinking` | Switches between the host's configured models and thinking depth, in sync with Harness on your computer (App `0.2.1-rc.2` / `rc.3`) |
 
 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.
 
 ## 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).
-- **Compatibility**: verified with PC App `0.2.1-rc.2` and `dsh` CLI / Web `0.1.1-rc.2`; other versions, platforms and tenants are not yet verified.
+- **Compatibility**: fully verified with PC App `0.2.1-rc.2` and `dsh` CLI / Web `0.1.1-rc.2`. PC App `0.2.1-rc.3` passes the real-host contract tests, and the plugin loads and connects on it (first-time QR setup on rc.3 is not tested yet). Other versions, platforms and tenants are not yet verified.
 - **Language**: the settings page, the bot's built-in messages (`/help`, status text, card buttons, bottom menu) and the intro video are in Chinese.
 
 ## License

package/dist/bot-menu.d.ts

@@ -20,7 +20,8 @@ export interface BotMenuNode {
 }
 /**
  * Public Application Ability PATCH payload. Publishing is a separate admin action.
- * Five flat nodes fit both documented floating-menu limit variants.
+ * Three top-level nodes with three children fit both documented floating-menu
+ * limit variants (at most five per level and ten in all).
  * Text actions cannot separate a friendly label from the text they send.
  */
 export declare function buildBotMenuAbility(): {

package/dist/bot-menu.js

@@ -6,7 +6,6 @@ export const BOT_MENU_COMMANDS = Object.freeze({
     'dsh.sessions': '/sessions',
     'dsh.model': '/model',
     'dsh.thinking': '/thinking',
-    // Optional: not in the default five-node menu; an owner may add it under 设置.
     'dsh.permission': '/permission',
 });
 export function botMenuCommand(eventKey) {
@@ -16,7 +15,8 @@ export function botMenuCommand(eventKey) {
 }
 /**
  * Public Application Ability PATCH payload. Publishing is a separate admin action.
- * Five flat nodes fit both documented floating-menu limit variants.
+ * Three top-level nodes with three children fit both documented floating-menu
+ * limit variants (at most five per level and ten in all).
  * Text actions cannot separate a friendly label from the text they send.
  */
 export function buildBotMenuAbility() {
@@ -26,6 +26,7 @@ export function buildBotMenuAbility() {
                 { menu_id: 'dsh_settings', sort: 2, default_name: '设置', menu_content_type: 3 },
                 { menu_id: 'dsh_model', parent_menu_id: 'dsh_settings', sort: 0, default_name: '模型', menu_content_type: 2, event_key: 'dsh.model' },
                 { menu_id: 'dsh_thinking', parent_menu_id: 'dsh_settings', sort: 1, default_name: '思考深度', menu_content_type: 2, event_key: 'dsh.thinking' },
+                { menu_id: 'dsh_permission', parent_menu_id: 'dsh_settings', sort: 2, default_name: '权限模式', menu_content_type: 2, event_key: 'dsh.permission' },
             ] } };
 }
 /** Pure review/export plan: this module never invokes an API or changes an app. */

package/dist/bridge.d.ts

@@ -16,6 +16,10 @@ export interface Runtime {
     catalog?(): Promise<ModelCatalog>;
     resolveModelSelection?(selection?: ModelSelection): Promise<ModelSelection>;
     permissionOptions?(): PermissionOption[];
+    /** Harness sessions share their model choice with the App (see RuntimeSession.sharesModelSelection). */
+    sharesModelSelection?(): boolean;
+    /** Make a choice the App's default for new sessions, as the App's model selector does. */
+    saveDefaultModel?(selection: ModelSelection): Promise<void>;
 }
 export interface BotState {
     sessions: Pick<SessionStore, 'current' | 'list' | 'add' | 'activate' | 'archive' | 'rename' | 'touch'> & Partial<Pick<SessionStore, 'rebindNative'>>;
@@ -99,6 +103,8 @@ export declare class BotBridge {
     accept(raw: unknown): Promise<void>;
     private acceptMessage;
     private process;
+    /** The model, thinking depth and permission mode a reply runs with, by name. */
+    private settingsLine;
     /** Whether this message's reply streams into a live card, which makes the typing reaction redundant. */
     private streams;
     private liveTransport;
@@ -114,6 +120,16 @@ export declare class BotBridge {
     private answerInteraction;
     /** Send files the host's delivery tool presented, from this user's workspace only. */
     private deliverFiles;
+    /** A private-chat click on a settings or topic panel, which can update the clicked card. */
+    private inPlace;
+    /**
+     * Run a panel click and show its progress and result on the clicked card. That
+     * card exists, so a failed progress frame never holds back the result, and an
+     * unconfirmed update is never followed by another message.
+     */
+    private panelInPlace;
+    /** Redraw a stale card with the current state, without running its command. */
+    private refreshPanel;
     private commandFeedback;
     private context;
     private sessionContext;
@@ -123,16 +139,29 @@ export declare class BotBridge {
     private unload;
     private command;
     private harness;
+    /**
+     * The owner's harness chat on the App host shares model and thinking depth
+     * with the App, like any App session; an administrator's fixed route does not.
+     */
+    private sharedModel;
+    /** Record what an opened session runs as the chat's copy: the first capture, or a shared session's own record. */
+    private mirrorModel;
     /** The host's presets, from the live session when there is one. Undefined when the host offers none. */
     private permissionView;
     /** What this chat runs: the live session's preset, else the chat's saved choice. */
     private permissionChoice;
     /** Owner-only: switch this private chat's Harness permission preset, like the App's selector. */
     private permissionCommand;
-    /** Bring a newly opened harness session to the chat's saved permission preset. */
+    /** 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;
+    /** 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;
     private modelCommand;
+    /**
+     * The management card for a command. `card` describes a click being shown on
+     * its own card: the switch in flight, its refusal, or a refresh of a stale card.
+     */
     private commandPanel;
     private reply;
     private artifactContext;