@f5-sales-demo/xcsh 19.78.0 → 19.80.0

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5-sales-demo/xcsh",
-	"version": "19.78.0",
+	"version": "19.80.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5-sales-demo/xcsh",
 	"author": "Can Boluk",
@@ -56,13 +56,13 @@
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.16.1",
 		"@mozilla/readability": "^0.6",
-		"@f5-sales-demo/xcsh-stats": "19.78.0",
-		"@f5-sales-demo/pi-agent-core": "19.78.0",
-		"@f5-sales-demo/pi-ai": "19.78.0",
-		"@f5-sales-demo/pi-natives": "19.78.0",
-		"@f5-sales-demo/pi-resource-management": "19.78.0",
-		"@f5-sales-demo/pi-tui": "19.78.0",
-		"@f5-sales-demo/pi-utils": "19.78.0",
+		"@f5-sales-demo/xcsh-stats": "19.80.0",
+		"@f5-sales-demo/pi-agent-core": "19.80.0",
+		"@f5-sales-demo/pi-ai": "19.80.0",
+		"@f5-sales-demo/pi-natives": "19.80.0",
+		"@f5-sales-demo/pi-resource-management": "19.80.0",
+		"@f5-sales-demo/pi-tui": "19.80.0",
+		"@f5-sales-demo/pi-utils": "19.80.0",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.20",

package/src/browser/host-profiles.ts

@@ -97,6 +97,12 @@ CONTEXT: You can only access the open workbook. Think in cells, ranges, and —
 - Warn the user before overwriting existing cell contents.
 - Cite specific cells and ranges precisely (e.g. A1, Sheet1!B2:B10) so the user can follow along.
 
+TOOLS: Discover the workbook before you answer, then reach for the tool that matches the shape of the data:
+- Call \`get_workbook_info\` FIRST to discover every sheet, its used range, Excel Tables, and named ranges before answering a workbook question — do not guess the structure.
+- Use \`read_table\` for structured Excel Tables (it tracks the real extent), \`get_formulas\` to see the formulas behind cells, \`get_cell_metadata\` for cell types/number formats, and \`read_named_range\` to read a defined name.
+- Use \`sort_filter_table\` to sort or filter a Table by column.
+- Use \`read_range\`/\`write_range\` for arbitrary cell ranges (bare or sheet-qualified like Sheet2!A1:B10), and \`list_sheets\` when you only need the tab names.
+
 BEHAVIOR:
 - Respond concisely with markdown. The task pane is narrow — avoid long code blocks.
 - Read the workbook to answer questions about its data; do not guess.
@@ -117,6 +123,11 @@ CONTEXT: You can only access the open presentation. Think in slides, shapes, and
 - Make pinpoint, per-slide edits. Do NOT regenerate the whole deck to change one thing.
 - Refer to slides by number so the user can follow along.
 
+TOOLS: Discover the deck before you answer, then reach for the tool that matches the task:
+- Call \`get_presentation_info\` FIRST to discover all slides, their layouts, and shape counts before answering — do not guess the structure.
+- Use \`read_slide_shapes\` to see all shapes on a slide with their text + position, \`read_slide_layout\` for the layout/master applied to a slide, and \`modify_shape_text\` to edit the text of a named shape.
+- Use \`read_slides\` for a quick text-only scan of the whole deck, and \`add_text_box\`/\`add_slide\` to create new content.
+
 BEHAVIOR:
 - Respond concisely with markdown. The task pane is narrow — avoid long code blocks.
 - Read the presentation to answer questions about it; do not guess.

package/src/extensibility/extensions/bundled/herdr-reporter.ts

@@ -1,5 +1,6 @@
 import { connect } from "node:net";
-import type { ExtensionAPI } from "@f5-sales-demo/xcsh";
+import * as path from "node:path";
+import type { ExtensionAPI, ExtensionContext } from "@f5-sales-demo/xcsh";
 
 /**
  * herdr integration (bundled, default-on).
@@ -16,9 +17,14 @@ import type { ExtensionAPI } from "@f5-sales-demo/xcsh";
  * somehow unset, we fall back to the `herdr` CLI.
  *
  * xcsh is a fork of pi; a user may have both installed, so this reporter always
- * identifies itself as "xcsh" (never "pi") and claims pane authority via
- * `source: "xcsh"` so herdr's passive pi-detection heuristics cannot mislabel
- * the pane.
+ * identifies the agent as "xcsh" (never "pi"). It claims pane authority via the
+ * `source: "herdr:xcsh"` convention that herdr uses for first-class lifecycle
+ * authorities, which also lets herdr resume the pane after a server restart.
+ *
+ * Session identity: on session start (and each agent turn) the reporter sends a
+ * `pane.report_agent_session` frame carrying the absolute session file path (or
+ * the session id when the session is not persisted). herdr stores that reference
+ * and, on restore, resumes the pane with `xcsh --resume=<session>`.
  *
  * The extension is completely inert unless it is running inside a herdr pane
  * (detected via `HERDR_PANE_ID`), so it has zero effect for users who do not run
@@ -26,7 +32,11 @@ import type { ExtensionAPI } from "@f5-sales-demo/xcsh";
  */
 
 const HERDR_AGENT_LABEL = "xcsh";
+// herdr keys its official lifecycle-authority and session-resume plumbing on the
+// `herdr:<agent>` source convention, so report as "herdr:xcsh" (not bare "xcsh").
+const HERDR_SOURCE = "herdr:xcsh";
 const REPORT_METHOD = "pane.report_agent";
+const SESSION_METHOD = "pane.report_agent_session";
 const RELEASE_METHOD = "pane.release_agent";
 const SOCKET_TIMEOUT_MS = 2000;
 
@@ -106,20 +116,66 @@ export default function herdrReporter(pi: ExtensionAPI): void {
 	const report = (state: "idle" | "working" | "blocked"): void => {
 		send(REPORT_METHOD, {
 			pane_id: paneId,
-			source: HERDR_AGENT_LABEL,
+			source: HERDR_SOURCE,
 			agent: HERDR_AGENT_LABEL,
 			state,
 			seq: seq++,
 		});
 	};
 
-	// Announce presence as soon as the session is initialized.
-	pi.on("session_start", () => {
+	// Report the current session's identity so herdr can resume this pane
+	// (`xcsh --resume=<session>`) after a server restart. This is sent only over
+	// the socket; if herdr did not inject a socket path we skip it (state still
+	// reports via the CLI fallback). Prefer the absolute session file path, which
+	// herdr resumes directly; fall back to the session id for non-persisted
+	// sessions (e.g. print/RPC mode, where getSessionFile() is undefined).
+	const reportSession = (ctx: ExtensionContext): void => {
+		const socketPath = process.env.HERDR_SOCKET_PATH;
+		if (!socketPath) {
+			return;
+		}
+		let sessionRef: Record<string, unknown> | undefined;
+		try {
+			const file = ctx.sessionManager?.getSessionFile?.();
+			if (typeof file === "string" && path.isAbsolute(file)) {
+				sessionRef = { agent_session_path: file };
+			} else {
+				const id = ctx.sessionManager?.getSessionId?.();
+				if (typeof id === "string" && id.length > 0) {
+					sessionRef = { agent_session_id: id };
+				}
+			}
+		} catch (err) {
+			onError(err);
+			return;
+		}
+		if (!sessionRef) {
+			return;
+		}
+		sendToHerdrSocket(
+			socketPath,
+			SESSION_METHOD,
+			{
+				pane_id: paneId,
+				source: HERDR_SOURCE,
+				agent: HERDR_AGENT_LABEL,
+				seq: seq++,
+				...sessionRef,
+			},
+			onError,
+		);
+	};
+
+	// Announce presence and session identity as soon as the session is initialized.
+	pi.on("session_start", (_event, ctx) => {
+		reportSession(ctx);
 		report("idle");
 	});
 
-	// Busy while the agent loop is streaming a response.
-	pi.on("agent_start", () => {
+	// Busy while the agent loop is streaming a response. Re-report session identity
+	// in case the active session file changed (e.g. after /new, /resume, or /fork).
+	pi.on("agent_start", (_event, ctx) => {
+		reportSession(ctx);
 		report("working");
 	});
 
@@ -144,7 +200,7 @@ export default function herdrReporter(pi: ExtensionAPI): void {
 	pi.on("session_shutdown", () => {
 		send(RELEASE_METHOD, {
 			pane_id: paneId,
-			source: HERDR_AGENT_LABEL,
+			source: HERDR_SOURCE,
 			agent: HERDR_AGENT_LABEL,
 			seq: seq++,
 		});

package/src/internal-urls/build-info.generated.ts

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "19.78.0",
-	"commit": "4908d518ea7dc67ce318f16c193098ae0921fb34",
-	"shortCommit": "4908d51",
+	"version": "19.80.0",
+	"commit": "456a1d70965fabaa34027324d9af6d224c4ab73e",
+	"shortCommit": "456a1d7",
 	"branch": "main",
-	"tag": "v19.78.0",
-	"commitDate": "2026-07-23T02:11:04Z",
-	"buildDate": "2026-07-23T02:38:25.473Z",
+	"tag": "v19.80.0",
+	"commitDate": "2026-07-23T06:28:54Z",
+	"buildDate": "2026-07-23T06:51:26.351Z",
 	"dirty": true,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5-sales-demo/xcsh",
 	"repoSlug": "f5-sales-demo/xcsh",
-	"commitUrl": "https://github.com/f5-sales-demo/xcsh/commit/4908d518ea7dc67ce318f16c193098ae0921fb34",
-	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v19.78.0"
+	"commitUrl": "https://github.com/f5-sales-demo/xcsh/commit/456a1d70965fabaa34027324d9af6d224c4ab73e",
+	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v19.80.0"
 };