@stofone/dsh-agent-roster 0.0.0-stage → 0.5.0

package/locale/en.json

@@ -0,0 +1,245 @@
+{
+  "meta": {
+    "title": "Agent Roster",
+    "description": "Static member rosters for multi-agent teams: define, validate, edit and inspect them in one panel."
+  },
+  "settings": {
+    "nav": "Agent Roster",
+    "language": "Language",
+    "languageHint": "The panel follows the DSH language by default; pick a language to pin it.",
+    "languageAuto": "Follow DSH",
+    "languageZh": "中文",
+    "languageEn": "English",
+    "rosterDirs": "Roster directories",
+    "rosterDirsHint": "Empty means the global library at $DSH_HOME/agent-roster (~/.dsh/agent-roster), shared across workspaces. Only a relative path is resolved per workspace.",
+    "globalLibrary": "Global default",
+    "dataDir": "Data directory",
+    "stateDir": "Team state directory",
+    "stateDirHint": "Read-only: used to compare roster values with what the runtime actually created.",
+    "policies": "Known tool policies",
+    "policiesNone": "Not configured — policy ids in rosters stay declarations only.",
+    "policiesCount": "{count} declared",
+    "version": "Version",
+    "openPanel": "Open panel"
+  },
+  "panel": {
+    "title": "Agent Roster",
+    "subtitle": "{rosters} rosters · {members} members · {teams} teams",
+    "refresh": "Refresh",
+    "refreshing": "Refreshing…",
+    "tabsRosters": "Rosters",
+    "tabsTeams": "Teams",
+    "tabsDiagnostics": "Health",
+    "search": "Search",
+    "searchPlaceholder": "Filter by id, title, member or tag",
+    "create": "New roster",
+    "import": "Import",
+    "export": "Export",
+    "emptyTitle": "No rosters yet",
+    "emptyBody": "A roster is a plain YAML or JSON file under a roster directory. Create one here, or drop a file into the directory yourself.",
+    "emptyCta": "Create the first roster",
+    "noMatch": "Nothing matches that filter.",
+    "loading": "Reading rosters…",
+    "errorTitle": "Could not read the rosters",
+    "retry": "Try again",
+    "bannerOne": "1 thing needs attention",
+    "bannerMany": "{count} things need attention",
+    "bannerCta": "Open health",
+    "workspaceFallback": "No workspace is registered yet; reading the process directory instead.",
+    "tabsSources": "Sources"
+  },
+  "roster": {
+    "members": "{count} members",
+    "oneMember": "1 member",
+    "version": "v{version}",
+    "file": "File",
+    "deployed": "In {teams}",
+    "notDeployed": "Not in any team yet",
+    "drifted": "{count} drifted",
+    "edit": "Edit",
+    "duplicate": "Duplicate",
+    "delete": "Delete",
+    "copyCreate": "Copy team payload",
+    "copied": "Copied to the clipboard",
+    "copyFailed": "The clipboard is unavailable; select the text instead.",
+    "noMembers": "This roster has no members.",
+    "diagnostics": "{count} findings",
+    "showMembers": "Show members",
+    "hideMembers": "Hide members"
+  },
+  "member": {
+    "prompt": "Prompt",
+    "tools": "Tools",
+    "role": "Role",
+    "model": "Model",
+    "effort": "Effort",
+    "policy": "Tool policy",
+    "fallback": "Fallback",
+    "aliases": "Former names",
+    "skills": "Declared skills",
+    "skillsHint": "declaration only"
+  },
+  "team": {
+    "emptyTitle": "No teams yet",
+    "emptyBody": "Teams are created and scheduled by dsh-agent-teams. This panel only reads their state so you can tell whether a roster really landed.",
+    "emptyCta": "Copy a team payload from a roster",
+    "phaseStaged": "Staged",
+    "phaseRunning": "Running",
+    "halted": "Halted",
+    "escalated": "Escalated",
+    "members": "Members",
+    "tasks": "{total} tasks · {completed} done · {failed} failed · {active} active",
+    "file": "State file",
+    "managed": "From {roster}",
+    "unmanaged": "Not from a roster",
+    "faithful": "Matches the roster",
+    "drift": "Differs from the roster",
+    "promptChars": "{count} prompt characters",
+    "driftDetail": "{field}: roster {wanted}, runtime {actual}"
+  },
+  "editor": {
+    "createTitle": "New roster",
+    "editTitle": "Edit {id}",
+    "id": "Id",
+    "idHint": "Lowercase letters, digits, dot, dash or underscore. It is also the directory name.",
+    "titleField": "Title",
+    "titleHint": "Shown in the panel; free text.",
+    "version": "Version",
+    "description": "Description",
+    "tags": "Tags",
+    "tagsHint": "Comma separated.",
+    "members": "Members",
+    "addMember": "Add member",
+    "removeMember": "Remove",
+    "memberName": "Name",
+    "memberRole": "Role",
+    "memberTitle": "Title",
+    "memberModel": "Model",
+    "memberProvider": "Provider",
+    "memberEffort": "Effort",
+    "memberPolicy": "Tool policy",
+    "memberScope": "Allowed tools",
+    "memberScopeHint": "Comma separated tool names; empty means inherit.",
+    "memberPrompt": "System prompt",
+    "memberDescription": "Description",
+    "memberAliases": "Former names",
+    "listHint": "Comma separated.",
+    "memberSkills": "Declared skills",
+    "skillsHint": "Comma separated skill names. The runtime does not load them; the roster only records intent.",
+    "memberExamples": "Example requests",
+    "examplesHint": "One per line. Used as hints when delegating, never executed.",
+    "captain": "Captain",
+    "captainHint": "The captain is the session that creates a team, not a member. Record here what it should be; the profile decides the real model.",
+    "captainName": "Captain name",
+    "captainNameHint": "kebab-case. Leave empty to drop the whole captain block.",
+    "captainDescription": "Description",
+    "captainProvider": "Provider",
+    "captainModel": "Model",
+    "captainEffort": "Effort",
+    "captainPersona": "Persona prefix",
+    "captainPersonaHint": "Applied by the agent preset, not by this roster. Shown here so the intent is not lost.",
+    "memberTags": "Tags",
+    "source": "Source",
+    "form": "Form",
+    "cancel": "Cancel",
+    "save": "Save",
+    "saving": "Saving…",
+    "overwriteTitle": "Overwrite the existing roster?",
+    "overwriteBody": "{file} already exists. Saving replaces it and keeps a .bak copy next to it.",
+    "overwriteConfirm": "Overwrite",
+    "failedTitle": "The roster was not saved",
+    "emptyId": "An id is required.",
+    "emptyTitle": "A title is required.",
+    "emptyMembers": "A roster needs at least one member.",
+    "emptyMemberName": "Every member needs a name.",
+    "emptyMemberPrompt": "Every member needs a system prompt.",
+    "sourceHint": "Edit the file as-is. The host validates it before writing; nothing is written when validation fails."
+  },
+  "delete": {
+    "title": "Delete {id}?",
+    "body": "This removes {file} from the roster directory. Teams that already used it keep their members; the roster just stops describing them.",
+    "confirm": "Delete",
+    "cancel": "Cancel"
+  },
+  "importDialog": {
+    "title": "Import a roster",
+    "hint": "Paste a roster document. The host validates it and writes it into the selected directory.",
+    "placeholder": "kind: dsh-agent-roster/v1\\nroster: my-team\\nversion: 1.0.0\\n…",
+    "submit": "Import",
+    "target": "Into"
+  },
+  "import": {
+    "done": "Imported {file}",
+    "exists": "{file} already exists."
+  },
+  "diagnostics": {
+    "title": "Health",
+    "intro": "Everything the plugin can check about its own configuration, the rosters, and the teams they describe.",
+    "empty": "Nothing to report: configuration, rosters and teams are consistent.",
+    "severityError": "Error",
+    "severityWarn": "Warning",
+    "severityInfo": "Note",
+    "file": "File",
+    "location": "{file}:{line}"
+  },
+  "hint": {
+    "workspace-fallback": {
+      "title": "No workspace registered",
+      "body": "DSH has not registered a workspace for this session, so roster directories were resolved against the process directory. Open a workspace so the panel reads the right files."
+    },
+    "roster-dir-missing": {
+      "title": "Roster directory missing",
+      "body": "{dirSpec} does not exist under {rootDir}. Create the directory, or change roster directories in the plugin settings."
+    },
+    "roster-dir-empty": {
+      "title": "Roster directory is empty",
+      "body": "{rootDir} exists but holds no roster. Add a folder with a roster.yaml inside, or create one here."
+    },
+    "no-rosters": {
+      "title": "No rosters anywhere",
+      "body": "Every configured roster directory is empty. Tools will report zero rosters until one exists."
+    },
+    "tool-policies-unset": {
+      "title": "Tool policies are not verified",
+      "body": "Rosters name tool policies but the plugin does not know which ids your deployment declares. Fill known tool policies in the plugin settings to catch typos."
+    },
+    "teams-none": {
+      "title": "No teams yet",
+      "body": "The team state directory {stateDir} holds no team. Rosters can still be inspected; deployment status stays unknown."
+    },
+    "state-dir-missing": {
+      "title": "Team state directory missing",
+      "body": "{stateDir} does not exist yet, so no team can be compared with a roster. This is normal before the first team is created."
+    },
+    "duplicate-roster-id": {
+      "title": "Duplicate roster ids",
+      "body": "{count} roster id appears in more than one directory. Tools resolve the first match only; rename one of them."
+    },
+    "roster-errors": {
+      "title": "Rosters with errors",
+      "body": "{count} error findings across the library. Those rosters cannot be used as team member sources."
+    }
+  },
+  "misc": {
+    "copied": "Copied",
+    "yes": "Yes",
+    "no": "No",
+    "failed": "Failed"
+  },
+  "source": {
+    "tabsSources": "Sources",
+    "pull": "Pull to this machine",
+    "pulling": "Pulling…",
+    "pulled": "Pulled {written}, unchanged {unchanged}, conflicts {conflicts}",
+    "empty": "No index source is configured.",
+    "emptyHint": "Add an https registry URL or an npm:pkg in the plugin settings.",
+    "stale": "cached (fetch failed)",
+    "fetchedAt": "Fetched {when}",
+    "registered": "{count} registered",
+    "open": "Show rosters",
+    "hide": "Hide rosters",
+    "loading": "Loading rosters…",
+    "repo": "Repository",
+    "conflictHint": "Local versions differ; nothing was overwritten."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,245 @@
+{
+  "meta": {
+    "title": "Agent 档案",
+    "description": "多 Agent 团队的静态成员档案：在一个面板里定义、校验、编辑与核对。"
+  },
+  "settings": {
+    "nav": "Agent 档案",
+    "language": "语言",
+    "languageHint": "面板默认跟随 DSH 的语言设置；选一个语言即可固定下来。",
+    "languageAuto": "跟随 DSH",
+    "languageZh": "中文",
+    "languageEn": "English",
+    "rosterDirs": "档案库目录",
+    "rosterDirsHint": "留空即全局库 $DSH_HOME/agent-roster（默认 ~/.dsh/agent-roster），不跟工作区走；填相对路径才按工作区解析。",
+    "globalLibrary": "全局默认",
+    "dataDir": "数据目录",
+    "stateDir": "团队状态目录",
+    "stateDirHint": "只读：用于把档案里的值与运行时真正建出来的成员对照。",
+    "policies": "已声明的工具策略",
+    "policiesNone": "未配置——档案里写的策略 id 只是声明，运行时不生效。",
+    "policiesCount": "已声明 {count} 个",
+    "version": "版本",
+    "openPanel": "打开面板"
+  },
+  "panel": {
+    "title": "Agent 档案",
+    "subtitle": "{rosters} 份档案 · {members} 名成员 · {teams} 个团队",
+    "refresh": "刷新",
+    "refreshing": "正在刷新…",
+    "tabsRosters": "档案",
+    "tabsTeams": "团队",
+    "tabsDiagnostics": "体检",
+    "search": "搜索",
+    "searchPlaceholder": "按 id、标题、成员或标签过滤",
+    "create": "新建档案",
+    "import": "导入",
+    "export": "导出",
+    "emptyTitle": "还没有档案",
+    "emptyBody": "一份档案就是档案库目录下的一个 YAML 或 JSON 文件。可以在这里新建，也可以自己把文件放进目录。",
+    "emptyCta": "创建第一份档案",
+    "noMatch": "没有匹配的档案。",
+    "loading": "正在读取档案…",
+    "errorTitle": "读取档案失败",
+    "retry": "重试",
+    "bannerOne": "有 1 项待处理",
+    "bannerMany": "有 {count} 项待处理",
+    "bannerCta": "查看体检",
+    "workspaceFallback": "还没有注册工作区，暂时按进程所在目录读取。",
+    "tabsSources": "档案源"
+  },
+  "roster": {
+    "members": "{count} 名成员",
+    "oneMember": "1 名成员",
+    "version": "v{version}",
+    "file": "文件",
+    "deployed": "已在 {teams}",
+    "notDeployed": "还没进任何团队",
+    "drifted": "{count} 处不一致",
+    "edit": "编辑",
+    "duplicate": "复制一份",
+    "delete": "删除",
+    "copyCreate": "复制建团队载荷",
+    "copied": "已复制到剪贴板",
+    "copyFailed": "剪贴板不可用，请手动选择文本复制。",
+    "noMembers": "这份档案没有成员。",
+    "diagnostics": "{count} 条发现",
+    "showMembers": "展开成员",
+    "hideMembers": "收起成员"
+  },
+  "member": {
+    "prompt": "人设",
+    "tools": "工具",
+    "role": "角色",
+    "model": "模型",
+    "effort": "思考档位",
+    "policy": "工具策略",
+    "fallback": "备用模型",
+    "aliases": "曾用名",
+    "skills": "声明技能",
+    "skillsHint": "仅声明"
+  },
+  "team": {
+    "emptyTitle": "还没有团队",
+    "emptyBody": "团队由 dsh-agent-teams 创建与调度。这里只读它的状态，用来判断档案到底有没有真正建进运行时。",
+    "emptyCta": "从档案复制建团队载荷",
+    "phaseStaged": "待批准",
+    "phaseRunning": "运行中",
+    "halted": "已停止",
+    "escalated": "已升级",
+    "members": "成员",
+    "tasks": "{total} 个任务 · 完成 {completed} · 失败 {failed} · 进行中 {active}",
+    "file": "状态文件",
+    "managed": "来自 {roster}",
+    "unmanaged": "不来自任何档案",
+    "faithful": "与档案一致",
+    "drift": "与档案不一致",
+    "promptChars": "{count} 字人设",
+    "driftDetail": "{field}：档案 {wanted}，运行时 {actual}"
+  },
+  "editor": {
+    "createTitle": "新建档案",
+    "editTitle": "编辑 {id}",
+    "id": "Id",
+    "idHint": "小写字母、数字、点、短横线或下划线；它同时是目录名。",
+    "titleField": "标题",
+    "titleHint": "面板里显示的名字，可自由填写。",
+    "version": "版本",
+    "description": "描述",
+    "tags": "标签",
+    "tagsHint": "用逗号分隔。",
+    "members": "成员",
+    "addMember": "添加成员",
+    "removeMember": "移除",
+    "memberName": "名字",
+    "memberRole": "角色",
+    "memberTitle": "头衔",
+    "memberModel": "模型",
+    "memberProvider": "提供方",
+    "memberEffort": "思考档位",
+    "memberPolicy": "工具策略",
+    "memberScope": "可用工具",
+    "memberScopeHint": "用逗号分隔工具名；留空表示继承。",
+    "memberPrompt": "人设（system prompt）",
+    "memberDescription": "简介",
+    "memberAliases": "曾用名",
+    "listHint": "用逗号分隔。",
+    "memberSkills": "声明技能",
+    "skillsHint": "用逗号分隔技能名。运行时不会据此加载技能，档案只记录意图。",
+    "memberExamples": "典型请求",
+    "examplesHint": "一行一条；派活时当提示用，不会被当成指令执行。",
+    "captain": "队长",
+    "captainHint": "队长是创建团队的那个会话，不是成员。这里记下它应该是什么样；真正的模型由 profile 决定。",
+    "captainName": "队长名",
+    "captainNameHint": "kebab-case；留空即删掉整段 captain。",
+    "captainDescription": "简介",
+    "captainProvider": "提供方",
+    "captainModel": "模型",
+    "captainEffort": "思考档位",
+    "captainPersona": "人格前缀",
+    "captainPersonaHint": "由 agent preset 生效，不是这份档案。写在这里只是为了不丢意图。",
+    "memberTags": "标签",
+    "source": "源码",
+    "form": "表单",
+    "cancel": "取消",
+    "save": "保存",
+    "saving": "正在保存…",
+    "overwriteTitle": "覆盖已有档案？",
+    "overwriteBody": "{file} 已存在。保存会替换它，并在旁边保留一份 .bak 备份。",
+    "overwriteConfirm": "覆盖",
+    "failedTitle": "档案没有保存",
+    "emptyId": "必须填写 id。",
+    "emptyTitle": "必须填写标题。",
+    "emptyMembers": "至少需要一个成员。",
+    "emptyMemberName": "每个成员都要有名字。",
+    "emptyMemberPrompt": "每个成员都要有人设。",
+    "sourceHint": "直接编辑文件原文。宿主会在写入前校验；校验不通过时一个字节都不会落盘。"
+  },
+  "delete": {
+    "title": "删除 {id}？",
+    "body": "这会从档案库里删除 {file}。已经用它建过的团队不受影响，只是不再有档案描述这些成员。",
+    "confirm": "删除",
+    "cancel": "取消"
+  },
+  "importDialog": {
+    "title": "导入档案",
+    "hint": "粘贴一份档案原文。宿主会先校验，再写进选中的目录。",
+    "placeholder": "kind: dsh-agent-roster/v1\nroster: my-team\nversion: 1.0.0\n…",
+    "submit": "导入",
+    "target": "写入"
+  },
+  "import": {
+    "done": "已导入 {file}",
+    "exists": "{file} 已存在。"
+  },
+  "diagnostics": {
+    "title": "体检",
+    "intro": "插件能自查的全部内容：自己的配置、档案库，以及档案所描述的团队。",
+    "empty": "没有问题：配置、档案与团队都是一致的。",
+    "severityError": "错误",
+    "severityWarn": "警告",
+    "severityInfo": "提示",
+    "file": "文件",
+    "location": "{file}:{line}"
+  },
+  "hint": {
+    "workspace-fallback": {
+      "title": "没有注册工作区",
+      "body": "DSH 还没为这次会话注册工作区，档案库目录按进程所在目录解析。打开一个工作区后，面板才能读到正确的文件。"
+    },
+    "roster-dir-missing": {
+      "title": "档案库目录不存在",
+      "body": "{dirSpec} 在 {rootDir} 下不存在。可以建这个目录，或在插件设置里改档案库目录。"
+    },
+    "roster-dir-empty": {
+      "title": "档案库目录是空的",
+      "body": "{rootDir} 存在但没有任何档案。放一个含 roster.yaml 的子目录进去，或者在这里新建一份。"
+    },
+    "no-rosters": {
+      "title": "一份档案都没有",
+      "body": "所有配置的档案库目录都是空的。在有一份档案之前，工具会如实报告 0 份档案。"
+    },
+    "tool-policies-unset": {
+      "title": "工具策略未经交叉校验",
+      "body": "档案里写了工具策略，但插件不知道你的部署声明了哪些 id。在插件设置里填上已声明的策略，就能发现写错的 id。"
+    },
+    "teams-none": {
+      "title": "还没有团队",
+      "body": "团队状态目录 {stateDir} 里没有团队。档案仍然可读，只是“有没有真正部署”无从判断。"
+    },
+    "state-dir-missing": {
+      "title": "团队状态目录不存在",
+      "body": "{stateDir} 还不存在，因此没有团队能与档案对照。在第一个团队创建之前，这是正常现象。"
+    },
+    "duplicate-roster-id": {
+      "title": "档案 id 重复",
+      "body": "有 {count} 个档案 id 同时出现在多个目录里。工具只认第一个匹配，请把其中一个改名。"
+    },
+    "roster-errors": {
+      "title": "有档案带错误",
+      "body": "全库共 {count} 条错误。带错误的档案不能作为建团队成员的来源。"
+    }
+  },
+  "misc": {
+    "copied": "已复制",
+    "yes": "是",
+    "no": "否",
+    "failed": "操作失败"
+  },
+  "source": {
+    "tabsSources": "档案源",
+    "pull": "拉取到本机",
+    "pulling": "拉取中…",
+    "pulled": "写入 {written} 份，未变 {unchanged} 份，冲突 {conflicts} 份",
+    "empty": "还没有配置公共档案源。",
+    "emptyHint": "在插件设置里填一个 https 的 registry 地址，或 npm:pkg。",
+    "stale": "缓存（拉取失败）",
+    "fetchedAt": "上次拉取 {when}",
+    "registered": "登记 {count} 份",
+    "open": "展开查看",
+    "hide": "收起",
+    "loading": "正在读取档案…",
+    "repo": "仓库",
+    "conflictHint": "本地版本与远端不同，未覆盖。"
+  }
+}

package/package.json

@@ -1,6 +1,100 @@
 {
   "name": "@stofone/dsh-agent-roster",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.5.0",
+  "description": "多 Agent 团队的静态成员档案定义与校验层：档案库在面板里看得见、改得动，团队成员的人设、模型与工具边界固化成可校验、可版本化的文件，并在 dsh-agent-teams 创建成员时把档案桥接给运行时。",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "lib",
+    "bin",
+    "index",
+    "locale/*.json",
+    "schema",
+    "icon.svg",
+    "examples",
+    "README.md",
+    "README.zh.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "dsh-agent-roster": "bin/cli.mjs"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "agent-teams",
+    "agent",
+    "roster",
+    "persona",
+    "multi-agent"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "STofone",
+    "url": "https://github.com/STofone"
+  },
+  "homepage": "https://github.com/STofone/dsh-agent-roster#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/STofone/dsh-agent-roster.git"
+  },
+  "bugs": {
+    "url": "https://github.com/STofone/dsh-agent-roster/issues"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.5",
+    "yaml": "^2.9.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-tools": "*"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "test": "node --test",
+    "smoke": "node scripts/host-smoke.mjs && node scripts/client-smoke.mjs",
+    "check:locale": "node scripts/check-locale.mjs",
+    "validate": "node bin/cli.mjs validate"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": false,
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-sidebar",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ]
+    }
+  },
+  "meta": {
+    "title": "Agent Roster",
+    "description": "静态成员档案：定义、校验并桥接多 Agent 团队成员的人设、模型与工具边界。"
+  }
+}