@nanmicoder/dsh-agent-teams 0.1.8 → 0.1.10

package/lib/types/client/activity-model.d.ts

@@ -39,10 +39,10 @@ export declare function usesParallelTaskGrid<T extends RelationshipTask>(tasks:
 /**
  * Whether an expanded activity panel still belongs to the current session.
  *
- * The panel is mounted through a body portal, so React does not remount it
- * when the conversation route changes. Ownership keeps an expanded panel
- * from leaking onto the new-session screen (or another conversation) while
- * its local open state is being reset.
+ * The panel is mounted in the root-scoped shell overlay, so React does not
+ * remount it when the conversation route changes. Ownership keeps an expanded
+ * panel from leaking onto the new-session screen (or another conversation)
+ * while its local open state is being reset.
  */
 export declare function activityPanelExpandedForSession(open: boolean, owner: string | undefined, current: string | undefined): boolean;
 /**

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

@@ -7,7 +7,7 @@
 /** Artwork route prefix served by the plugin host half. */
 export declare const ART_BASE = "/plugins/dsh-agent-teams/assets/";
 /** Captain artwork (always the lead whale). */
-export declare const LEAD_ART = "/plugins/dsh-agent-teams/assets/team-lead.png";
+export declare const LEAD_ART = "/plugins/dsh-agent-teams/assets/team-lead-v2.png";
 /** Status action artwork per member activity. */
 export declare const ACTION_ART: Record<'working' | 'idle' | 'unknown', string>;
 /**

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

@@ -3,9 +3,8 @@ import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
 /** Required services: conversation nodes, slots, and sessions navigation. */
 export declare const inject: string[];
 /**
- * Mount the floater through a body portal (the web shell has no top-right
- * slot) and register the in-conversation team card, whose "activity panel"
- * button re-activates the floater via a window event — the recovery path
- * for a closed floater or a re-opened session.
+ * Register the activity monitor in the shell's additive overlay and the
+ * in-conversation team card. The card's activity button re-opens a folded
+ * monitor via a window event — the recovery path for an old session.
  */
 export declare function apply(ctx: ClientContext): void;

package/lib/types/client/panel-geometry.d.ts

@@ -0,0 +1,49 @@
+/** Pure persisted geometry rules for the AgentTeams shell-overlay panel. */
+export type PanelMode = 'docked' | 'floating';
+export type PanelHeightMode = 'auto' | 'manual';
+export type PanelResizeEdge = 'left' | 'bottom' | 'corner';
+/** User-owned panel state persisted between browser sessions. */
+export interface PanelLayout {
+    readonly mode: PanelMode;
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly heightMode: PanelHeightMode;
+}
+/** The shell-overlay box and the right edge of its current conversation. */
+export interface PanelBounds {
+    readonly width: number;
+    readonly height: number;
+    readonly anchorRight: number;
+}
+export declare const PANEL_LAYOUT_STORAGE_KEY = "dsh-agent-teams:activity-panel:v1";
+export declare const PANEL_COMPACT_BREAKPOINT = 960;
+export declare const PANEL_DEFAULT_WIDTH = 388;
+export declare const PANEL_DEFAULT_HEIGHT = 640;
+export declare const PANEL_MIN_WIDTH = 320;
+export declare const PANEL_MAX_WIDTH = 640;
+export declare const PANEL_MIN_HEIGHT = 360;
+export declare const PANEL_DOCK_TOP = 64;
+export declare const PANEL_DOCK_RIGHT = 18;
+export declare const PANEL_DOCK_BOTTOM = 48;
+export declare const PANEL_FLOAT_MARGIN = 12;
+export declare const DEFAULT_PANEL_LAYOUT: PanelLayout;
+/** Decode one versioned localStorage value, rejecting partial/corrupt state. */
+export declare function parsePanelLayout(value: string | null): PanelLayout;
+/** Whether the panel should become a simple inset overlay with no gestures. */
+export declare function compactPanelForBounds(bounds: PanelBounds): boolean;
+/** Docked and compact panels always fit content; floating panels may be user-sized. */
+export declare function panelUsesAutoHeight(layout: PanelLayout, bounds: PanelBounds): boolean;
+/** CSS max-height ceiling that keeps an auto-height panel inside its shell. */
+export declare function panelMaximumHeight(layout: PanelLayout, bounds: PanelBounds): number;
+/** Resolve persisted state into a visible rectangle inside the current shell. */
+export declare function resolvePanelGeometry(layout: PanelLayout, bounds: PanelBounds): PanelLayout;
+/** Undock without a visual jump by adopting the panel's resolved rectangle. */
+export declare function floatPanelLayout(geometry: PanelLayout, bounds: PanelBounds): PanelLayout;
+/** Return to the right dock, preserving width and restoring content-fit height. */
+export declare function dockPanelLayout(layout: PanelLayout, bounds: PanelBounds): PanelLayout;
+/** Translate a floating panel and clamp it back into the visible shell. */
+export declare function movePanelLayout(start: PanelLayout, dx: number, dy: number, bounds: PanelBounds): PanelLayout;
+/** Resize while keeping the edge opposite the active handle stationary. */
+export declare function resizePanelLayout(start: PanelLayout, edge: PanelResizeEdge, dx: number, dy: number, bounds: PanelBounds): PanelLayout;

package/lib/types/command.d.ts

@@ -8,18 +8,16 @@
  *    `/agent-teams` command. The web GUI's slash menu (the Harness
  *    `ui-commands` client) lists it from the host catalog with the input
  *    hint; the argued line is claimed client-side and executed through
- *    `command.execute` WITHOUT ever reaching the model. The handler queues
- *    one explicit activation message as an ordinary follow-up turn
- *    (`agent.followup`), so the captain protocol starts deterministically —
- *    no "use AgentTeams" phrasing required.
+ *    `command.execute`. The handler replays that exact line as an ordinary
+ *    user follow-up (`agent.followup`) so it remains visible in the chat; the
+ *    gesture boundary then adds the deterministic activation message.
  * 2. **Gesture boundary** — a `agent/pre-step` listener recognizes a leading
  *    `/agent-teams` token in genuine user messages and injects the same
  *    activation message. This covers surfaces with no command adjudication
- *    (headless CLI, API, pasted text in plain composers) and is a no-op for
- *    the command path, whose line is consumed before it can become a prompt.
- *    Mid-sentence mentions stay ordinary prose; only `source.kind === 'user'`
- *    messages are scanned, so injected or external text cannot forge the
- *    gesture.
+ *    (headless CLI, API, pasted text in plain composers) and also handles the
+ *    exact user line replayed by the host command. Mid-sentence mentions stay
+ *    ordinary prose; only `source.kind === 'user'` messages are scanned, so
+ *    injected or external text cannot forge the gesture.
  *
  * @module dsh-agent-teams/command
  */
@@ -30,8 +28,8 @@ export declare const AGENT_TEAMS_COMMAND = "agent-teams";
 declare module '@deepseek-ai/dsh-llm' {
     interface MessageSourceMap {
         /**
-         * A deterministic `/agent-teams` activation: the goal the user supplied,
-         * delivered as an ordinary follow-up turn instead of the raw slash line.
+         * A deterministic `/agent-teams` activation injected after the visible
+         * user-authored slash line.
          */
         'agent-teams-command': {
             readonly kind: 'agent-teams-command';
@@ -55,10 +53,11 @@ export declare function buildActivationDirective(goal: string): string;
 export declare function invokedAgentTeamsGoal(messages: readonly UserMessage[]): string | undefined;
 /**
  * Register the closed-namespace `/agent-teams` host command. The handler
- * runs against the receiving agent without sending the slash line to the
- * model: it queues the activation message as an ordinary follow-up turn and
- * wakes the driver. The registration rides the calling context's fiber, so
- * a disposed scope (HMR, plugin removal) unregisters the command.
+ * preserves the exact submitted slash line as an ordinary user follow-up;
+ * the pre-step gesture boundary injects the activation directive and wakes
+ * the captain deterministically. The registration rides the calling
+ * context's fiber, so a disposed scope (HMR, plugin removal) unregisters the
+ * command.
  * @param ctx - host context providing the `commands` registry.
  */
 export declare function registerAgentTeamsCommand(ctx: Context): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanmicoder/dsh-agent-teams",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "AgentTeams for DeepSeek Harness: multi-agent team collaboration (captain, members, tasks with dependencies, messaging) driven by natural language, with a tree monitor in the web GUI",
   "type": "module",
   "main": "lib/index.js",
@@ -21,7 +21,9 @@
     "lib",
     "assets/agent-teams",
     "assets/readme",
+    "assets/ui.png",
     "cordis.patch.yml",
+    "release-notes",
     "README.md",
     "README_ZH.md"
   ],
@@ -64,19 +66,12 @@
       "inject": [
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-client-ui-conversation"
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-layout"
       ],
       "platform": "web"
     }
   },
-  "dshClient": {
-    "inject": [
-      "@deepseek-ai/dsh-client-locale",
-      "@deepseek-ai/dsh-client-runtime",
-      "@deepseek-ai/dsh-client-ui-conversation"
-    ],
-    "platform": "web"
-  },
   "scripts": {
     "build": "tsc -p tsconfig.json && tsc -p tsconfig.client.json && tsdown",
     "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.client.json --noEmit",
@@ -91,6 +86,7 @@
     "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-layout": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-commands": "^0.1.0-rc.6",
@@ -118,6 +114,9 @@
     "@deepseek-ai/dsh-client-ui-conversation": {
       "optional": true
     },
+    "@deepseek-ai/dsh-client-ui-layout": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-client-ui-primitives": {
       "optional": true
     },
@@ -151,19 +150,20 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-locale": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-commands": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-llm": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-session": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-subagent": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-system-prompt": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-tools": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-workspace": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-agent": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-locale": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-layout": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-commands": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-llm": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-session": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-subagent": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-system-prompt": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-tools": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-workspace": "0.1.0-rc.8",
     "@deepseek-ai/schemastery": "^3.18.1",
     "@types/node": "^24.13.3",
     "@types/react": "~18.3.1",

package/release-notes/v0.1.10.md

@@ -0,0 +1,48 @@
+# AgentTeams v0.1.10
+
+This release makes the AgentTeams activity panel easier to place and size, fixes the `/agent-teams` conversation history, and gives the whale roles a cleaner visual treatment. It is tested against DeepSeek Harness `0.1.0-rc.8`.
+
+## New & Improved
+
+- **Movable and resizable activity panel**: switch between docked and floating layouts, drag the floating panel by its header, and resize it from the supported edges and corner. Position, size, and dock mode persist across refreshes.
+- **Content-aware height**: the panel grows with its content and only introduces internal scrolling after reaching the viewport safety limit, avoiding a large empty area for smaller teams.
+- **Cleaner role portraits**: captain and member artwork now uses transparent, uncropped character silhouettes with clearer sizing, lighter state stickers, and a compact unread indicator.
+
+## Fixes
+
+- Preserved the exact `/agent-teams ...` input as the normal user message in the main conversation.
+- Kept command context injections below the user message in chronological order.
+- Removed the duplicate slash-command result row while retaining the durable command events.
+
+## Installation
+
+```sh
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams
+```
+
+<details>
+<summary><b>中文版本 / Chinese Version</b></summary>
+
+# AgentTeams v0.1.10
+
+本次更新重点改善 AgentTeams 活动面板的摆放与尺寸体验，修复 `/agent-teams` 在主会话中的消息展示，并重新整理鲸鱼角色头像的视觉层级。已基于 DeepSeek Harness `0.1.0-rc.8` 完成验证。
+
+## 新增与改进
+
+- **活动面板支持移动和缩放**：可在停靠与浮动布局之间切换；浮动态可以拖动标题栏，并从支持的边缘和右下角调整尺寸。面板位置、尺寸和停靠模式会在刷新后恢复。
+- **高度跟随内容**：面板先根据团队内容自然增长，达到视口安全上限后才启用内部滚动，小团队不再出现大块空白。
+- **角色头像更清晰**：队长和成员改为透明、无裁切的完整角色剪影，统一头像尺寸，减轻状态贴纸，并使用更轻量的未读提示。
+
+## 修复
+
+- 将用户输入的完整 `/agent-teams ...` 原文保留为主会话中的普通用户消息。
+- 上下文注入按时间顺序显示在用户消息下方。
+- 移除重复的 slash command 结果行，同时保留持久化命令事件。
+
+## 安装
+
+```sh
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams
+```
+
+</details>