@f5-sales-demo/xcsh 19.73.0 → 19.74.0

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5-sales-demo/xcsh",
-	"version": "19.73.0",
+	"version": "19.74.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.73.0",
-		"@f5-sales-demo/pi-agent-core": "19.73.0",
-		"@f5-sales-demo/pi-ai": "19.73.0",
-		"@f5-sales-demo/pi-natives": "19.73.0",
-		"@f5-sales-demo/pi-resource-management": "19.73.0",
-		"@f5-sales-demo/pi-tui": "19.73.0",
-		"@f5-sales-demo/pi-utils": "19.73.0",
+		"@f5-sales-demo/xcsh-stats": "19.74.0",
+		"@f5-sales-demo/pi-agent-core": "19.74.0",
+		"@f5-sales-demo/pi-ai": "19.74.0",
+		"@f5-sales-demo/pi-natives": "19.74.0",
+		"@f5-sales-demo/pi-resource-management": "19.74.0",
+		"@f5-sales-demo/pi-tui": "19.74.0",
+		"@f5-sales-demo/pi-utils": "19.74.0",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.20",

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

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "19.73.0",
-	"commit": "3f32c968ef8b2a0c9fabbc1be3fbe5c7395a7dc9",
-	"shortCommit": "3f32c96",
+	"version": "19.74.0",
+	"commit": "c6fc2dd6c16c816e5857edc7e892837405dead7a",
+	"shortCommit": "c6fc2dd",
 	"branch": "main",
-	"tag": "v19.73.0",
-	"commitDate": "2026-07-22T04:58:36Z",
-	"buildDate": "2026-07-22T05:24:54.248Z",
+	"tag": "v19.74.0",
+	"commitDate": "2026-07-22T05:55:19Z",
+	"buildDate": "2026-07-22T06:19:41.705Z",
 	"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/3f32c968ef8b2a0c9fabbc1be3fbe5c7395a7dc9",
-	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v19.73.0"
+	"commitUrl": "https://github.com/f5-sales-demo/xcsh/commit/c6fc2dd6c16c816e5857edc7e892837405dead7a",
+	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v19.74.0"
 };

package/src/prompts/system/system-prompt.md

@@ -306,6 +306,9 @@ Most tools resolve custom protocol URLs to internal resources (not web URLs):
   - `xcsh://console/<resource>` — console route pattern, menu path, and available operations.
   - `xcsh://console/<resource>/<operation>` — the exact ordered UI steps (selectors) for that operation.
 - `xcsh://extension` — Chrome extension bridge tool API reference: which tool to use (click, typeahead, input, navigation) for each automation task.
+{{#if hasPlugins}}
+Installed plugins expose capabilities, schemas, and executable helpers on demand. Read `xcsh://plugin` to list installed plugins and `xcsh://plugin/<name>` for a plugin's summary and how to go deeper — pull this in only when a task matches a plugin's domain.
+{{/if}}
 
 ### Presentation profile
 

package/src/system-prompt.plugin-pointer.test.ts

@@ -0,0 +1,38 @@
+import { beforeAll, describe, expect, test } from "bun:test";
+import * as path from "node:path";
+import { prompt } from "@f5-sales-demo/pi-utils";
+import { registerCodingAgentPromptHelpers } from "./config/prompt-templates";
+
+// L0 of the MEDDPICC progressive-hints ladder: a single framework-agnostic line
+// telling the agent that installed plugins expose capabilities/schemas via
+// `xcsh://plugin/<name>`. It is gated on the `hasPlugins` render variable that
+// `buildSystemPrompt` computes from discovered plugin roots.
+//
+// Seam: the Handlebars-compile path (`prompt.render(template, data)`) — the same
+// seam every other conditional-rendering assertion in this package uses. It is
+// deterministic (no dependency on what is installed under the real home dir) and
+// exercises the exact template conditional this task adds. `buildSystemPrompt`
+// resolves plugins from `os.homedir()` and takes no `home` override, so a
+// true-case fixture through it would be non-deterministic.
+
+const systemPromptPath = path.resolve(import.meta.dir, "prompts/system/system-prompt.md");
+
+describe("L0 plugin-capability pointer", () => {
+	beforeAll(() => {
+		registerCodingAgentPromptHelpers();
+	});
+
+	test("renders the generic pointer when a plugin is present, naming no plugin", async () => {
+		const template = await Bun.file(systemPromptPath).text();
+		const rendered = prompt.render(template, { hasPlugins: true });
+		expect(rendered).toContain("xcsh://plugin");
+		// Generic/reusable: it must not name any specific plugin.
+		expect(rendered).not.toContain("meddpicc");
+	});
+
+	test("omits the pointer entirely when no plugins are present", async () => {
+		const template = await Bun.file(systemPromptPath).text();
+		const rendered = prompt.render(template, { hasPlugins: false });
+		expect(rendered).not.toContain("xcsh://plugin");
+	});
+});

package/src/system-prompt.ts

@@ -13,6 +13,7 @@ import { systemPromptCapability } from "./capability/system-prompt";
 import type { SkillsSettings } from "./config/settings";
 import { renderDeprecationGuardrails } from "./deprecations";
 import { type ContextFile, loadCapability, type SystemPrompt as SystemPromptFile } from "./discovery";
+import { listXcshPluginRoots } from "./discovery/helpers";
 import { isApplicableToContext, loadSkills, type Skill } from "./extensibility/skills";
 import customSystemPromptTemplate from "./prompts/system/custom-system-prompt.md" with { type: "text" };
 import systemPromptTemplate from "./prompts/system/system-prompt.md" with { type: "text" };
@@ -555,6 +556,13 @@ export async function buildSystemPrompt(options: BuildSystemPromptOptions = {}):
 					? loadSkills({ ...mergedSkillsSettings, cwd: resolvedCwd }).then(result => result.skills)
 					: Promise.resolve([]);
 
+		// L0 plugin-capability pointer: gate a generic `xcsh://plugin` hint on ≥1
+		// discoverable plugin. Discovery is cached and reads one small registry file,
+		// so this is effectively free; it fails safe to `false` (no hint) on error.
+		const hasPluginsPromise: Promise<boolean> = listXcshPluginRoots(os.homedir(), resolvedCwd)
+			.then(result => result.roots.length > 0)
+			.catch(() => false);
+
 		return Promise.all([
 			resolvePromptInput(customPrompt, "system prompt"),
 			resolvePromptInput(appendSystemPrompt, "append system prompt"),
@@ -562,6 +570,7 @@ export async function buildSystemPrompt(options: BuildSystemPromptOptions = {}):
 			contextFilesPromise,
 			agentsMdSearchPromise,
 			skillsPromise,
+			hasPluginsPromise,
 		]).then(
 			([
 				resolvedCustomPrompt,
@@ -570,6 +579,7 @@ export async function buildSystemPrompt(options: BuildSystemPromptOptions = {}):
 				contextFiles,
 				agentsMdSearch,
 				skills,
+				hasPlugins,
 			]) => ({
 				resolvedCustomPrompt,
 				resolvedAppendPrompt,
@@ -577,6 +587,7 @@ export async function buildSystemPrompt(options: BuildSystemPromptOptions = {}):
 				contextFiles,
 				agentsMdSearch,
 				skills,
+				hasPlugins,
 			}),
 		);
 	})();
@@ -601,6 +612,7 @@ export async function buildSystemPrompt(options: BuildSystemPromptOptions = {}):
 		files: [],
 	};
 	let skills: Skill[] = providedSkills ?? [];
+	let hasPlugins = false;
 
 	if (prepResult.type === "timeout") {
 		logger.warn("System prompt preparation timed out; using minimal startup context", {
@@ -623,6 +635,7 @@ export async function buildSystemPrompt(options: BuildSystemPromptOptions = {}):
 		contextFiles = dedupeExactContextFiles(prepResult.value.contextFiles);
 		agentsMdSearch = prepResult.value.agentsMdSearch;
 		skills = prepResult.value.skills;
+		hasPlugins = prepResult.value.hasPlugins;
 	}
 
 	const date = new Date().toISOString().slice(0, 10);
@@ -679,6 +692,7 @@ export async function buildSystemPrompt(options: BuildSystemPromptOptions = {}):
 		agentsMdSearch,
 		skills: contextFilteredSkills,
 		rules: rules ?? [],
+		hasPlugins,
 		alwaysApplyRules: injectedAlwaysApplyRules,
 		date,
 		dateTime,