@muzi3/herdr 0.1.4 → 0.2.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@muzi3/herdr",
-  "version": "0.1.4",
-  "description": "Herdr for pi: the herdr operate skill (control Herdr from inside a pane), the herdr-guide skill (teach a human to set up and troubleshoot Herdr), and the herdr-agent-state extension (report agent state to Herdr).",
+  "version": "0.2.1",
+  "description": "Herdr for pi: three independent extensions (agent + blocked state reporting, /pi-hot-restart, and the herdr_layout / herdr_pane / herdr_agent pane control tools forked from @ogulcancelik/pi-herdr) plus the herdr-guide skill.",
   "keywords": [
     "pi-package",
     "pi",
@@ -15,22 +15,29 @@
     "troubleshooting",
     "agent-state",
     "pane",
-    "integration"
+    "pane-control",
+    "layout",
+    "fork"
   ],
-  "license": "Apache-2.0",
+  "license": "Apache-2.0 AND MIT",
+  "type": "module",
   "pi": {
     "extensions": [
-      "./extensions/index.ts",
-      "./extensions/pi-hot-restart.ts",
-      "./extensions/blocked-state.ts"
+      "./extensions/herdr-agent-state/index.ts",
+      "./extensions/pane-agent-tools/index.ts",
+      "./extensions/pi-hot-restart/index.ts"
     ],
     "skills": [
       "./skills"
     ]
   },
+  "scripts": {
+    "test": "node --test tests/"
+  },
   "files": [
     "extensions",
-    "skills"
+    "skills",
+    "LICENSE.MIT"
   ],
   "repository": {
     "type": "git",

package/extensions/blocked-state.ts

@@ -1,118 +0,0 @@
-/**
- * blocked-state
- *
- * 把 pi 的阻塞式交互提示转发成 herdr 的 blocked 状态。
- *
- * herdr 的 pi 集成（同目录 index.ts）只监听 `herdr:blocked` 事件再上报
- * `state: "blocked"`，而它内置的终端识别规则只有一条 working_literal（匹配
- * "Working..."），没有任何 blocked 规则 —— 没有这个桥，ask_user_question 期间
- * pane 一直显示 working，切到别的 pane 就看不出这个会话正等着人回话。
- *
- * 信号来源是 pi core 的 `ui_prompt_start` / `ui_prompt_end`：runner 统一包装了
- * select/confirm/input/editor/custom，只在外层提示触发，所以覆盖所有阻塞弹窗。
- * `custom` 不带 title，额外借 `rpiv:ask-user:prompt` 的问题内容补 label。
- *
- * herdr 侧的 blockedCount 是计数式的：切 label 前必须先发 `{active:false}` 降自己
- * 那一份再发 `{active:true}`。本扩展严格配对 raise/lower，只占一个计数。
- */
-
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-
-/** herdr pi 集成的入站事件通道（由 index.ts 消费）。 */
-const HERDR_BLOCKED_EVENT = "herdr:blocked";
-/** @juicesharp/rpiv-ask-user-question 的公开事件通道。 */
-const ASK_USER_PROMPT_EVENT = "rpiv:ask-user:prompt";
-
-/** 与 herdr 集成同一门槛：确认自己确实跑在 herdr 的 pane 里。 */
-const IN_HERDR = process.env.HERDR_ENV === "1" && !!process.env.HERDR_PANE_ID;
-const MAX_LABEL_CHARS = 60;
-const WAITING = "等待回答";
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-	return typeof value === "object" && value !== null;
-}
-
-/** label 是一行状态文字，换行/多空格先折叠掉。 */
-function flatten(text: string): string {
-	return text.replace(/\s+/g, " ").trim();
-}
-
-function truncate(text: string, max: number): string {
-	return text.length > max ? `${text.slice(0, max - 1)}…` : text;
-}
-
-/** 取第一条问题的 header（短）与原文（长）。 */
-function readQuestion(data: unknown): { header?: string; question?: string } | undefined {
-	if (!isRecord(data) || !Array.isArray(data.questions)) {
-		return undefined;
-	}
-	const first = data.questions.find(isRecord);
-	if (!first) {
-		return undefined;
-	}
-	const header = typeof first.header === "string" ? flatten(first.header) : "";
-	const question = typeof first.question === "string" ? flatten(first.question) : "";
-	if (!header && !question) {
-		return undefined;
-	}
-	return { header: header || undefined, question: question || undefined };
-}
-
-export default function (pi: ExtensionAPI) {
-	if (!IN_HERDR) {
-		return;
-	}
-
-	let rootSession = false;
-	let raised = false;
-	let raisedLabel: string | undefined;
-	let askUser: { header?: string; question?: string } | undefined;
-
-	function lower(): void {
-		if (!raised) return;
-		raised = false;
-		raisedLabel = undefined;
-		pi.events.emit(HERDR_BLOCKED_EVENT, { active: false });
-	}
-
-	function raise(detail: string | undefined): void {
-		const label = detail ? `${WAITING}：${truncate(detail, MAX_LABEL_CHARS)}` : WAITING;
-		if (raised && raisedLabel === label) return;
-		lower(); // 先降自己那一份再抬高，保证 label 切换时计数不残留
-		raised = true;
-		raisedLabel = label;
-		pi.events.emit(HERDR_BLOCKED_EVENT, { active: true, label });
-	}
-
-	pi.events.on(ASK_USER_PROMPT_EVENT, (data) => {
-		askUser = readQuestion(data);
-	});
-
-	pi.on("ui_prompt_start", (event) => {
-		if (!rootSession) return;
-		// custom 提示（ask_user_question 走这条）的 title 是空的，用问题内容补 label。
-		raise(event.kind === "custom" ? (askUser?.header ?? askUser?.question) : event.title);
-	});
-
-	pi.on("ui_prompt_end", () => {
-		askUser = undefined;
-		if (!rootSession) return;
-		lower();
-	});
-
-	pi.on("session_start", (_event, ctx) => {
-		// 与 herdr 集成同一门槛：RPC/print 没有可展示的 PTY；
-		// reload 会同时重载集成与本扩展，两侧计数一起归零。
-		if (ctx?.mode !== "tui") return;
-		rootSession = true;
-		raised = false;
-		raisedLabel = undefined;
-		askUser = undefined;
-	});
-
-	pi.on("session_shutdown", () => {
-		lower();
-		rootSession = false;
-		askUser = undefined;
-	});
-}

package/extensions/index.ts

@@ -1,257 +0,0 @@
-// installed by herdr
-// managed by herdr; reinstalling or updating the integration overwrites this file.
-// add custom hooks/plugins beside this file instead of editing it.
-// HERDR_INTEGRATION_ID=pi
-// HERDR_INTEGRATION_VERSION=8
-// @ts-nocheck
-
-import net from "node:net";
-
-const HERDR_ENV = process.env.HERDR_ENV;
-const socketPath = process.env.HERDR_SOCKET_PATH;
-const socketEndpoint =
-  process.platform === "win32" && socketPath ? `\\\\.\\pipe\\${socketPath}` : socketPath;
-const paneId = process.env.HERDR_PANE_ID;
-const source = "herdr:pi";
-
-function enabled() {
-  return HERDR_ENV === "1" && !!socketPath && !!paneId;
-}
-
-function sendRequestAttempt(request: unknown, timeoutMs: number): Promise<boolean> {
-  if (!enabled()) {
-    return Promise.resolve(true);
-  }
-
-  return new Promise((resolve) => {
-    let done = false;
-    let timeout: ReturnType<typeof setTimeout> | undefined;
-    const finish = (delivered: boolean) => {
-      if (done) return;
-      done = true;
-      if (timeout) {
-        clearTimeout(timeout);
-      }
-      socket.destroy();
-      resolve(delivered);
-    };
-
-    const socket = net.createConnection(socketEndpoint!);
-    socket.on("error", () => finish(false));
-    socket.on("connect", () => socket.write(`${JSON.stringify(request)}\n`));
-    socket.on("data", () => finish(true));
-    socket.on("end", () => finish(false));
-    timeout = setTimeout(() => finish(false), timeoutMs);
-    timeout.unref?.();
-  });
-}
-
-async function sendRequest(request: unknown): Promise<void> {
-  if (await sendRequestAttempt(request, 500)) {
-    return;
-  }
-  await sendRequestAttempt(request, 1500);
-}
-
-type AgentState = "working" | "blocked" | "idle";
-
-type QueuedState = {
-  state: AgentState;
-  message?: string;
-  seq: number;
-};
-
-let reportSeq = Date.now() * 1000;
-let currentAgentSessionId: string | undefined;
-let currentAgentSessionPath: string | undefined;
-
-function nextReportSeq(): number {
-  reportSeq += 1;
-  return reportSeq;
-}
-
-function updateSessionRef(ctx: any): void {
-  try {
-    const file = ctx?.sessionManager?.getSessionFile?.();
-    currentAgentSessionPath =
-      typeof file === "string" && file.startsWith("/") ? file : undefined;
-  } catch {
-    currentAgentSessionPath = undefined;
-  }
-
-  try {
-    const id = ctx?.sessionManager?.getSessionId?.();
-    currentAgentSessionId = typeof id === "string" && id.length > 0 ? id : undefined;
-  } catch {
-    currentAgentSessionId = undefined;
-  }
-}
-
-function withSessionRef(params: Record<string, unknown>): Record<string, unknown> {
-  if (currentAgentSessionPath) {
-    return { ...params, agent_session_path: currentAgentSessionPath };
-  }
-  if (currentAgentSessionId) {
-    return { ...params, agent_session_id: currentAgentSessionId };
-  }
-  return params;
-}
-
-function currentSessionRef(): Record<string, unknown> | undefined {
-  if (currentAgentSessionPath) {
-    return { agent_session_path: currentAgentSessionPath };
-  }
-  if (currentAgentSessionId) {
-    return { agent_session_id: currentAgentSessionId };
-  }
-  return undefined;
-}
-
-function reportSession(sessionStartSource?: string): Promise<void> {
-  const sessionRef = currentSessionRef();
-  if (!sessionRef) {
-    return Promise.resolve();
-  }
-
-  return sendRequest({
-    id: `${source}:session:${Date.now()}:${Math.random().toString(36).slice(2)}`,
-    method: "pane.report_agent_session",
-    params: {
-      pane_id: paneId,
-      source,
-      agent: "pi",
-      seq: nextReportSeq(),
-      session_start_source: sessionStartSource,
-      ...sessionRef,
-    },
-  });
-}
-
-function sendState(state: AgentState, message?: string, seq = nextReportSeq()): Promise<void> {
-  return sendRequest({
-    id: `${source}:${Date.now()}:${Math.random().toString(36).slice(2)}`,
-    method: "pane.report_agent",
-    params: withSessionRef({
-      pane_id: paneId,
-      source,
-      agent: "pi",
-      state,
-      message,
-      seq,
-    }),
-  });
-}
-
-let sendInFlight = false;
-let queuedState: QueuedState | undefined;
-
-function queueState(state: AgentState, message?: string): void {
-  queuedState = { state, message, seq: nextReportSeq() };
-  if (!sendInFlight) {
-    void drainStateQueue();
-  }
-}
-
-async function drainStateQueue(): Promise<void> {
-  if (sendInFlight) {
-    return;
-  }
-
-  sendInFlight = true;
-  try {
-    while (queuedState) {
-      const next = queuedState;
-      queuedState = undefined;
-      await sendState(next.state, next.message, next.seq);
-    }
-  } finally {
-    sendInFlight = false;
-    if (queuedState) {
-      void drainStateQueue();
-    }
-  }
-}
-
-export default function (pi) {
-  if (!enabled()) {
-    return;
-  }
-
-  let agentActive = false;
-  let blockedCount = 0;
-  let blockedMessage: string | undefined;
-  let lastState: AgentState | undefined;
-  let lastMessage: string | undefined;
-  let rootSession = false;
-
-  function desiredState() {
-    if (blockedCount > 0) {
-      return { state: "blocked" as const, message: blockedMessage };
-    }
-    if (agentActive) {
-      return { state: "working" as const, message: undefined };
-    }
-    return { state: "idle" as const, message: undefined };
-  }
-
-  function publishState(force = false) {
-    const next = desiredState();
-    if (!force && next.state === lastState && next.message === lastMessage) {
-      return;
-    }
-    lastState = next.state;
-    lastMessage = next.message;
-    queueState(next.state, next.message);
-  }
-
-  pi.events.on("herdr:blocked", (data) => {
-    if (!rootSession) {
-      return;
-    }
-    if (!data?.active) {
-      blockedCount = Math.max(0, blockedCount - 1);
-      if (blockedCount === 0) {
-        blockedMessage = undefined;
-      }
-      publishState();
-      return;
-    }
-
-    blockedCount += 1;
-    blockedMessage = data.label;
-    publishState();
-  });
-
-  pi.on("session_start", async (event, ctx) => {
-    // TUI only: RPC/JSON/print modes are headless (no PTY herdr can display),
-    // and RPC still reports hasUI=true, so mode is the reliable gate.
-    if (ctx?.mode !== "tui") {
-      return;
-    }
-    rootSession = true;
-    updateSessionRef(ctx);
-    await reportSession(event?.reason);
-    // A reload can replace this extension mid-run without emitting another agent_start.
-    agentActive = ctx?.isIdle?.() === false;
-    publishState(true);
-  });
-
-  pi.on("agent_start", (_event, ctx) => {
-    if (!rootSession) {
-      return;
-    }
-    updateSessionRef(ctx);
-    void reportSession();
-    agentActive = true;
-    publishState();
-  });
-
-  pi.on("agent_settled", (_event, ctx) => {
-    if (!rootSession || ctx?.isIdle?.() !== true) {
-      return;
-    }
-
-    agentActive = false;
-    publishState();
-  });
-}