@master.g/pi-wingman 0.0.3 → 0.0.4

package/README.md

@@ -10,7 +10,7 @@
 | **advisor** | oh-my-pi advisor | 指定一个模型当顾问，读主 agent 的每个 turn，以 steer 消息内联注入便签（aside / concern / blocker）让主 agent 纠偏 |
 | **hint** | Claude Code prompt suggestions | 任务结束后按上下文与目标生成下一步 prompt，输入框 ghost text 呈现：Tab 填入、Enter 直接发送 |
 
-> 状态：早期版本（v0.0.3）。hint、advisor、heads-up 三个功能均已实现，默认关闭，尚在试用打磨中。
+> 状态：早期版本（v0.0.4）。hint、advisor、heads-up 三个功能均已实现，默认关闭，尚在试用打磨中。
 
 ## 安装
 
@@ -30,7 +30,7 @@ pi --extension ~/github/pi-wingman/index.ts
 - `/wingman advisor|hint|headsup` — 不带值时弹出 pi 的模型选择器（同 `/model`，可搜索），选完模型再选思考强度（同 `/thinking`，Esc 跳过）；也可直接写 `<provider/model> [effort]`（模型须存在，effort 须是该模型支持的档位）、`on` / `off`（开关，保留已设模型与 effort）；参数支持补全
 - `/ask-advisor <问题>` — 就当前上下文咨询顾问模型，回答注入对话
 
-advisor 与 heads-up 审计通过（ok）时不打扰，只在底栏状态显示 `advisor ⋯`（审计中）、`advisor ✓ ok`（结果级别）或 `advisor ✗ 原因`（调用失败）；自定义 footer 扩展需要自己渲染扩展状态才看得到。
+advisor 与 heads-up 审计通过（ok）时不打扰，只在底栏状态显示 `advisor ⋯`（审计中）、`advisor ✓ ok`（结果级别）或 `advisor ✗ 原因`（调用失败）；hint 生成中显示 `hint ⋯`，失败显示 `hint ✗ 原因`，成功后 hint 直接出现在输入行；自定义 footer 扩展需要自己渲染扩展状态才看得到。
 
 ## 配置
 
@@ -44,7 +44,7 @@ advisor 与 heads-up 审计通过（ok）时不打扰，只在底栏状态显示
 }
 ```
 
-三个功能默认都关闭：每个功能都会额外调用模型，需要用户自己开启。模型形如 `provider/model-id`；hint 没配模型时用当前模型（`/wingman hint on`），advisor/heads-up 必须配模型才会激活。`effort` 可选（off / minimal / low / medium / high / xhigh / max，按模型支持的档位校正），不设则不开推理。advisor/heads-up 在后台跑，单次调用超时 60 秒；hint 要求快，超时 10 秒，高 effort 多半超时，超时就不出 hint。
+三个功能默认都关闭：每个功能都会额外调用模型，需要用户自己开启。模型形如 `provider/model-id`；hint 没配模型时用当前模型（`/wingman hint on`），advisor/heads-up 必须配模型才会激活。`effort` 可选（off / minimal / low / medium / high / xhigh / max，按模型支持的档位校正），不设则不开推理。advisor/heads-up 在后台跑，单次调用超时 60 秒；hint 超时 30 秒；hint 越快越有用，建议不设或用低 effort（实测 glm-5.3-flash 不设约 2 秒，max 要 6–14 秒）。
 
 ## License
 

package/hint.ts

@@ -7,11 +7,11 @@
  * before_agent_start 清除 hint 并使在途生成作废。
  */
 
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { buildDigest, type DigestMessage } from "./audit.js";
 import type { WingmanConfig } from "./config.js";
 import type { EditorManager } from "./editor.js";
-import { completeText, resolveModel, type AnyModel, type ModelRegistry } from "./llm.js";
+import { completeText, resolveModel, type AnyModel } from "./llm.js";
 
 const HINT_SYSTEM_PROMPT = `The user is driving an AI coding agent. Given the user's goal and the latest transcript, suggest the single next prompt the user is most likely to send.
 
@@ -22,6 +22,7 @@ Rules:
 - If the work looks finished, suggest a sensible follow-up or say "继续".`;
 
 const MAX_HINT_CHARS = 120;
+const STATUS_KEY = "wingman-hint";
 
 export function installHint(
 	pi: ExtensionAPI,
@@ -33,10 +34,11 @@ export function installHint(
 	/** 每个新 run 自增;生成回来时代际已变说明 hint 过期,丢弃。 */
 	let generation = 0;
 
-	const generate = async (registry: ModelRegistry, model: AnyModel, transcript: string, gen: number) => {
+	const generate = async (ctx: ExtensionContext, model: AnyModel, transcript: string, gen: number) => {
+		ctx.ui.setStatus(STATUS_KEY, "hint ⋯");
 		const goal = getGoal() ? `User's goal: ${getGoal()}\n\n` : "";
 		const result = await completeText(
-			registry,
+			ctx.modelRegistry,
 			model,
 			{
 				systemPrompt: HINT_SYSTEM_PROMPT,
@@ -48,16 +50,19 @@ export function installHint(
 					},
 				],
 			},
-			// hint 要快:高 effort 多半超时,失败即无 hint
-			{ timeoutMs: 10_000, signal: shutdown.signal, effort: getConfig().hint.effort },
+			// 高 effort 常要 10s 以上;迟到的 hint 由代际与空编辑器判断兜底,放宽无副作用
+			{ timeoutMs: 30_000, signal: shutdown.signal, effort: getConfig().hint.effort },
 		);
-		if (!result.ok || gen !== generation) return; // 静默降级 / 已过期
+		if (gen !== generation) return; // 已过期:新 run 开始时已清状态
+		ctx.ui.setStatus(STATUS_KEY, result.ok ? undefined : `hint ✗ ${result.reason.slice(0, 60)}`);
+		if (!result.ok) return;
 		editors.current?.setHint(result.text.replace(/\s+/g, " ").trim().slice(0, MAX_HINT_CHARS));
 	};
 
-	pi.on("before_agent_start", () => {
+	pi.on("before_agent_start", (_event, ctx) => {
 		generation++;
 		editors.current?.setHint(undefined);
+		ctx.ui.setStatus(STATUS_KEY, undefined);
 	});
 
 	pi.on("agent_end", (event, ctx) => {
@@ -68,7 +73,7 @@ export function installHint(
 		const transcript = buildDigest(event.messages as DigestMessage[], { maxMessages: 6, perMessageChars: 500 });
 		if (!transcript) return;
 		// 后台执行已在 runner 的 try/catch 之外,自己兜底(会话替换后 UI 调用可能抛)
-		generate(ctx.modelRegistry, model, transcript, generation).catch(() => {});
+		generate(ctx, model, transcript, generation).catch(() => {});
 	});
 
 	pi.on("session_shutdown", () => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@master.g/pi-wingman",
-	"version": "0.0.3",
+	"version": "0.0.4",
 	"description": "Wingman for pi — heads-up audit while the agent works, a designated advisor model, and next-prompt hints (Tab/Enter to accept)",
 	"type": "module",
 	"license": "MIT",