@trim21/personal-pi-extensions 0.0.343 → 0.0.346

package/README.md

@@ -321,7 +321,7 @@ sqlite 文件路径按优先级取第一个可用值：
 ```
 /talk-group-join              # 无参：自动创建一个新 group（uuid 作为组名）并加入
 /talk-group-join <name>       # 加入名为 name 的 group；不存在则创建（名字允许字母/数字/-/_）
-/talk-group-join-last         # 加入最近创建的 group（方便新开 session 快速归队）
+/talk-group-join-last         # 加入最近创建的 group（方便新开 session 快速归队）；支持 --name <alias> 设置显示名
 /talk-group-leave             # 离开当前 group（组空了自动删除）
 /talk-group-list              # 列出所有 group 及其成员，最新创建的在前
 /talk-group-del <name>        # 删除指定 group（成员随之变为未入组）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trim21/personal-pi-extensions",
-  "version": "0.0.343",
+  "version": "0.0.346",
   "type": "module",
   "description": "Custom pi coding-agent extensions: bwrap sandbox, workspace guard, opencode edit, and more",
   "keywords": [

package/src/aft/ast-edit.ts

@@ -302,7 +302,6 @@ export function registerAstEditTool(pi: ExtensionAPI, ctx: AftToolContext): void
               input: params,
               output: text,
             }),
-            expanded: true,
           } satisfies ToolPendant,
         },
       };

package/src/aft/imports.ts

@@ -126,7 +126,6 @@ export function registerImportTool(pi: ExtensionAPI, ctx: AftToolContext): void
               input: params,
               output: text,
             }),
-            expanded: true,
           } satisfies ToolPendant,
         },
       };

package/src/aft/refactor.ts

@@ -145,7 +145,6 @@ export function registerRefactorTool(pi: ExtensionAPI, ctx: AftToolContext): voi
               input: params,
               output: text,
             }),
-            expanded: true,
           } satisfies ToolPendant,
         },
       };

package/src/aft/tools.ts

@@ -427,7 +427,6 @@ export function registerSearchTool(pi: ExtensionAPI, ctx: AftToolContext): void
               output: text,
               truncated,
             }),
-            expanded: true,
           } satisfies ToolPendant,
         },
       };

package/src/lib/pendant.ts

@@ -4,8 +4,6 @@
  * 工具 execute 返回的 details 里可携带一个可折叠的 markdown 面板，TUI 会把它
  * 与本次工具调用的消息一起渲染：
  * - `markdown`: 面板正文（完整 markdown），建议以 `## ` 标题开头、末尾 trim
- * - `expanded`: 面板是否默认展开；识别/结果这类需要立即看到的内容用 true，
- *   列表等常驻信息用 false
  */
 export interface ToolPendant {
   /**
@@ -20,8 +18,4 @@ export interface ToolPendant {
    * 面板正文（完整 markdown），建议以 `## ` 标题开头、末尾 trim
    */
   markdown?: string;
-  /**
-   * @default false
-   */
-  expanded?: boolean;
 }

package/src/opencode/todo.ts

@@ -173,7 +173,6 @@ export default function todowrite(pi: ExtensionAPI) {
           todos,
           pendant: {
             markdown: buildTodoMarkdown(todos),
-            expanded: false,
           },
         },
       });

package/src/spawn-agent.ts

@@ -711,7 +711,6 @@ export default function spawnAgent(pi: ExtensionAPI) {
             ...result,
             pendant: {
               markdown: formatPendantMarkdown(params.task, message),
-              expanded: true,
             } satisfies ToolPendant,
           },
           isError: true,
@@ -729,7 +728,6 @@ export default function spawnAgent(pi: ExtensionAPI) {
           ...result,
           pendant: {
             markdown: formatPendantMarkdown(params.task, text),
-            expanded: false,
           } satisfies ToolPendant,
         },
       };

package/src/talk/core.ts

@@ -530,7 +530,7 @@ export class TalkCore {
       return `Invalid group name '${name}'. Allowed: letters, digits, '-' and '_' (max 64 chars).`;
     }
     if (agentName !== undefined) {
-      await this.writeSelf({ name: agentName });
+      await this.writeSelf({ name: agentName, alias: agentName });
     }
     const nameNote = agentName === undefined ? "" : ` You are visible as "${agentName}".`;
     const existing = await readGroup(this.storage, name);
@@ -556,12 +556,15 @@ export class TalkCore {
     return `Created group ${name}.${nameNote} Other agents join it with /talk-group-join ${name}.`;
   }
 
-  /** Join the most recently created group; no-op when already in it. */
-  async groupJoinLast(): Promise<string> {
+  /**
+   * Join the most recently created group; no-op when already in it. When
+   * `agentName` is given, the agent's display name is set to it.
+   */
+  async groupJoinLast(agentName?: string): Promise<string> {
     const groups = await listGroups(this.storage);
     if (groups.length === 0) return "No groups. Create one with /talk-group-join.";
     const latest = groups.reduce((a, b) => (b.createdAt > a.createdAt ? b : a));
-    return this.groupJoin(latest.id);
+    return this.groupJoin(latest.id, agentName);
   }
 
   /** Leave the current group; an emptied group is deleted. */
@@ -618,6 +621,18 @@ export class TalkCore {
     return `Groups (${groups.length}):\n${lines.join("\n")}`;
   }
 
+  /**
+   * Status-bar text for the caller: "alias@group" when an explicit alias was
+   * set via `talk-group-join --name`, "@group" otherwise; undefined when the
+   * caller is in no group (the adapter clears its status bar).
+   */
+  async groupStatus(): Promise<string | undefined> {
+    const self = this.requireSelf();
+    const group = await groupForAgent(this.storage, self.agentId);
+    if (!group) return undefined;
+    return self.alias ? `${self.alias}@${group.id}` : `@${group.id}`;
+  }
+
   async send(to: string, body: string): Promise<string> {
     if (!to) return 'send requires "to".';
     if (!body) return 'send requires "message".';

package/src/talk/index.ts

@@ -14,7 +14,9 @@ import * as path from "node:path";
 
 import {
   type ExtensionAPI,
+  type ExtensionCommandContext,
   type ExtensionContext,
+  type ExtensionUIContext,
   getAgentDir,
   truncateToVisualLines,
 } from "@earendil-works/pi-coding-agent";
@@ -161,6 +163,19 @@ export default function talk(pi: ExtensionAPI) {
     return undefined;
   }
 
+  /** Refresh the talk footer/status-bar text: "alias@group", or "@group" with no explicit alias. */
+  function refreshGroupStatus(ui: ExtensionUIContext): void {
+    void (async () => {
+      if (!self) return;
+      try {
+        const text = await core.groupStatus();
+        ui.setStatus("talk", text && ui.theme.fg("accent", text));
+      } catch {
+        // status bar is best-effort; never break the agent
+      }
+    })();
+  }
+
   // ── Lifecycle ──────────────────────────────────────────────────────────
 
   pi.on("session_start", (_event, ctx: ExtensionContext) => {
@@ -177,7 +192,7 @@ export default function talk(pi: ExtensionAPI) {
       lastSeenAt: now,
       status: "idle",
     };
-    void core.start(self);
+    void core.start(self).then(() => refreshGroupStatus(ctx.ui));
   });
 
   pi.on("agent_start", () => core.setWorking());
@@ -278,6 +293,7 @@ export default function talk(pi: ExtensionAPI) {
   function handleCommand<TFlags extends TObject>(
     spec: CommandSpec<TFlags>,
     args: string,
+    ctx: ExtensionCommandContext,
     run: (parsed: OkResult<TFlags>) => Promise<string> | string,
   ): Promise<void> {
     const parsed = parseCommand(spec, args);
@@ -289,6 +305,9 @@ export default function talk(pi: ExtensionAPI) {
       const initError = requireInit();
       const text = initError ?? (await run(parsed));
       pi.sendMessage({ customType: LIST_TYPE, content: text, display: true });
+      // Group membership can change under any of these commands; keep the
+      // footer/status-bar text in sync.
+      refreshGroupStatus(ctx.ui);
     })();
   }
 
@@ -327,9 +346,13 @@ export default function talk(pi: ExtensionAPI) {
 
   const TALK_GROUP_JOIN_LAST_SPEC = {
     name: "talk-group-join-last",
-    usage: "",
-    description: "Join the most recently created agent group (no-op when already in it).",
-    flags: Type.Object({}),
+    usage: "[options]",
+    description:
+      "Join the most recently created agent group (no-op when already in it); --name <alias> additionally sets this agent's display name",
+    flags: Type.Object({
+      name: Type.Optional(Type.String({ description: "Set this agent's display name" })),
+    }),
+    flagMeta: { name: { short: "n", valuePlaceholder: "<alias>" } },
     arity: { max: 0 },
   };
 
@@ -368,13 +391,13 @@ export default function talk(pi: ExtensionAPI) {
 
   pi.registerCommand("talk", {
     description: TALK_SPEC.description,
-    handler: (args) => handleCommand(TALK_SPEC, args, async () => core.list()),
+    handler: (args, ctx) => handleCommand(TALK_SPEC, args, ctx, async () => core.list()),
   });
 
   pi.registerCommand("talk-dead", {
     description: TALK_DEAD_SPEC.description,
-    handler: (args) =>
-      handleCommand(TALK_DEAD_SPEC, args, async (parsed) => {
+    handler: (args, ctx) =>
+      handleCommand(TALK_DEAD_SPEC, args, ctx, async (parsed) => {
         if (parsed.flags.all && parsed.args.length > 0) {
           return "--all cannot be combined with an agent id.\nTry '/talk-dead --help' for usage.";
         }
@@ -388,8 +411,8 @@ export default function talk(pi: ExtensionAPI) {
 
   pi.registerCommand("talk-group-join", {
     description: TALK_GROUP_JOIN_SPEC.description,
-    handler: (args) =>
-      handleCommand(TALK_GROUP_JOIN_SPEC, args, async (parsed) => {
+    handler: (args, ctx) =>
+      handleCommand(TALK_GROUP_JOIN_SPEC, args, ctx, async (parsed) => {
         const agentName = parsed.flags.name?.trim() || undefined;
         if (agentName !== undefined) explicitName = agentName;
         return core.groupJoin(parsed.args[0], agentName);
@@ -398,29 +421,38 @@ export default function talk(pi: ExtensionAPI) {
 
   pi.registerCommand("talk-group-join-last", {
     description: TALK_GROUP_JOIN_LAST_SPEC.description,
-    handler: (args) =>
-      handleCommand(TALK_GROUP_JOIN_LAST_SPEC, args, async () => core.groupJoinLast()),
+    handler: (args, ctx) =>
+      handleCommand(TALK_GROUP_JOIN_LAST_SPEC, args, ctx, async (parsed) => {
+        const agentName = parsed.flags.name?.trim() || undefined;
+        if (agentName !== undefined) explicitName = agentName;
+        return core.groupJoinLast(agentName);
+      }),
   });
 
   pi.registerCommand("talk-group-leave", {
     description: TALK_GROUP_LEAVE_SPEC.description,
-    handler: (args) => handleCommand(TALK_GROUP_LEAVE_SPEC, args, async () => core.groupLeave()),
+    handler: (args, ctx) =>
+      handleCommand(TALK_GROUP_LEAVE_SPEC, args, ctx, async () => core.groupLeave()),
   });
 
   pi.registerCommand("talk-group-list", {
     description: TALK_GROUP_LIST_SPEC.description,
-    handler: (args) => handleCommand(TALK_GROUP_LIST_SPEC, args, async () => core.groupList()),
+    handler: (args, ctx) =>
+      handleCommand(TALK_GROUP_LIST_SPEC, args, ctx, async () => core.groupList()),
   });
 
   pi.registerCommand("talk-group-del", {
     description: TALK_GROUP_DEL_SPEC.description,
-    handler: (args) =>
-      handleCommand(TALK_GROUP_DEL_SPEC, args, async (parsed) => core.groupDelete(parsed.args[0])),
+    handler: (args, ctx) =>
+      handleCommand(TALK_GROUP_DEL_SPEC, args, ctx, async (parsed) =>
+        core.groupDelete(parsed.args[0]),
+      ),
   });
 
   pi.registerCommand("talk-group-clear", {
     description: TALK_GROUP_CLEAR_SPEC.description,
-    handler: (args) => handleCommand(TALK_GROUP_CLEAR_SPEC, args, async () => core.groupClear()),
+    handler: (args, ctx) =>
+      handleCommand(TALK_GROUP_CLEAR_SPEC, args, ctx, async () => core.groupClear()),
   });
 
   // ── Delivery card ──────────────────────────────────────────────────────

package/src/talk/registry.ts

@@ -36,6 +36,8 @@ export const AgentRecordSchema = Type.Object({
   addr: Type.String(),
   agentId: Type.String(),
   name: Type.String(),
+  /** Display name explicitly set via `talk-group-join --name`, distinct from the session name. */
+  alias: Type.Optional(Type.String()),
   cwd: Type.String(),
   pid: Type.Number(),
   pidStart: Type.Optional(Type.Number()),

package/src/vision-agent.ts

@@ -445,7 +445,6 @@ export default function visionAgent(pi: ExtensionAPI) {
             count: paths.length,
             pendant: {
               markdown,
-              expanded: true,
             } satisfies ToolPendant,
           },
         };
@@ -465,7 +464,6 @@ export default function visionAgent(pi: ExtensionAPI) {
             error: message,
             pendant: {
               markdown: `## 图片识别失败\n\n${message}`,
-              expanded: true,
             } satisfies ToolPendant,
           },
         };