@nanmicoder/dsh-agent-teams 0.1.2 → 0.1.4

package/lib/tools.js

@@ -13,7 +13,7 @@ import { defineTool } from '@deepseek-ai/dsh-tools';
 import { join } from 'node:path';
 import { appendTeamEvent, captainSessionOf } from "./events.js";
 import { appendMailbox, archiveTeamDir, CAPTAIN_KEY, createMessage, createTeamDir, findTeamByCaptain, findTeamByParticipant, readMailbox, readTeam, sanitizeKey, transitionError, unsatisfiedDependencies, withTeamLock, writeTeam, } from "./state.js";
-import { deliverToMember, interruptMember, memberActivity, spawnMember, } from "./members.js";
+import { deliverToMember, installMemberSelectionRuntime, interruptMember, memberActivity, resolveMemberLlmSelection, spawnMember, } from "./members.js";
 /** The caller agent, or a loud failure for non-agent callers. */
 function requireCaptain(exec) {
     if (!exec.agent) {
@@ -126,6 +126,7 @@ export function steerCaptainReport(captain, from, content) {
  * @param config - resolved tool config.
  */
 export function registerAgentTeamsTools(ctx, config) {
+    const memberSelections = installMemberSelectionRuntime(ctx, config.stateDir);
     ctx.tools.register(defineTool({
         name: 'agent_teams_create',
         description: 'Create a new AgentTeams team: you (the calling agent) become the captain. A captain leads one team at a time; create tasks and members afterwards with agent_teams_add_member and agent_teams_create_task.',
@@ -191,11 +192,12 @@ export function registerAgentTeamsTools(ctx, config) {
     }));
     ctx.tools.register(defineTool({
         name: 'agent_teams_add_member',
-        description: 'Add a member to your team: spawns a durable continuable subagent with a member persona. The member waits for your messages and works on assigned tasks; it can message you and teammates. One team per captain, members are capped by config.',
+        description: 'Add a durable continuable member. By default it snapshots the captain\'s current LLM provider, model, and reasoning effort with no user prompt. Supply provider/model only for an explicitly requested role-specific route. The member waits for messages, works on assigned tasks, and can message the team.',
         parameters: {
             name: { type: 'string', required: true, description: 'Unique member name inside the team.' },
             role: { type: 'string', description: 'Role of the member (e.g. researcher, engineer, reviewer).' },
-            model: { type: 'string', description: 'Optional model override for this member (defaults to the captain\'s model).' },
+            provider: { type: 'string', description: 'Optional LLM provider route. Use only when the user explicitly requests a different provider; requires model.' },
+            model: { type: 'string', description: 'Optional model override. Omit for the captain\'s current model (or the configured memberModel default).' },
         },
         output: {
             schema: {
@@ -204,12 +206,15 @@ export function registerAgentTeamsTools(ctx, config) {
                 properties: {
                     member_name: { type: 'string', required: true },
                     member_id: { type: 'string', required: true },
+                    provider: { type: 'string', required: true },
+                    model: { type: 'string', required: true },
+                    reasoning_effort: { type: 'string' },
                     status: { type: 'string', required: true },
                 },
             },
             render: (args, value) => [{
                     type: 'text',
-                    text: `Member "${value.member_name}" added (subagent id ${value.member_id}, status ${value.status}).`,
+                    text: `Member "${value.member_name}" added (subagent id ${value.member_id}, ${value.provider}/${value.model}${value.reasoning_effort === undefined ? '' : `, reasoning ${value.reasoning_effort}`}, status ${value.status}).`,
                 }],
         },
         async execute(args, exec) {
@@ -232,15 +237,22 @@ export function registerAgentTeamsTools(ctx, config) {
                 if (fresh.members.filter((candidate) => candidate.status !== 'removed').length >= config.maxMembers) {
                     throw new Error(`team "${fresh.name}" is at its member cap (${config.maxMembers})`);
                 }
+                const selection = await resolveMemberLlmSelection(ctx, captain, {
+                    provider: args.provider,
+                    model: args.model,
+                    defaultModel: config.memberModel,
+                }, exec.signal);
                 const member = {
                     id: '',
                     name: memberName,
                     role: args.role,
-                    model: args.model,
+                    provider: selection.provider,
+                    model: selection.model,
+                    reasoningEffort: selection.reasoningEffort,
                     joinedAt: Date.now(),
                     status: 'idle',
                 };
-                await spawnMember(ctx, memberRuntime(config), captain, fresh, member, config.stateDir, exec.signal);
+                await spawnMember(ctx, memberRuntime(config), memberSelections, selection, captain, fresh, member, config.stateDir, exec.signal);
                 fresh.members.push(member);
                 await writeTeam(stateRoot, fresh);
                 appendTeamEvent(ctx, captainSessionOf(ctx, fresh.captainSessionId, captain.session), 'agent-teams/member-added', {
@@ -249,7 +261,16 @@ export function registerAgentTeamsTools(ctx, config) {
                     name: member.name,
                     ...member.role !== undefined ? { role: member.role } : {},
                 });
-                return { member_name: member.name, member_id: member.id, status: member.status };
+                return {
+                    member_name: member.name,
+                    member_id: member.id,
+                    provider: selection.provider,
+                    model: selection.model,
+                    ...selection.reasoningEffort === undefined
+                        ? {}
+                        : { reasoning_effort: selection.reasoningEffort },
+                    status: member.status,
+                };
             });
         },
     }));
@@ -620,7 +641,9 @@ export function registerAgentTeamsTools(ctx, config) {
                 .map((member) => ({
                 name: member.name,
                 role: member.role ?? '',
+                provider: member.provider ?? '',
                 model: member.model ?? '',
+                reasoning_effort: member.reasoningEffort ?? '',
                 status: member.status,
                 activity: member.id !== '' ? (activity.get(member.id) ?? 'unknown') : 'unspawned',
             }));
@@ -718,7 +741,6 @@ export function registerAgentTeamsTools(ctx, config) {
 function memberRuntime(config) {
     return {
         provider: config.memberProvider,
-        model: config.memberModel,
         maxDepth: config.memberMaxDepth,
     };
 }
@@ -729,7 +751,11 @@ function renderStatus(value) {
         `Team "${team.team_name}"${team.description ? ` — ${team.description}` : ''}`,
         `Viewing as: ${team.viewer}`,
         `Members (${team.members.length}):`,
-        ...team.members.map((member) => `  - ${member.name} [${member.role}] ${member.status}/${member.activity}`),
+        ...team.members.map((member) => {
+            const route = member.provider && member.model ? ` · ${member.provider}/${member.model}` : '';
+            const effort = member.reasoning_effort ? ` · reasoning ${member.reasoning_effort}` : '';
+            return `  - ${member.name} [${member.role}] ${member.status}/${member.activity}${route}${effort}`;
+        }),
         `Tasks (${team.tasks.length}):`,
         ...team.tasks.map((task) => {
             const deps = task.dependencies.length > 0 ? ` (deps: ${task.dependencies.join(',')})` : '';

package/lib/types/members.d.ts

@@ -12,17 +12,54 @@
  * @module dsh-agent-teams/members
  */
 import type { Context } from '@deepseek-ai/cordis';
-import type { Agent } from '@deepseek-ai/dsh-agent';
+import { type Agent } from '@deepseek-ai/dsh-agent';
 import type { TeamMember, TeamState } from './types.ts';
 /** Runtime knobs for member spawning, resolved from plugin config. */
 export interface MemberRuntimeConfig {
     /** Registered `ctx.subagents` provider name (must support continuable + persona). */
     provider: string;
-    /** Optional model override applied to every member. */
-    model?: string;
     /** Child delegation depth cap (0 forbids delegation entirely). */
     maxDepth?: number;
 }
+/** Durable provider/model/reasoning snapshot for one member. */
+export interface MemberLlmSelection {
+    /** Registered LLM provider route. */
+    provider: string;
+    /** Provider-owned model id. */
+    model: string;
+    /** Adapter-owned reasoning effort, absent when the target has no explicit/default effort. */
+    reasoningEffort?: string;
+}
+/** Optional member-level route requested by the captain. */
+export interface MemberLlmSelectionRequest {
+    /** Explicit LLM provider route; requires an explicit model. */
+    provider?: string;
+    /** Explicit model id; otherwise the plugin default or captain model is used. */
+    model?: string;
+    /** Plugin-level member model default. */
+    defaultModel?: string;
+}
+/** Process-local bridge between spawn admission and synchronous child setup. */
+export interface MemberSelectionRuntime {
+    /** Make one selection visible while Harness materializes the fresh child. */
+    withPending<T>(parentSessionId: string, label: string, selection: MemberLlmSelection, operation: () => Promise<T>): Promise<T>;
+}
+/**
+ * Resolve one member's complete model selection. Ordinary members snapshot the
+ * captain's current request route and reasoning effort. An explicit member
+ * provider/model or plugin-level model replaces only that route; the current
+ * captain effort remains the inherited policy and is validated against the
+ * target model before a child is created.
+ */
+export declare function resolveMemberLlmSelection(ctx: Context, captain: Agent, request: MemberLlmSelectionRequest, signal?: AbortSignal): Promise<MemberLlmSelection>;
+/**
+ * Install the member selection bridge for every fresh or cold-resumed
+ * continuable child. Fresh creation reads the pending in-memory selection;
+ * cold resume restores the same selection from the owning team's durable
+ * record. Legacy members without a complete saved route retain Harness's
+ * descriptor provider/model behavior.
+ */
+export declare function installMemberSelectionRuntime(ctx: Context, stateDir: string): MemberSelectionRuntime;
 /**
  * The member's system prompt (persona), shadowing the deployment persona for
  * that child. Self-contained: it replaces the whole persona section.
@@ -42,13 +79,15 @@ export declare function memberWelcome(team: TeamState): string;
  * `member.id` with its child session id. On failure nothing is persisted.
  * @param ctx - the plugin context (injects `subagents`).
  * @param config - member runtime knobs.
+ * @param selections - fresh/cold child model-selection bridge.
+ * @param llmSelection - resolved provider/model/reasoning snapshot.
  * @param captain - the exact live captain agent (the calling agent).
  * @param team - the team record (read-only here).
  * @param member - the member draft whose `id` is filled on success.
  * @param stateDir - configured state directory (for the persona).
  * @param signal - caller cancellation, forwarded to the start.
  */
-export declare function spawnMember(ctx: Context, config: MemberRuntimeConfig, captain: Agent, team: TeamState, member: TeamMember, stateDir: string, signal: AbortSignal): Promise<void>;
+export declare function spawnMember(ctx: Context, config: MemberRuntimeConfig, selections: MemberSelectionRuntime, llmSelection: MemberLlmSelection, captain: Agent, team: TeamState, member: TeamMember, stateDir: string, signal: AbortSignal): Promise<void>;
 /**
  * Deliver one message to a member as its next FIFO turn. Best effort: a
  * failure (member gone or not continuable) is logged and reported as `false`

package/lib/types/state.d.ts

@@ -73,6 +73,16 @@ export declare function createTeamDir(stateRoot: string, state: TeamState): Prom
  * @param teamId - the team's sanitized id.
  */
 export declare function readTeam(stateRoot: string, teamId: string): Promise<TeamState | undefined>;
+/**
+ * Synchronously read one team record while a continuable child is being
+ * composed. Harness requires child setup contributions to be synchronous;
+ * this narrow boundary lets a cold-resumed member restore its durable model
+ * selection before its first request can be published.
+ * @param stateRoot - resolved absolute state root directory.
+ * @param teamId - the team's sanitized id.
+ * @returns the team record, or `undefined` when absent.
+ */
+export declare function readTeamSync(stateRoot: string, teamId: string): TeamState | undefined;
 /**
  * Persist one team record (inside the caller's lock).
  * @param stateRoot - resolved absolute state root directory.

package/lib/types/types.d.ts

@@ -39,8 +39,12 @@ export interface TeamMember {
     name: string;
     /** Role description, e.g. `researcher`, `engineer`, `reviewer`. */
     role?: string;
-    /** Optional model override for this member. */
+    /** Resolved LLM provider route captured when this member was created. */
+    provider?: string;
+    /** Resolved model captured when this member was created. */
     model?: string;
+    /** Resolved reasoning effort captured from the captain's current session. */
+    reasoningEffort?: string;
     joinedAt: number;
     status: MemberStatus;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanmicoder/dsh-agent-teams",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "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",
@@ -20,8 +20,10 @@
   "files": [
     "lib",
     "assets/agent-teams",
+    "assets/readme",
     "cordis.patch.yml",
-    "README.md"
+    "README.md",
+    "README_ZH.md"
   ],
   "license": "MIT",
   "author": {
@@ -83,30 +85,44 @@
     "verify": "node scripts/verify.mjs && pnpm verify:skill",
     "prepublishOnly": "pnpm build && pnpm verify"
   },
-  "dependencies": {},
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1-rc.1",
-    "@deepseek-ai/dsh-agent": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-llm": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-session": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-subagent": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-system-prompt": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tools": "^0.0.1-rc.1",
-    "react": "^18.2.0",
-    "@deepseek-ai/schemastery": "^3.18.1-rc.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-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/schemastery": "^3.18.1-rc.1",
+    "react": "^18.2.0"
   },
   "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-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/schemastery": "^3.18.1",
+    "@types/node": "^24.13.3",
     "@types/react": "~18.3.1",
-    "@types/react-dom": "^19.2.4",
+    "@types/react-dom": "^18.3.7",
     "lightningcss": "^1.33.0",
-    "tsdown": "0.22.2",
-    "typescript": "^5.9.3",
     "react": "^18.2.0",
-    "react-dom": "^18.2.0"
+    "react-dom": "^18.2.0",
+    "tsdown": "0.22.2",
+    "typescript": "^5.9.3"
   }
-}
+}