@nanmicoder/dsh-agent-teams 0.1.7 → 0.1.9

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

@@ -16,46 +16,6 @@
  */
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { ObservableSnapshot, SessionListState } from '@deepseek-ai/dsh-client-runtime/client';
-/** One member row of a host snapshot. */
-export interface ActivityMember {
-    readonly id: string;
-    readonly name: string;
-    readonly role: string;
-    readonly status?: 'idle' | 'working' | 'removed';
-    readonly activity: 'working' | 'idle' | 'unknown';
-    readonly progress: number;
-    readonly done: number;
-    readonly total: number;
-    readonly currentTask: string;
-    readonly unread: number;
-}
-/** One task row of a host snapshot. */
-export interface ActivityTask {
-    readonly id: string;
-    readonly subject: string;
-    readonly status: string;
-    readonly state: 'blocked' | 'open' | 'running' | 'completed';
-    readonly assignee: string;
-    readonly dependencies: readonly string[];
-    readonly depth: number;
-}
-/** One captain-inbox preview row. */
-export interface ActivityMessage {
-    readonly from: string;
-    readonly content: string;
-}
-/** One team snapshot (mirrors the host TeamActivitySnapshot). */
-export interface ActivityTeam {
-    readonly workspace: string;
-    readonly teamId: string;
-    readonly name: string;
-    readonly description?: string;
-    readonly captainSessionId: string;
-    readonly members: readonly ActivityMember[];
-    readonly tasks: readonly ActivityTask[];
-    readonly messageCount: number;
-    readonly captainInbox: readonly ActivityMessage[];
-}
 /** The top-right activity floater. Teams follow the current session: live
  * snapshots and historic card summaries are only shown while their captain
  * session is the one currently open. */

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

@@ -16,9 +16,8 @@ export declare const OPEN_PANEL_EVENT = "agent-teams:open-panel";
 /** Navigation action injected from the plugin's own SessionsService access. */
 export interface AgentTeamsCardInjected {
     readonly openSession: (id: SessionId) => void;
-    readonly currentSessionId: () => SessionId | undefined;
 }
 /** Complete keyed Chat renderer props. */
 export type AgentTeamsCardProps = PropsRuntime<'conversation.chat.node', 'agent-teams'> & PropsLocale<'agentTeams'> & AgentTeamsCardInjected;
 /** Render one durable team as a compact conversation card. */
-export declare function AgentTeamsCard({ node, openSession, currentSessionId }: AgentTeamsCardProps): import("react").JSX.Element;
+export declare function AgentTeamsCard({ node, openSession, sessionId }: AgentTeamsCardProps): import("react").JSX.Element;

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

@@ -0,0 +1,106 @@
+/** Shared, demand-driven state for the AgentTeams browser monitor. */
+/** One member row of a host snapshot. */
+export interface ActivityMember {
+    readonly id: string;
+    readonly name: string;
+    readonly role: string;
+    readonly status?: 'idle' | 'working' | 'removed';
+    readonly activity: 'working' | 'idle' | 'unknown';
+    readonly progress: number;
+    readonly done: number;
+    readonly total: number;
+    readonly currentTask: string;
+    readonly unread: number;
+}
+/** One task row of a host snapshot. */
+export interface ActivityTask {
+    readonly id: string;
+    readonly subject: string;
+    readonly status: string;
+    readonly state: 'blocked' | 'open' | 'running' | 'completed';
+    readonly assignee: string;
+    readonly dependencies: readonly string[];
+    readonly depth: number;
+}
+/** One captain-inbox preview row. */
+export interface ActivityMessage {
+    readonly from: string;
+    readonly content: string;
+}
+/** One team snapshot (mirrors the host TeamActivitySnapshot). */
+export interface ActivityTeam {
+    readonly workspace: string;
+    readonly teamId: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly captainSessionId: string;
+    readonly members: readonly ActivityMember[];
+    readonly tasks: readonly ActivityTask[];
+    readonly messageCount: number;
+    readonly captainInbox: readonly ActivityMessage[];
+}
+/** A successfully-created conversation card that currently needs updates. */
+export interface ActivityMonitorTarget {
+    readonly key: string;
+    readonly sessionId: string;
+    readonly teamId: string;
+}
+/** Latest shared response data for both the floater and conversation cards. */
+export interface ActivitySnapshots {
+    readonly teams: readonly ActivityTeam[];
+    readonly archivedTeams: readonly ActivityTeam[];
+}
+/** Subscribe to the active monitor-target list (React external-store shape). */
+export declare function subscribeActivityMonitorTargets(listener: () => void): () => void;
+/** Read the stable active-target snapshot. */
+export declare function getActivityMonitorTargetsSnapshot(): readonly ActivityMonitorTarget[];
+/**
+ * Register one successful AgentTeams card as a monitoring demand.
+ *
+ * The returned cleanup is reference-counted so multiple cards and React
+ * StrictMode remounts cannot stop another card's monitor.
+ */
+export declare function monitorAgentTeam(sessionId: string, teamId: string): () => void;
+/** Stop polling targets whose final archived snapshot has been captured. */
+export declare function settleActivityMonitorTargets(keys: ReadonlySet<string>): void;
+/** Subscribe to the shared live/archive snapshot. */
+export declare function subscribeActivitySnapshots(listener: () => void): () => void;
+/** Read the stable shared live/archive snapshot. */
+export declare function getActivitySnapshotsSnapshot(): ActivitySnapshots;
+/** Publish one or both successful state-route responses. */
+export declare function updateActivitySnapshots(update: Partial<ActivitySnapshots>): void;
+/** Poll cadence for the live host snapshot route. */
+export declare const ACTIVITY_POLL_MS = 1000;
+/** Host route serving live and archived team snapshots. */
+export declare const ACTIVITY_STATE_URL = "/plugins/dsh-agent-teams/state";
+interface ActivityFetchResponse {
+    readonly ok: boolean;
+    json(): Promise<unknown>;
+}
+/** Injectable browser primitives used by the poll controller and its tests. */
+export interface ActivityPollingRuntime {
+    readonly fetchState?: (url: string, init: {
+        readonly cache: 'no-store';
+        readonly signal: AbortSignal;
+    }) => Promise<ActivityFetchResponse>;
+    readonly schedule?: (callback: () => void, intervalMs: number) => unknown;
+    readonly cancel?: (timer: unknown) => void;
+    readonly publishSnapshots?: (update: Partial<ActivitySnapshots>) => void;
+    readonly settleTargets?: (keys: ReadonlySet<string>) => void;
+}
+/** Handle returned by one current-session polling loop. */
+export interface ActivityPollingController {
+    /** The immediate first pass, exposed so offline verification can await it. */
+    readonly firstTick: Promise<void>;
+    /** Idempotently stop the timer and abort the current request. */
+    stop(): void;
+}
+/**
+ * Start the single polling loop for the current session's requested targets.
+ *
+ * With no targets this is deliberately inert: installing the plugin must not
+ * touch the state route. Live state is polled at the normal cadence; archive
+ * state is fetched only as a one-time fallback for targets no longer live.
+ */
+export declare function startActivityPolling(monitorTargets: readonly ActivityMonitorTarget[], runtime?: ActivityPollingRuntime): ActivityPollingController;
+export {};

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/command.d.ts

@@ -0,0 +1,71 @@
+/**
+ * The `/agent-teams` slash command and its plain-text gesture boundary.
+ *
+ * Two deterministic activation paths, mirroring the Harness skill pipeline
+ * (`dsh-tool-skill` + the `ui-skill` client source):
+ *
+ * 1. **Host command** — `ctx.commands.register` publishes the closed-namespace
+ *    `/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.
+ * 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.
+ *
+ * @module dsh-agent-teams/command
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type UserMessage } from '@deepseek-ai/dsh-llm';
+/** The slash command name (without the leading slash). */
+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.
+         */
+        'agent-teams-command': {
+            readonly kind: 'agent-teams-command';
+            /** The user-supplied goal text (absent when the gesture was bare). */
+            readonly goal?: string;
+        };
+    }
+}
+/**
+ * The deterministic activation text. The system-prompt usage section owns
+ * the full protocol; this message only switches it on for one concrete goal.
+ * @param goal - the user-supplied goal, or `''` for a bare invocation.
+ */
+export declare function buildActivationDirective(goal: string): string;
+/**
+ * The goal of the latest start-anchored `/agent-teams` gesture in genuine
+ * user messages, or `undefined` when no message carries one. `''` means a
+ * bare `/agent-teams` token with no goal.
+ * @param messages - the step's claimed batch (user messages only scanned).
+ */
+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.
+ * @param ctx - host context providing the `commands` registry.
+ */
+export declare function registerAgentTeamsCommand(ctx: Context): void;
+/**
+ * Install the `agent/pre-step` gesture boundary: a claimed user message
+ * starting with `/agent-teams` gains the deterministic activation message
+ * appended after every other injection, closest to the model's answer.
+ * @param ctx - host context providing the `agent/pre-step` waterfall.
+ */
+export declare function installAgentTeamsGestureBoundary(ctx: Context): void;

package/lib/types/index.d.ts

@@ -37,6 +37,12 @@ export interface Config {
     maxMembers?: number;
     /** Prompt-section order for the usage policy (default `117`, after delegation policy). */
     promptSectionOrder?: number;
+    /**
+     * Register the deterministic `/agent-teams` activation surfaces (the
+     * closed-namespace slash command and the plain-text gesture boundary).
+     * Disable to keep the natural-language trigger as the only entry point.
+     */
+    slashCommand?: boolean;
 }
 export declare const Config: z<Config>;
 export declare function apply(ctx: Context, config: Config): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanmicoder/dsh-agent-teams",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "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",
@@ -93,6 +93,7 @@
     "@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",
@@ -123,6 +124,9 @@
     "@deepseek-ai/dsh-client-ui-slots": {
       "optional": true
     },
+    "@deepseek-ai/dsh-commands": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-llm": {
       "optional": true
     },
@@ -153,6 +157,7 @@
     "@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",