pi-ui-extend 1.0.32 → 1.0.36

package/external/pi-tools-suite/src/tool-descriptions.ts

@@ -81,6 +81,7 @@ export function asyncSubagentToolDescriptions(options: ToolDescriptionSetOptions
 			].join(" "),
 			promptSnippet:
 				"For every browser-based visual QA, UI bug reproduction, or real-browser fix-verification request, immediately spawn subagentType='browser-qa' even for a single track and before inspecting files or checking prerequisites. The browser-qa sub-agent must discover the target and report missing prerequisites; do not preflight, perform, or substitute browser QA in the parent agent. " +
+				"Give browser-qa a concise acceptance brief: the known target URL/app, user-visible flow, expected observable result, and required artifacts. Do not prescribe repository files, searches, commands, server setup, or mock/synthetic substitutes; unknown setup belongs to the QA sub-agent's discovery. " +
 				"For other work, use subagents action='spawn' for multiple independent agents, explicit delegate/parallelize/split work requests, or one large review/debug track that should stay out of the parent context. " +
 				"Usually omit subagentType so the router chooses; set it only for user-named roles, deterministic tests, or another concrete override. Avoid trivial reads/edits and do not call status/wait immediately after spawn just for progress. " +
 				(repoDiscovery
@@ -88,6 +89,7 @@ export function asyncSubagentToolDescriptions(options: ToolDescriptionSetOptions
 					: "For one focused code-discovery question, use direct read/grep. Without repo_* tools, spawn several focused scan/quick agents first for broad multi-track discovery, incident triage, release readiness, risk strategy, or parallel reviews. Read result only after completion when findings are needed."),
 			promptGuidelines: [
 				"Treat every real-browser QA request as a mandatory delegation trigger and an explicit exception to the large/parallel threshold: immediately spawn with `subagentType: \"browser-qa\"` before checking prerequisites. The QA sub-agent owns target discovery, feasibility checks, browser automation, evidence, and blocked reports; the parent must not inspect the project first or substitute non-browser checks.",
+				"Keep the browser-qa task payload at the user-visible acceptance level: known target URL/app, actions to perform, expected observable outcome, and requested evidence. Do not turn it into a repository investigation plan, name internal files or commands, dictate server setup, or invent a mock/synthetic target. Leave unknown prerequisites to the QA sub-agent.",
 				"When browser-qa reports missing credentials, relay its explicit request and generated `.pi/qa_auth.jsonc` template path; never inspect, populate, or edit that credential file in the parent.",
 				"After browser-qa completes a test, preserve its clickable screenshot, video, and trace links in the final user-facing response whenever those artifacts exist.",
 				"For non-browser-QA work, use action='spawn' only for LARGE/PARALLEL work: independent investigations, repo-wide sweeps, deep debugging, code review/audit, or explicit delegate/parallelize/split requests; these are spawn triggers unless trivial/single-file.",
@@ -248,6 +250,46 @@ export const SESSION_NAME_TOOL_DESCRIPTION: ToolDescription = {
 	],
 };
 
+export const SESSION_RECOVERY_TOOL_DESCRIPTIONS = {
+	overview: {
+		name: "session_overview",
+		label: "Session Overview",
+		description: "Map raw persisted session history into stable, bounded sections. Defaults to the active branch and can include abandoned branches without applying context compaction.",
+		promptSnippet: "Map raw session history into stable sections before drilling into context lost to compaction.",
+		promptGuidelines: [
+			"Use session_overview first when task context was lost or compressed and no reliable search phrase is known; then inspect relevant section IDs.",
+		],
+	},
+	readSection: {
+		name: "session_read_section",
+		label: "Session Read Section",
+		description: "Read a bounded raw-history section returned by session_overview or session_search, including messages, tool calls/results, and compaction summaries.",
+		promptSnippet: "Read one stable raw-session section by ID after session_overview or session_search.",
+		promptGuidelines: [
+			"Pass a section ID produced with the same active/all scope; keep entry and body limits small unless more detail is necessary.",
+		],
+	},
+	search: {
+		name: "session_search",
+		label: "Session Search",
+		description: "Search raw session messages, summaries, tool results, and serialized tool arguments with a bounded literal substring query.",
+		promptSnippet: "Search raw session history lexically when a concrete phrase, path, symbol, tool, or error is known.",
+		promptGuidelines: [
+			"Use session_search after overview when a concrete query is known; it is lexical rather than semantic, and scope defaults to the active branch.",
+		],
+	},
+	recoveryContext: {
+		name: "session_recovery_context",
+		label: "Session Recovery Context (after overview)",
+		description: "Post-overview convenience tool for summarizing deterministic task signals: user requests, file activity, recent errors, pending tool calls, last action, and compaction references. When the task and search terms are unknown, call session_overview first instead of this tool.",
+		promptSnippet: "Use only after session_overview has mapped the raw history; verify details through section reads or search.",
+		promptGuidelines: [
+			"Do not use session_recovery_context as the first tool when the task and useful search terms are unknown; start with session_overview.",
+			"Use it as a convenience after the overview, but treat recentErrors as historical evidence and verify ambiguous state with session_read_section.",
+		],
+	},
+} satisfies Record<string, ToolDescription>;
+
 export const WEB_SEARCH_TOOL_DESCRIPTIONS = {
 	webSearch: {
 		name: "web_search",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-ui-extend",
-  "version": "1.0.32",
+  "version": "1.0.36",
   "description": "Pix: a workspace-first terminal UI for Pi with tabs, readable tool activity, voice input, and bundled agent tools.",
   "private": false,
   "repository": {
@@ -41,7 +41,9 @@
     "external/pi-tools-suite/src",
     "external/pi-tools-suite/docs",
     "external/pi-tools-suite/licenses",
-    "README.md"
+    "README.md",
+    "!**/__pycache__",
+    "!**/*.pyc"
   ],
   "scripts": {
     "predev": "npm run link:pix --silent",