@f5-sales-demo/xcsh 21.47.3 → 21.49.2

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5-sales-demo/xcsh",
-	"version": "21.47.3",
+	"version": "21.49.2",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5-sales-demo/xcsh",
 	"author": "Can Boluk",
@@ -32,7 +32,7 @@
 	},
 	"scripts": {
 		"prebuild": "bun ../../scripts/check-installed-dependencies.ts",
-		"build": "bun run generate-build-info && bun run generate-extension-capabilities && bun run generate-api-catalog-qmd-index && test -f src/internal-urls/api-spec-index.generated.ts && bun --cwd=../stats scripts/generate-client-bundle.ts --generate && bun --cwd=../office-pane scripts/generate-client-bundle.ts --generate && bun --cwd=../natives run embed:native && bun scripts/build-binary.ts && bun --cwd=../natives run embed:native --reset && bun --cwd=../stats scripts/generate-client-bundle.ts --reset && bun --cwd=../office-pane scripts/generate-client-bundle.ts --reset",
+		"build": "bun scripts/build-package.ts",
 		"precheck": "bun ../../scripts/check-installed-dependencies.ts",
 		"check": "biome check . && bun run format-prompts -- --check && bun run audit:tui-readability && bun run check:types",
 		"audit:tui-readability": "bun scripts/audit-tui-readability.ts --check",
@@ -53,6 +53,7 @@
 		"generate-docs-index": "bun scripts/generate-docs-index.ts",
 		"generate-api-spec-index": "bun scripts/generate-api-spec-index.ts",
 		"generate-api-catalog-qmd-index": "bun scripts/generate-api-catalog-qmd-index.ts",
+		"generate-documentation-index": "bun scripts/generate-documentation-index.ts",
 		"generate-branding-index": "bun scripts/generate-branding-index.ts",
 		"generate-sitecli-index": "bun scripts/generate-sitecli-index.ts",
 		"generate-build-info": "bun scripts/generate-build-info.ts",
@@ -66,16 +67,16 @@
 	},
 	"dependencies": {
 		"@agentclientprotocol/sdk": "1.4.0",
-		"@f5-sales-demo/pi-agent-core": "21.47.3",
-		"@f5-sales-demo/pi-ai": "21.47.3",
-		"@f5-sales-demo/pi-natives": "21.47.3",
-		"@f5-sales-demo/pi-resource-management": "21.47.3",
-		"@f5-sales-demo/pi-tui": "21.47.3",
-		"@f5-sales-demo/pi-utils": "21.47.3",
-		"@f5-sales-demo/xcsh-stats": "21.47.3",
+		"@f5-sales-demo/pi-agent-core": "21.49.2",
+		"@f5-sales-demo/pi-ai": "21.49.2",
+		"@f5-sales-demo/pi-natives": "21.49.2",
+		"@f5-sales-demo/pi-resource-management": "21.49.2",
+		"@f5-sales-demo/pi-tui": "21.49.2",
+		"@f5-sales-demo/pi-utils": "21.49.2",
+		"@f5-sales-demo/xcsh-stats": "21.49.2",
 		"@mozilla/readability": "^0.6",
+		"@resvg/resvg-wasm": "2.6.2",
 		"@sinclair/typebox": "0.34.52",
-		"@tobilu/qmd": "2.8.3",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.20",
 		"chalk": "6.0.0",
@@ -86,10 +87,13 @@
 		"lru-cache": "11.5.2",
 		"markit-ai": "0.5.3",
 		"puppeteer": "25.10.0",
+		"tar-stream": "3.1.7",
 		"yaml": "2.9.0"
 	},
 	"devDependencies": {
 		"@types/bun": "1.4.2",
+		"@types/tar-stream": "3.1.4",
+		"@tobilu/qmd": "2.8.3",
 		"@xterm/addon-unicode11": "0.9.0",
 		"handlebars": "^4.7"
 	},

package/src/extensibility/extensions/bundled/native-lifecycle-control.ts

@@ -1,10 +1,27 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
 import { postmortem } from "@f5-sales-demo/pi-utils";
 import type { ExtensionAPI, ExtensionContext } from "@f5-sales-demo/xcsh";
 
 export const NATIVE_LIFECYCLE_CONTROL_FLAG = "--native-lifecycle-control";
 export const NATIVE_LIFECYCLE_CONTINUATION_TITLE = "Native lifecycle continuation";
+export const NATIVE_LIFECYCLE_CONTROL_VALUES = ["await_user_v1", "local_operation_failure_v1"] as const;
 
-type NativeLifecycleControl = "await-user";
+type NativeLifecycleControl = (typeof NATIVE_LIFECYCLE_CONTROL_VALUES)[number];
+
+/**
+ * Fatal only for the explicit local-operation acceptance control. Extension
+ * errors are normally isolated; the runner recognizes this type so the actual
+ * failed operation settles the ordinary AgentSession turn as failed.
+ */
+export class NativeLifecycleLocalOperationError extends Error {
+	readonly code = "ENOENT";
+
+	constructor(cause: Error) {
+		super("Native lifecycle owned local read failed with ENOENT", { cause });
+		this.name = "NativeLifecycleLocalOperationError";
+	}
+}
 
 let activeManagedCancellation: ((reason: string) => void) | undefined;
 
@@ -22,7 +39,23 @@ export function requestNativeLifecycleCancellation(reason: string): boolean {
 
 function configuredControl(pi: ExtensionAPI): NativeLifecycleControl | undefined {
 	const value = pi.getFlag(NATIVE_LIFECYCLE_CONTROL_FLAG);
-	return value === "await-user" ? value : undefined;
+	// Preserve the version-2 spelling for already published acceptance callers.
+	if (value === "await-user") return "await_user_v1";
+	return NATIVE_LIFECYCLE_CONTROL_VALUES.find(control => control === value);
+}
+
+async function failOwnedLocalOperation(cwd: string): Promise<never> {
+	const ownedDirectory = await fs.mkdtemp(path.join(cwd, ".xcsh-native-lifecycle-operation-"));
+	await fs.chmod(ownedDirectory, 0o700);
+	try {
+		await fs.readFile(path.join(ownedDirectory, "intentionally-missing"));
+		throw new Error("Native lifecycle missing-file read unexpectedly succeeded");
+	} catch (error) {
+		if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT") throw error;
+		throw new NativeLifecycleLocalOperationError(error);
+	} finally {
+		await fs.rm(ownedDirectory, { recursive: true, force: true });
+	}
 }
 
 /**
@@ -37,7 +70,7 @@ function configuredControl(pi: ExtensionAPI): NativeLifecycleControl | undefined
 export default function nativeLifecycleControl(pi: ExtensionAPI): void {
 	pi.registerFlag(NATIVE_LIFECYCLE_CONTROL_FLAG, {
 		type: "string",
-		description: "Acceptance-only native lifecycle control (supported: await-user)",
+		description: `Acceptance-only native lifecycle control (supported: ${NATIVE_LIFECYCLE_CONTROL_VALUES.join(", ")})`,
 	});
 
 	let activeController: AbortController | undefined;
@@ -50,10 +83,12 @@ export default function nativeLifecycleControl(pi: ExtensionAPI): void {
 	};
 
 	pi.on("before_agent_start", async (_event, ctx) => {
-		if (configuredControl(pi) !== "await-user") return;
+		const control = configuredControl(pi);
+		if (!control) return;
+		if (control === "local_operation_failure_v1") return failOwnedLocalOperation(ctx.cwd);
 		if (!ctx.hasUI) {
 			ctx.abort();
-			throw new Error("--native-lifecycle-control await-user requires interactive mode");
+			throw new Error("--native-lifecycle-control await_user_v1 requires interactive mode");
 		}
 
 		const controller = new AbortController();

package/src/extensibility/extensions/runner.ts

@@ -11,6 +11,7 @@ import type { IntegrationHandle } from "../../integrations/types";
 import { type Theme, theme } from "../../modes/theme/theme";
 import { personProfileService } from "../../person-profile/service";
 import type { SessionManager } from "../../session/session-manager";
+import { NativeLifecycleLocalOperationError } from "./bundled/native-lifecycle-control";
 import type {
 	BeforeAgentStartEvent,
 	BeforeAgentStartEventResult,
@@ -599,6 +600,7 @@ export class ExtensionRunner {
 						result = handlerResult as SessionCompactingResult;
 					}
 				} catch (err) {
+					if (err instanceof NativeLifecycleLocalOperationError) throw err;
 					const message = err instanceof Error ? err.message : String(err);
 					const stack = err instanceof Error ? err.stack : undefined;
 					this.emitError({