@ycodium-ai/plugin-team 0.2.3060 → 0.2.3072

package/dist/index.js

@@ -6776,19 +6776,29 @@ function toCodecJsonBase(ast, recur) {
 var MEMBER_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
 var MAX_NAME_LENGTH = 40;
 var MAX_MEMBERS = 8;
-var TeamMember = Struct({ memberId: String4, name: String4 });
+var TeamMember = Struct({
+  memberId: String4,
+  name: String4,
+  principal: optionalKey2(
+    Struct({ kind: Literal2("remote-agent"), principalId: String4 })
+  )
+});
 var RosterRuleCode = Literals([
   "member-count",
   "invalid-member-id",
   "invalid-name",
   "duplicate-member-id",
   "duplicate-name",
-  "lead-not-member"
+  "lead-not-member",
+  "lead-remote",
+  "duplicate-principal",
+  "invalid-principal"
 ]);
 function rosterRuleError(input) {
   if (input.members.length < 1 || input.members.length > MAX_MEMBERS) return "member-count";
   const ids = /* @__PURE__ */ new Set();
   const names = /* @__PURE__ */ new Set();
+  const principals = /* @__PURE__ */ new Set();
   for (const member of input.members) {
     if (!MEMBER_ID_PATTERN.test(member.memberId)) return "invalid-member-id";
     const name = member.name.trim();
@@ -6796,6 +6806,13 @@ function rosterRuleError(input) {
     if (ids.has(member.memberId)) return "duplicate-member-id";
     const foldedName = name.toLowerCase();
     if (names.has(foldedName)) return "duplicate-name";
+    if (member.principal !== void 0) {
+      const { principalId } = member.principal;
+      if (principalId.trim().length === 0) return "invalid-principal";
+      if (principals.has(principalId)) return "duplicate-principal";
+      principals.add(principalId);
+      if (member.memberId === input.leadMemberId) return "lead-remote";
+    }
     ids.add(member.memberId);
     names.add(foldedName);
   }
@@ -6848,19 +6865,31 @@ var factTime = () => runPromise2(nowIso);
 var PERSON_MESSAGE_RULE = "Send a message to the person only when you need their answer; put progress and updates in work item comments with work_post_comment instead.";
 var tableCell = (value) => value.replace(/\|/g, "\\|").replace(/[\r\n]/g, " ");
 function leadBrief(goal, roster) {
-  const members = goal.threads.filter((thread) => thread.memberId !== goal.leadMemberId).map((thread) => {
+  const localMembers = goal.threads.filter((thread) => thread.memberId !== goal.leadMemberId).map((thread) => {
     const name = roster.members.find((member) => member.memberId === thread.memberId)?.name ?? thread.memberId;
     return `| ${tableCell(name)} | ${tableCell(thread.threadId)} |`;
   });
+  const remoteMembers = (goal.remoteMembers ?? []).map((member) => {
+    const name = roster.members.find((row) => row.memberId === member.memberId)?.name ?? member.memberId;
+    return `| ${tableCell(name)} | remote-agent: ${tableCell(member.principalId)} |`;
+  });
   return [
     "You are the lead of this project's team. Your goal is:",
     goal.goal,
-    "Team members and their conversations (your own conversation is omitted):",
-    ["| Member | threadId |", "| --- | --- |", ...members].join("\n"),
+    "Team members and their assignment identities (your own conversation is omitted):",
+    [
+      "| Member | threadId / remote principalId |",
+      "| --- | --- |",
+      ...localMembers,
+      ...remoteMembers
+    ].join("\n"),
     "Use work_create_item to split the goal into a few work items: one item per task, with a clear action in the title and the deliverable in the description. Create them without assignees.",
     'Then use work_add_relation with type "blocked_by" to record dependencies: the dependent workItemId is blocked by the prerequisite relatedWorkItemId.',
     "If a work item for this goal is assigned to you, also record it as blocked by every item you create. When they are all done you will be told; then check the results and mark that item done with work_update_item.",
-    `Only after all dependencies are recorded, assign each item to exactly one member conversation with work_update_item and assignees: [{ "kind": "agent", "threadId": "<threadId from the table>" }]. A member is told about an item as soon as it is assigned, so assigning before the dependencies exist starts blocked work early. Do not do members' tasks yourself.`,
+    `Only after all dependencies are recorded, assign each item to exactly one member with work_update_item. For local members use assignees: [{ "kind": "agent", "threadId": "<threadId from the table>" }]. A local member is told about an item as soon as it is assigned, so assigning before the dependencies exist starts blocked work early. Do not do members' tasks yourself.`,
+    ...remoteMembers.length === 0 ? [] : [
+      'Remote members are on another machine. To give them work, assign the work item to them with work_update_item and assignees: [{ "kind": "remote-agent", "principalId": "<principalId from the table>" }]; they pick it up from their own machine. Do not create conversations, start turns, or send wake-up signals for them on this machine.'
+    ],
     "Use work_list_items to check progress. When all work is complete, summarize the results here in one or two sentences.",
     PERSON_MESSAGE_RULE,
     "If the work item tools are unavailable, tell the user directly that this project needs the board and project memory switches turned on first."
@@ -6880,6 +6909,9 @@ var TeamGoal = Struct({
   goal: String4.check(isMinLength(1), isMaxLength(GOAL_MAX_LENGTH)),
   leadMemberId: String4,
   threads: ArraySchema(Struct({ memberId: String4, threadId: String4 })),
+  remoteMembers: optionalKey2(
+    ArraySchema(Struct({ memberId: String4, principalId: String4 }))
+  ),
   startedAt: String4
 });
 var teamThreadId = (projectId, goalId, memberId) => memberId === null ? `team-lead:${projectId}:${goalId}` : `team-member:${projectId}:${goalId}:${memberId}`;
@@ -6892,7 +6924,8 @@ var ReadGoalResult = NullOr(
       Struct({
         memberId: String4,
         name: NullOr(String4),
-        threadId: String4
+        threadId: optionalKey2(String4),
+        principalId: optionalKey2(String4)
       })
     )
   })
@@ -6956,9 +6989,9 @@ function createGoalService(ctx, rosterService, options = {}) {
     const roster = await rosterService.read(projectId);
     return {
       ...goal,
-      members: goal.threads.map((thread) => ({
-        ...thread,
-        name: roster?.members.find((member) => member.memberId === thread.memberId)?.name ?? null
+      members: [...goal.threads, ...goal.remoteMembers ?? []].map((member) => ({
+        ...member,
+        name: roster?.members.find((row) => row.memberId === member.memberId)?.name ?? null
       }))
     };
   };
@@ -6973,15 +7006,19 @@ function createGoalService(ctx, rosterService, options = {}) {
     if (roster === null) return rejectGoal("no-roster");
     const key = requestKey(input.projectId, input.requestId);
     const leadThreadId = teamThreadId(input.projectId, input.requestId, null);
+    const remoteMembers = roster.members.flatMap(
+      (member) => member.principal === void 0 ? [] : [{ memberId: member.memberId, principalId: member.principal.principalId }]
+    );
     let goal = readFact(await requests.get(), key) ?? {
       projectId: input.projectId,
       goalId: input.requestId,
       goal: text,
       leadMemberId: roster.leadMemberId,
-      threads: roster.members.map((member) => ({
+      threads: roster.members.filter((member) => member.principal === void 0).map((member) => ({
         memberId: member.memberId,
         threadId: member.memberId === roster.leadMemberId ? leadThreadId : teamThreadId(input.projectId, input.requestId, member.memberId)
       })),
+      ...remoteMembers.length === 0 ? {} : { remoteMembers },
       startedAt: await now3()
     };
     const receipt = await ctx.events.append({
@@ -7156,6 +7193,7 @@ var BoardState = Struct({
 });
 var WorkIdentity = Struct({
   kind: String4,
+  principalId: optionalKey2(String4),
   threadId: optionalKey2(String4),
   pluginId: optionalKey2(String4),
   /** 人的稳定键（见 personKey），界面拿它到快照的人名表里找名字。 */
@@ -7164,11 +7202,27 @@ var WorkIdentity = Struct({
 var personKey = (principal) => principal.kind === "account" ? `account:${principal.userId}` : `local-owner:${principal.environmentId}`;
 var workIdentity = (value) => ({
   kind: value.kind,
+  ...value.principalId === void 0 ? {} : { principalId: value.principalId },
   ...value.threadId === void 0 ? {} : { threadId: value.threadId },
   ...value.pluginId === void 0 ? {} : { pluginId: value.pluginId },
   ...value.principal === void 0 ? {} : { personKey: personKey(value.principal) }
 });
 var BoardPerson = Struct({ key: String4, displayName: String4 });
+var BoardRemoteAgent = Struct({
+  principalId: String4,
+  label: String4,
+  state: Literals(["active", "disabled", "revoked"]),
+  lastUsedAt: optionalKey2(String4)
+});
+var BoardRemoteWork = Struct({
+  principalId: String4,
+  pending: NullOr(
+    Struct({
+      count: Number5,
+      items: ArraySchema(Struct({ workItemId: String4, blocked: Boolean2 }))
+    })
+  )
+});
 var BoardItem = Struct({
   workItemId: String4,
   sequenceId: Number5,
@@ -7184,6 +7238,12 @@ var BoardSnapshot = Struct({
   // 当前目标与 goal 命令同一份形状；目标栏与看板都从这里读，同一个门铃刷新。
   goal: ReadGoalResult,
   people: ArraySchema(BoardPerson),
+  // 已保存名单里的成员；名字显示（含远端成员）读这里，名单编辑器的草稿另存。
+  rosterMembers: ArraySchema(TeamMember),
+  remoteAgents: ArraySchema(BoardRemoteAgent),
+  remoteAgentsUnavailable: optionalKey2(Literal2(true)),
+  remoteWork: ArraySchema(BoardRemoteWork),
+  viewerKey: optionalKey2(String4),
   // 负责人要用看板与项目记忆两组工具；开关由宿主控件拨，这里只读来提示。
   toolkits: Struct({ board: Boolean2, memory: Boolean2 }),
   truncated: Boolean2
@@ -7222,6 +7282,7 @@ var UpdateItemResult = Union2([
 // src/board.ts
 var ITEM_LIMIT = 500;
 var PEOPLE_LIMIT = 200;
+var REMOTE_AGENT_LIMIT = 1e3;
 var decodeRead = decodeUnknownSync(ReadBoardInput);
 var decodeCreate = decodeUnknownOption2(CreateItemInput);
 var decodeUpdate = decodeUnknownOption2(UpdateItemInput);
@@ -7241,7 +7302,7 @@ var WORK_EVENTS = [
   "board.toolkit-set",
   "memory.toolkit-set"
 ];
-function registerBoardCommands(ctx, goals, options = {}) {
+function registerBoardCommands(ctx, goals, rosters, options = {}) {
   const after = options.after ?? ((delay2, notify) => {
     const timer = NodeTimers.setTimeout(notify, delay2);
     return () => NodeTimers.clearTimeout(timer);
@@ -7251,20 +7312,38 @@ function registerBoardCommands(ctx, goals, options = {}) {
     name: "board",
     scope: "read",
     payloadSchema: payloadSchemaOf(ReadBoardInput),
-    handle: async (payload) => {
+    handle: async (payload, invocation) => {
       const { projectId } = decodeRead(payload);
-      const [stateList, goal, toolkitStates, people] = await Promise.all([
+      const [stateList, goal, roster, toolkitStates, people, remoteAgents, viewer] = await Promise.all([
         ctx.work.states.list({ projectId }),
         goals.read(projectId),
+        // 已保存的名单随 team/roster-set 门铃一起刷新；看板上的名字只认这一份，不认编辑器里的草稿。
+        rosters.read(projectId),
         ctx.projects.toolkits.get({ projectId }),
         // 人名只用来显示作者；本机所有者排第一，后面是这个项目认识的账号。
-        readPages(PEOPLE_LIMIT, (page) => ctx.communication.people.list({ projectId, ...page }))
+        readPages(PEOPLE_LIMIT, (page) => ctx.communication.people.list({ projectId, ...page })),
+        // 主体目录只用于名字与选择器；任何一页读失败都退回空目录，不连累看板。
+        readPages(
+          REMOTE_AGENT_LIMIT,
+          (page) => ctx.auth.remoteAgents.list({ projectId, ...page })
+        ).catch(() => null),
+        // 认出当前读者只为把作者显示成「你」：读不出来就当没有，不连累整张看板。
+        invocation.viewer?.communication.people.current({}).catch(() => null)
+      ]);
+      const [remoteWork, { items: rows, truncated }] = await Promise.all([
+        Promise.all(
+          (roster?.members ?? []).flatMap(
+            (member) => member.principal === void 0 ? [] : [
+              ctx.work.remoteAgentPending.get({ projectId, principalId: member.principal.principalId }).then(
+                ({ work }) => ({ count: work.count, items: work.items }),
+                () => null
+              ).then((pending) => ({ principalId: member.principal.principalId, pending }))
+            ]
+          )
+        ),
+        readPages(ITEM_LIMIT, (page) => ctx.work.items.list({ projectId, ...page }))
       ]);
       const enabled = (toolkit) => toolkitStates.toolkits.some((row) => row.toolkit === toolkit && row.enabled);
-      const { items: rows, truncated } = await readPages(
-        ITEM_LIMIT,
-        (page) => ctx.work.items.list({ projectId, ...page })
-      );
       const items = rows.map((item) => ({
         workItemId: item.workItemId,
         sequenceId: item.sequenceId,
@@ -7287,6 +7366,19 @@ function registerBoardCommands(ctx, goals, options = {}) {
           key: personKey(row.person),
           displayName: row.displayName
         })),
+        rosterMembers: roster?.members ?? [],
+        // 读不出来时记一笔，添加菜单要说「读不出来」而不是「还没有」。
+        ...remoteAgents === null ? { remoteAgentsUnavailable: true } : {},
+        remoteAgents: (remoteAgents?.items ?? []).map(
+          ({ principalId, label, state, lastUsedAt }) => ({
+            principalId,
+            label,
+            state,
+            ...lastUsedAt === void 0 ? {} : { lastUsedAt }
+          })
+        ),
+        remoteWork,
+        ...viewer?.person == null ? {} : { viewerKey: personKey(viewer.person) },
         toolkits: { board: enabled("board"), memory: enabled("memory") },
         truncated
       };
@@ -7728,7 +7820,8 @@ var decodeEnvelope2 = decodeUnknownOption2(
 );
 var Principal = Union2([
   Struct({ kind: Literal2("human") }),
-  Struct({ kind: Literal2("agent"), threadId: String4 })
+  Struct({ kind: Literal2("agent"), threadId: String4 }),
+  Struct({ kind: Literal2("remote-agent"), principalId: String4 })
 ]);
 var Actor = Union2([
   Principal,
@@ -8042,13 +8135,13 @@ function startWakeRuntime(ctx, options = {}) {
 // src/index.ts
 var index_default = definePlugin({
   id: "team",
-  apiVersion: 11,
+  apiVersion: 12,
   activate(ctx) {
     const rosters = createRosterService(ctx);
     registerRosterCommands(ctx, rosters);
     const goals = createGoalService(ctx, rosters);
     registerGoalCommands(ctx, goals);
-    registerBoardCommands(ctx, goals);
+    registerBoardCommands(ctx, goals, rosters);
     registerDetailCommands(ctx);
     startWakeRuntime(ctx);
   }

package/locales/en.json

@@ -66,12 +66,14 @@
     "reload": "Reload details",
     "notFound": "This work item was not found in this project.",
     "actor": {
+      "you": "You",
       "human": "A person",
       "otherAgent": "Other agent",
       "team": "Teams plugin",
       "plugin": "Plugin {{pluginId}}",
       "localCli": "Local command line",
-      "system": "System"
+      "system": "System",
+      "remoteAgentFallback": "Remote agent"
     },
     "history": {
       "title": "Activity history",
@@ -113,7 +115,8 @@
     "invalidGoal": "The goal must be 1–4000 characters after trimming spaces.",
     "invalidRequestId": "The request ID must be 1–64 letters, numbers, underscores, or hyphens.",
     "loadFailed": "The current goal could not be loaded. Try reloading it.",
-    "startFailed": "The goal could not be fully started. Retry to finish creating the threads and sending the lead's brief."
+    "startFailed": "The goal could not be fully started. Retry to finish creating the threads and sending the lead's brief.",
+    "remoteMembers": "Remote members:"
   },
   "roster": {
     "title": "Roster",
@@ -123,6 +126,9 @@
     "leadFor": "Make member {{number}} the lead",
     "remove": "Remove member {{number}}",
     "add": "Add member",
+    "addRemoteAgent": "Add remote agent",
+    "noRemoteAgents": "There are no available remote agents on this machine yet.",
+    "remote": "Remote",
     "save": "Save",
     "saving": "Saving…",
     "saved": "Roster saved",
@@ -142,6 +148,26 @@
     "invalidName": "Member names must be 1–40 characters after trimming spaces.",
     "duplicateMemberId": "Each member needs a different ID.",
     "duplicateName": "Member names must be different, ignoring capitalization and surrounding spaces.",
-    "leadNotMember": "Choose a lead from the members."
+    "leadNotMember": "Choose a lead from the members.",
+    "leadRemote": "The lead must be a local member.",
+    "duplicatePrincipal": "Each remote agent can appear only once in the roster.",
+    "invalidPrincipal": "A remote agent must have a non-empty principal ID.",
+    "allRemoteAgentsAdded": "All available remote agents are already on the roster.",
+    "remoteAgentsUnavailable": "Could not read the remote agents on this machine. Try again later.",
+    "remoteSource": "Remote agent: {{label}}"
+  },
+  "remoteStatus": {
+    "title": "Remote members",
+    "none": "No remote members on the roster. Add one with “Add remote agent” in the roster.",
+    "lastSeen": "Last seen {{time}}",
+    "neverSeen": "Not seen yet",
+    "workUnavailable": "Could not read this member's work. Try again later.",
+    "noWork": "No work assigned.",
+    "item": "#{{number}} {{title}}",
+    "disabled": "Disabled",
+    "revoked": "No active credentials",
+    "lastSeenUnavailable": "Could not read when it was last seen",
+    "blocked": "Blocked",
+    "more": "{{count}} more not listed here"
   }
 }

package/locales/zh-CN.json

@@ -66,12 +66,14 @@
     "reload": "重新载入详情",
     "notFound": "这个项目中找不到这件工作项。",
     "actor": {
+      "you": "你",
       "human": "人",
       "otherAgent": "其他 agent",
       "team": "团队插件",
       "plugin": "插件 {{pluginId}}",
       "localCli": "本机命令行",
-      "system": "系统"
+      "system": "系统",
+      "remoteAgentFallback": "远端 agent"
     },
     "history": {
       "title": "活动历史",
@@ -113,7 +115,8 @@
     "invalidGoal": "目标去掉首尾空白后需为 1 到 4000 个字符。",
     "invalidRequestId": "请求 ID 需为 1 到 64 个字母、数字、下划线或连字符。",
     "loadFailed": "未能载入当前目标，请重新载入。",
-    "startFailed": "目标未能全部开始，请重试以补齐会话并给负责人发话。"
+    "startFailed": "目标未能全部开始，请重试以补齐会话并给负责人发话。",
+    "remoteMembers": "远端成员："
   },
   "roster": {
     "title": "名单",
@@ -123,6 +126,9 @@
     "leadFor": "将成员 {{number}} 设为负责人",
     "remove": "删除成员 {{number}}",
     "add": "添加成员",
+    "addRemoteAgent": "添加远端 agent",
+    "noRemoteAgents": "这台机器上还没有可用的远端 agent。",
+    "remote": "远端",
     "save": "保存",
     "saving": "保存中…",
     "saved": "名单已保存",
@@ -142,6 +148,26 @@
     "invalidName": "成员名字去掉首尾空白后需为 1 到 40 个字符。",
     "duplicateMemberId": "每名成员的 ID 必须不同。",
     "duplicateName": "成员名字不能重复，大小写不同或首尾有空白也算重复。",
-    "leadNotMember": "请从名单中选择一名负责人。"
+    "leadNotMember": "请从名单中选择一名负责人。",
+    "leadRemote": "负责人必须是本机成员。",
+    "duplicatePrincipal": "同一个远端 agent 在名单里只能出现一次。",
+    "invalidPrincipal": "远端 agent 的主体 ID 不能为空。",
+    "allRemoteAgentsAdded": "可用的远端 agent 都已在名单里。",
+    "remoteAgentsUnavailable": "暂时读不出这台机器上的远端 agent，请稍后再试。",
+    "remoteSource": "远端 agent：{{label}}"
+  },
+  "remoteStatus": {
+    "title": "远端成员",
+    "none": "名单里还没有远端成员。可在名单里用「添加远端 agent」加入。",
+    "lastSeen": "最近来过：{{time}}",
+    "neverSeen": "还没来过",
+    "workUnavailable": "暂时读不出它手上的活，请稍后再试。",
+    "noWork": "手上没有活。",
+    "item": "#{{number}} {{title}}",
+    "disabled": "已停用",
+    "revoked": "没有可用凭据",
+    "lastSeenUnavailable": "暂时读不出最近来过的时间",
+    "blocked": "被挡着",
+    "more": "还有 {{count}} 件没在这里列出"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ycodium-ai/plugin-team",
-  "version": "0.2.3060",
+  "version": "0.2.3072",
   "description": "A project team roster with members, a lead, and goals.",
   "keywords": [
     "teams",
@@ -34,7 +34,7 @@
     "tailwindcss": "^4.0.0",
     "typescript": "~6.0.3",
     "vite-plus": "0.2.2",
-    "@ycodium-ai/plugin-api": "0.2.0"
+    "@ycodium-ai/plugin-api": "0.2.3072"
   },
   "ycodium": {
     "plugin": "./dist/index.js",