@stofone/dsh-agent-roster 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -4,6 +4,25 @@
 
 ## [Unreleased]
 
+## [1.2.0] - 2026-11-03
+
+### Create a team from the row you are looking at
+
+Creating a team used to require expanding the roster, finding the captain panel and pressing *apply*. The
+one action the product is named after was the hardest thing to find, and a roster without a `captain` block
+offered no path at all.
+
+Every roster row now carries **Create team**. It opens a small dialog: team name (defaults to the roster id),
+a choice between a new session and an existing one — new is the default, because quick creation must not
+hijack the conversation you are in — and a one-line summary of what will be built (`N members · captain model`).
+Submitting queues the same build prompt as *apply*; the toast names the session it landed in.
+
+The boundary is unchanged, and the dialog says so on its face: the plugin never writes team state. It
+prepares a session (selects the captain model when the archive declares one, queues the prompt), and that
+session calls `agent_teams_create` / `agent_teams_add_member` / `roster_verify`. A roster without a captain
+block can still create a team; it just will not switch the model, and the dialog says that instead of failing
+silently.
+
 ## [1.1.0] - 2026-11-03
 
 ### The library reads as spaces, not groups

package/README.md

@@ -383,6 +383,12 @@ The **apply** action is the one write the panel offers here: it switches the cho
 declared model and queues a prompt that calls `agent_teams_create`, `agent_teams_add_member` per
 member and finally `roster_verify`. Creating the team stays with the runtime.
 
+Since 1.2.0 the roster row itself carries **Create team**, so this no longer hides behind an
+expanded card. It defaults to a *new* session — quick creation must not hijack the conversation
+you are in — lets you rename the team, switches the captain model when the archive declares one,
+and queues the same build prompt. The plugin still writes no team state: the row action prepares a
+session, the session does the creating.
+
 ## Sidebar panel
 
 The roster list is a **ledger, not a wall of cards**: one row per roster — a 3px state edge (lit only when something is wrong, quiet when it is fine), a monospace id column, the title with a one-line description, right-aligned counts (members / errors / warnings / deployment), and a quiet pair of actions (edit, expand). Duplicate, copy-create and delete moved into the expanded area, which turns 105 buttons across 21 rosters into 42. Below 860px the tag pool becomes a top row and the metadata wraps. Expansions never build their own scroll box: the panel root is the only scroller, so an expanded section grows as tall as its content instead of showing "just a few rows".
@@ -524,7 +530,7 @@ test/             unit tests
 
 Verified on this machine:
 
-- `npm test` — 313/313 passing (format, parse, validate, registry, paths, bridge, verify buckets, digests and provenance, roster diff, capability requirements and the capability gate, library organization, registry schema, lossless JSON, write plan/apply, all routes, panel snapshot and hints, dictionary consistency, tool contracts, client loader contract, library snapshot, config view, package manifest, declared fields and captain block, schema/constant alignment, the v2 role/roster/compiled layers and their schema alignment, v1→v2 migration, run records feeding the plan, remote registry and one-click install).
+- `npm test` — 315/315 passing (format, parse, validate, registry, paths, bridge, verify buckets, digests and provenance, roster diff, capability requirements and the capability gate, library organization, registry schema, lossless JSON, write plan/apply, all routes, panel snapshot and hints, dictionary consistency, tool contracts, client loader contract, library snapshot, config view, package manifest, declared fields and captain block, schema/constant alignment, the v2 role/roster/compiled layers and their schema alignment, v1→v2 migration, run records feeding the plan, remote registry and one-click install).
 - `npm run smoke` — `apply()` registers all six tools through a real `defineTool` from a DSH bundle; `roster_list` / `roster_show` / `roster_create` / `roster_verify` / `roster_diff` execute, every output survives `lossless` checks, `path` overrides are honored, effect disposal runs cleanly. The same command then loads `client.js` against a stubbed module table and asserts the three slot registrations, style injection and effect disposal.
 - CLI: `validate --dir examples` returns exit 0 over both example libraries.
 - Installed into a real profile with the plugin manager (`plugin_manager install_bundle` against this directory → `link:` dependency + bundle entry); the profile re-reads the linked files on restart.

package/README.zh.md

@@ -370,6 +370,14 @@ node bin/cli.mjs compile --roster examples-orchestration/rosters/core-review \
 设置页显示每个 profile 里实际部署的 provider / model，每份带 captain 段的档案按字段报
 「一致 / 不一致 / 未声明 / 无法核对」。读不到部署配置时是「无法核对」，永远不会写成“通过”。
 
+面板在这里唯一会写的一步是**应用**：把选中的会话切到声明的模型，再排入一条提示词，
+让它依次调用 `agent_teams_create`、逐成员 `agent_teams_add_member`，最后 `roster_verify`。
+建团队本身仍由运行时完成。
+
+1.2.0 起，档案行上直接有**创建团队**，不必先展开卡片：默认开**新会话**（快速建团不该劫持
+你正在聊的这个），可改团队名，档案声明了队长模型就一并切换，然后排入同样的建团提示词。
+插件仍然不写团队状态——行上的按钮只负责把一个会话准备好，动手创建的是那个会话。
+
 **应用**是这块唯一会写入的动作：把选中会话切到声明里的模型，并排入一段提示词，让它依次调用
 `agent_teams_create`、逐成员 `agent_teams_add_member`，最后 `roster_verify` 核对。
 团队仍由运行时创建，插件不代劳。
@@ -505,7 +513,7 @@ test/             单测
 
 本机已验证：
 
-- `npm test` —— 313/313 通过（格式、解析、校验、扫描、路径、桥接、核对四桶、摘要与溯源、档案差异、能力要求与能力闸门、档案库组织、索引 schema、无损 JSON、写入计划与执行、六条路由、快照与提示、两本词典一致、工具契约、客户端加载器契约、包清单、配置视图、样式 token 约束、声明层字段与队长段、schema 与常量对齐、v2 角色/组装/编译三层及其 schema 对齐、v1→v2 迁移、执行回执并入施工图）。
+- `npm test` —— 315/315 通过（格式、解析、校验、扫描、路径、桥接、核对四桶、摘要与溯源、档案差异、能力要求与能力闸门、档案库组织、索引 schema、无损 JSON、写入计划与执行、六条路由、快照与提示、两本词典一致、工具契约、客户端加载器契约、包清单、配置视图、样式 token 约束、声明层字段与队长段、schema 与常量对齐、v2 角色/组装/编译三层及其 schema 对齐、v1→v2 迁移、执行回执并入施工图）。
 - `npm run smoke` —— 用真实 DSH bundle 的 `defineTool` 注册六个工具，逐个调用：输出全部通过无损校验、`path` 覆盖生效、释放干净；同一条命令随后用桩模块表加载 `client.js`，断言三处槽位注册、样式只注入一次、effect 可回收。
 - CLI：`validate --dir examples` 对两座示例库退出码 0。
 - 用插件管理器真的装进了本机 profile（`plugin_manager install_bundle` 指向本仓库 → `link:` 依赖 + bundle 条目），重启后按链接读取本仓库文件。

package/client.js

@@ -660,13 +660,147 @@ window.__ModuleLoader__.load({
       );
     }
 
+    /**
+     * 从档案创建团队：挑一个队长会话，把建团提示排进去。
+     *
+     * 为什么不是“插件直接建”：团队只能由队长会话里的 `agent_teams_create` 建，插件没有这个权限。
+     * 所以这个对话框做的是端到端的前半段——把成员、队长模型、建团步骤一次交给一个会话，
+     * 后半段（建队、加成员、核对）在那个会话里发生；结果回团队页签与 `roster_verify` 看。
+     */
+    function TeamCreateDialog({ roster, sessions, onClose, onToast, onCreated }) {
+      useTranslation();
+      // 默认新会话：快速建团不该劫持用户正在聊的这个。
+      const [mode, setMode] = useState("new");
+      const [sessionId, setSessionId] = useState(sessions[0]?.sessionId ?? "");
+      const [cwd, setCwd] = useState(roster.rootDir ?? "");
+      const [teamName, setTeamName] = useState(roster.id);
+      const [busy, setBusy] = useState(false);
+      const [error, setError] = useState(null);
+      const captain = roster.captain ?? null;
+      const declaredModel =
+        captain !== null && captain.provider !== undefined && captain.model !== undefined && captain.provider !== "" && captain.model !== ""
+          ? `${captain.provider}/${captain.model}`
+          : null;
+      const canSubmit = !busy && (mode === "new" || sessionId !== "");
+
+      async function submit() {
+        if (!canSubmit) return;
+        setBusy(true);
+        setError(null);
+        try {
+          const payload = { rosterId: roster.id, teamName: teamName.trim(), mode };
+          if (mode === "existing") payload.sessionId = sessionId;
+          else if (cwd.trim() !== "") payload.cwd = cwd.trim();
+          const response = await readJson(APPLY_ROUTE, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(payload),
+          });
+          if (!response.ok || response.body?.ok !== true) {
+            setError(response.body?.code ?? response.body?.error?.code ?? String(response.status));
+            return;
+          }
+          onToast(t("teamCreate.queued", { session: response.body.sessionId }));
+          onCreated?.(response.body.sessionId);
+          onClose();
+        } catch {
+          setError("network");
+        } finally {
+          setBusy(false);
+        }
+      }
+
+      return h(
+        Modal,
+        {
+          title: t("teamCreate.title", { roster: roster.id }),
+          onClose,
+          footer: h(
+            "div",
+            { className: "rstr-modal-foot-actions" },
+            h("button", { type: "button", className: "rstr-btn", onClick: onClose }, t("teamCreate.cancel")),
+            h(
+              "button",
+              { type: "button", className: "rstr-btn rstr-btn-primary", disabled: !canSubmit, onClick: submit },
+              busy ? t("teamCreate.creating") : t("teamCreate.submit"),
+            ),
+          ),
+        },
+        h("p", { className: "rstr-hint" }, t("teamCreate.hint")),
+        h(
+          Field,
+          { label: t("teamCreate.teamName") },
+          h("input", {
+            className: "rstr-input",
+            value: teamName,
+            onChange: (event) => setTeamName(event.target.value),
+            placeholder: roster.id,
+          }),
+        ),
+        h(
+          Field,
+          { label: t("teamCreate.target") },
+          h(
+            "div",
+            { className: "rstr-segmented" },
+            h(
+              "button",
+              { type: "button", className: mode === "new" ? "rstr-seg rstr-seg-on" : "rstr-seg", onClick: () => setMode("new") },
+              t("teamCreate.newSession"),
+            ),
+            h(
+              "button",
+              {
+                type: "button",
+                className: mode === "existing" ? "rstr-seg rstr-seg-on" : "rstr-seg",
+                onClick: () => setMode("existing"),
+              },
+              t("teamCreate.existingSession"),
+            ),
+          ),
+          mode === "existing"
+            ? h(
+                "select",
+                { className: "rstr-select", value: sessionId, onChange: (event) => setSessionId(event.target.value) },
+                sessions.length === 0
+                  ? h("option", { value: "" }, t("teamCreate.noSessions"))
+                  : sessions.map((session) =>
+                      h(
+                        "option",
+                        { key: session.sessionId, value: session.sessionId },
+                        `${session.sessionId.slice(0, 12)} · ${session.cwd || "?"}${
+                          session.model === null ? "" : ` · ${session.model.model}`
+                        }`,
+                      ),
+                    ),
+              )
+            : h("input", {
+                className: "rstr-input",
+                placeholder: t("teamCreate.cwdPlaceholder"),
+                value: cwd,
+                onChange: (event) => setCwd(event.target.value),
+              }),
+        ),
+        h(
+          "p",
+          { className: "rstr-hint" },
+          t("teamCreate.summary", {
+            count: roster.members.length,
+            model: declaredModel ?? t("teamCreate.noModel"),
+          }),
+        ),
+        captain === null ? h("p", { className: "rstr-hint" }, t("teamCreate.noCaptain")) : null,
+        error !== null ? h("p", { className: "rstr-bad rstr-small" }, t("teamCreate.failed", { code: error })) : null,
+      );
+    }
+
     /**
      * 一行 = 一份档案。
      *
      * 名册是列表不是画廊：id 立在第一列当"脊"，状态长在左沿，操作平时只露两个入口。
      * 复制/建队/删除这些低频且危险的动作收进展开区——否则 21 份档案就是 105 个按钮。
      */
-    function RosterCard({ roster, deployment, captainReport, sessions, onToast, onEdit, onDuplicate, onDelete, onCopy }) {
+    function RosterCard({ roster, deployment, captainReport, sessions, onToast, onEdit, onDuplicate, onDelete, onCopy, onCreateTeam }) {
       const [open, setOpen] = useState(false);
       const diagnostics = roster.diagnostics ?? [];
       const errors = diagnostics.filter((item) => item?.severity === "error").length;
@@ -717,6 +851,11 @@ window.__ModuleLoader__.load({
           h(
             "div",
             { className: "rstr-row-actions" },
+            h(
+              "button",
+              { type: "button", className: "rstr-btn rstr-btn-sm", onClick: () => onCreateTeam(roster) },
+              t("roster.createTeam"),
+            ),
             h("button", { type: "button", className: "rstr-btn rstr-btn-sm rstr-btn-quiet", onClick: () => onEdit(roster) }, t("roster.edit")),
             h(
               "button",
@@ -1609,6 +1748,7 @@ window.__ModuleLoader__.load({
       const [editor, setEditor] = useState(null);
       const [importing, setImporting] = useState(false);
       const [removing, setRemoving] = useState(null);
+      const [creatingTeam, setCreatingTeam] = useState(null);
       const [toast, setToast] = useState(null);
 
       useEffect(() => {
@@ -1936,6 +2076,7 @@ window.__ModuleLoader__.load({
                       onDuplicate: () => setEditor({ roster, rootDir: roster.rootDir, duplicate: true }),
                       onDelete: () => setRemoving(roster),
                       onCopy: copyPayload,
+                      onCreateTeam: (target) => setCreatingTeam(target),
                     }),
                   ),
               ),
@@ -2030,6 +2171,18 @@ window.__ModuleLoader__.load({
               },
             })
           : null,
+        creatingTeam !== null
+          ? h(TeamCreateDialog, {
+              roster: creatingTeam,
+              sessions: snapshot?.sessions?.sessions ?? [],
+              onClose: () => setCreatingTeam(null),
+              onToast: setToast,
+              onCreated: () => {
+                setCreatingTeam(null);
+                library.reload();
+              },
+            })
+          : null,
         removing !== null
           ? h(DeleteDialog, {
               roster: removing,
@@ -2908,6 +3061,8 @@ window.__ModuleLoader__.load({
 .rstr-apply { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; }
 .rstr-segmented { display: inline-flex; border: 1px solid var(--dsw-alias-border-l3); }
 .rstr-seg { border: none; background: transparent; padding: 5px 12px; font-size: 12px; font-family: inherit; cursor: pointer; color: var(--dsw-alias-label-secondary); }
+/* 对话框里的二选一开关：字段列默认拉伸，这里收回内容宽度，别让它长得像第二个输入框。 */
+.rstr-field > .rstr-segmented { align-self: flex-start; }
 .rstr-seg:hover { background: var(--dsw-alias-interactive-bg-hover); }
 .rstr-seg-on { background: color-mix(in srgb, var(--dsw-alias-state-business-primary) 10%, transparent); color: var(--dsw-alias-label-primary); font-weight: 600; }
 

package/index.js

@@ -441,6 +441,8 @@ export function apply(ctx, config) {
           mode: input.mode === "new" ? "new" : "existing",
           sessionId: typeof input.sessionId === "string" ? input.sessionId : "",
           cwd: typeof input.cwd === "string" ? input.cwd : "",
+          // 团队名只进提示词，不写任何团队状态；超长按 120 截断，与档案标题同量级。
+          teamName: typeof input.teamName === "string" ? input.teamName.trim().slice(0, 120) : "",
         });
         const status = result.ok ? 200 : result.code === "session-controller-unavailable" ? 503 : 400;
         sendJson(res, status, result);

package/locale/en.json

@@ -86,7 +86,8 @@
     "showMembers": "Show members",
     "hideMembers": "Hide members",
     "warnings": "{count} warnings",
-    "deployedDrifted": "In {teams} ({count} drifted)"
+    "deployedDrifted": "In {teams} ({count} drifted)",
+    "createTeam": "Create team"
   },
   "member": {
     "prompt": "Prompt",
@@ -323,5 +324,23 @@
     "pulledSpace": "Space pulled: {files} files written, {skipped} skipped",
     "facts": "{count} rosters · {installed} here",
     "here": "Already here"
+  },
+  "teamCreate": {
+    "title": "Create a team from {roster}",
+    "hint": "The plugin never writes team state: it queues a build prompt into the captain session, which then calls agent_teams_create and adds each member.",
+    "teamName": "Team name",
+    "target": "Captain session",
+    "newSession": "New session",
+    "existingSession": "Existing session",
+    "noSessions": "No session available",
+    "cwdPlaceholder": "Working directory (empty = current workspace)",
+    "summary": "{count} members · captain model {model}",
+    "noModel": "not declared, the session keeps its model",
+    "noCaptain": "This roster has no captain block: it can still build a team, but the captain model is not switched.",
+    "submit": "Create",
+    "creating": "Queueing…",
+    "cancel": "Cancel",
+    "queued": "Queued into session {session} — that session will build the team.",
+    "failed": "Could not queue ({code})"
   }
 }

package/locale/zh.json

@@ -86,7 +86,8 @@
     "showMembers": "展开成员",
     "hideMembers": "收起成员",
     "warnings": "{count} 条提醒",
-    "deployedDrifted": "在 {teams}（{count} 处不一致）"
+    "deployedDrifted": "在 {teams}（{count} 处不一致）",
+    "createTeam": "创建团队"
   },
   "member": {
     "prompt": "人设",
@@ -323,5 +324,23 @@
     "pulledSpace": "空间已拉取：写入 {files} 个文件，跳过 {skipped} 个",
     "facts": "{count} 份 · 已装 {installed}",
     "here": "已在本机"
+  },
+  "teamCreate": {
+    "title": "从 {roster} 创建团队",
+    "hint": "插件不写团队状态：它只把建团提示排进队长会话，由那个会话调用 agent_teams_create 并逐个加成员。",
+    "teamName": "团队名",
+    "target": "队长会话",
+    "newSession": "新会话",
+    "existingSession": "已有会话",
+    "noSessions": "没有可选的会话",
+    "cwdPlaceholder": "工作目录（留空用当前工作区）",
+    "summary": "将建 {count} 名成员 · 队长模型 {model}",
+    "noModel": "未声明，沿用会话当前模型",
+    "noCaptain": "这份档案没有 captain 段：仍可建团，但不会切换队长模型。",
+    "submit": "创建",
+    "creating": "排队中…",
+    "cancel": "取消",
+    "queued": "已排入会话 {session}——那个会话会开始建队。",
+    "failed": "排队失败（{code}）"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stofone/dsh-agent-roster",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "多 Agent 团队的静态成员档案定义与校验层：档案库在面板里看得见、改得动，团队成员的人设、模型与工具边界固化成可校验、可版本化的文件，并在 dsh-agent-teams 创建成员时把档案桥接给运行时。",
   "type": "module",
   "main": "index.js",