@f5xc-salesdemos/xcsh 19.29.5 → 19.30.1

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5xc-salesdemos/xcsh",
-	"version": "19.29.5",
+	"version": "19.30.1",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5xc-salesdemos/xcsh",
 	"author": "Can Boluk",
@@ -50,12 +50,13 @@
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.16.1",
 		"@mozilla/readability": "^0.6",
-		"@f5xc-salesdemos/xcsh-stats": "19.29.5",
-		"@f5xc-salesdemos/pi-agent-core": "19.29.5",
-		"@f5xc-salesdemos/pi-ai": "19.29.5",
-		"@f5xc-salesdemos/pi-natives": "19.29.5",
-		"@f5xc-salesdemos/pi-tui": "19.29.5",
-		"@f5xc-salesdemos/pi-utils": "19.29.5",
+		"@f5xc-salesdemos/xcsh-stats": "19.30.1",
+		"@f5xc-salesdemos/pi-agent-core": "19.30.1",
+		"@f5xc-salesdemos/pi-ai": "19.30.1",
+		"@f5xc-salesdemos/pi-natives": "19.30.1",
+		"@f5xc-salesdemos/pi-resource-management": "19.30.1",
+		"@f5xc-salesdemos/pi-tui": "19.30.1",
+		"@f5xc-salesdemos/pi-utils": "19.30.1",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.20",
@@ -67,6 +68,7 @@
 		"lru-cache": "11.3.1",
 		"markit-ai": "0.5.0",
 		"puppeteer": "^24.37",
+		"yaml": "2.9.0",
 		"zod": "4.3.6"
 	},
 	"devDependencies": {

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

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "19.29.5",
-	"commit": "01fdddd1aa0fe33bc912d65cd02a4bf36bd51c57",
-	"shortCommit": "01fdddd",
+	"version": "19.30.1",
+	"commit": "b1150372a182f6653cf5a62a53edb7d1c04c277a",
+	"shortCommit": "b115037",
 	"branch": "main",
-	"tag": "v19.29.5",
-	"commitDate": "2026-06-14T14:50:32Z",
-	"buildDate": "2026-06-14T15:12:53.627Z",
+	"tag": "v19.30.1",
+	"commitDate": "2026-06-14T23:46:38Z",
+	"buildDate": "2026-06-15T00:08:14.358Z",
 	"dirty": true,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5xc-salesdemos/xcsh",
 	"repoSlug": "f5xc-salesdemos/xcsh",
-	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/01fdddd1aa0fe33bc912d65cd02a4bf36bd51c57",
-	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v19.29.5"
+	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/b1150372a182f6653cf5a62a53edb7d1c04c277a",
+	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v19.30.1"
 };

package/src/resource-management/index.ts

@@ -0,0 +1,42 @@
+import { createKindResolver } from "@f5xc-salesdemos/pi-resource-management";
+import { API_SPEC_INDEX, API_VALIDATION_DATA } from "../internal-urls/api-spec-index.generated";
+
+export const kindResolver = createKindResolver(API_SPEC_INDEX, API_VALIDATION_DATA);
+
+export type {
+	ApiSpecDomainEntry,
+	ApiSpecDomainResource,
+	ApiSpecIndex,
+	ApiSpecValidationResourceEntry,
+	DiffEntry,
+	KindResolver,
+	ManifestValidationResult,
+	OperationResult,
+	ParsedResourceArgs,
+	ResolvedKind,
+	ResourceClientOptions,
+	ResourceDiff,
+	ResourceError,
+	ResourceManifest,
+	ValidationError,
+	ValidationWarning,
+} from "@f5xc-salesdemos/pi-resource-management";
+export {
+	computeResourceDiff,
+	createKindResolver,
+	formatDiff,
+	formatMultiOperationSummary,
+	formatOperationResult,
+	formatResourceDetail,
+	formatResourceList,
+	formatValidationErrors,
+	KindResolutionError,
+	ManifestFileError,
+	ManifestParseError,
+	parseManifests,
+	parseResourceArgs,
+	ResourceClient,
+	readManifestFiles,
+	validateManifest,
+	validateManifests,
+} from "@f5xc-salesdemos/pi-resource-management";

package/src/slash-commands/builtin-registry.ts

@@ -1382,6 +1382,99 @@ const BUILTIN_SLASH_COMMAND_REGISTRY: ReadonlyArray<BuiltinSlashCommandSpec> = [
 		description: t("commands.quit.description"),
 		handle: shutdownHandler,
 	},
+	{
+		name: "apply",
+		description: "Apply a configuration to a resource from a file (create or update)",
+		inlineHint: "-f <file.json|file.yaml> [-n namespace] [--dry-run=client|server]",
+		allowArgs: true,
+		getArgumentCompletions(_prefix: string) {
+			return null;
+		},
+		handle: async (command, runtime) => {
+			const { handleResourceCommand } = await import("./resource-commands");
+			await handleResourceCommand("apply", command, runtime.ctx);
+		},
+	},
+	{
+		name: "create",
+		description: "Create a resource from a file (fail if exists)",
+		inlineHint: "-f <file.json|file.yaml> [-n namespace] [--dry-run=client|server]",
+		allowArgs: true,
+		getArgumentCompletions(_prefix: string) {
+			return null;
+		},
+		handle: async (command, runtime) => {
+			const { handleResourceCommand } = await import("./resource-commands");
+			await handleResourceCommand("create", command, runtime.ctx);
+		},
+	},
+	{
+		name: "delete",
+		description: "Delete a resource by file or by kind and name",
+		inlineHint: "<kind> <name> | -f <file> [-n namespace] [--force]",
+		allowArgs: true,
+		getArgumentCompletions(prefix: string) {
+			try {
+				const { getKindCompletions } = require("./resource-commands") as typeof import("./resource-commands");
+				return getKindCompletions(prefix);
+			} catch {
+				return null;
+			}
+		},
+		handle: async (command, runtime) => {
+			const { handleResourceCommand } = await import("./resource-commands");
+			await handleResourceCommand("delete", command, runtime.ctx);
+		},
+	},
+	{
+		name: "describe",
+		description: "Show detailed information about a resource",
+		inlineHint: "<kind> <name> [-n namespace] [-o json|yaml]",
+		allowArgs: true,
+		getArgumentCompletions(prefix: string) {
+			try {
+				const { getKindCompletions } = require("./resource-commands") as typeof import("./resource-commands");
+				return getKindCompletions(prefix);
+			} catch {
+				return null;
+			}
+		},
+		handle: async (command, runtime) => {
+			const { handleResourceCommand } = await import("./resource-commands");
+			await handleResourceCommand("describe", command, runtime.ctx);
+		},
+	},
+	{
+		name: "diff",
+		description: "Preview what changes would be applied from a file",
+		inlineHint: "-f <file.json|file.yaml> [-n namespace]",
+		allowArgs: true,
+		getArgumentCompletions(_prefix: string) {
+			return null;
+		},
+		handle: async (command, runtime) => {
+			const { handleResourceCommand } = await import("./resource-commands");
+			await handleResourceCommand("diff", command, runtime.ctx);
+		},
+	},
+	{
+		name: "get",
+		description: "List or fetch F5 XC resources",
+		inlineHint: "<kind> [name] [-n namespace] [-o json|yaml|table]",
+		allowArgs: true,
+		getArgumentCompletions(prefix: string) {
+			try {
+				const { getKindCompletions } = require("./resource-commands") as typeof import("./resource-commands");
+				return getKindCompletions(prefix);
+			} catch {
+				return null;
+			}
+		},
+		handle: async (command, runtime) => {
+			const { handleResourceCommand } = await import("./resource-commands");
+			await handleResourceCommand("get", command, runtime.ctx);
+		},
+	},
 	{
 		name: "context",
 		description: t("commands.context.description"),

package/src/slash-commands/resource-commands.ts

@@ -0,0 +1,258 @@
+import type { AutocompleteItem } from "@f5xc-salesdemos/pi-tui";
+import type { InteractiveModeContext } from "../modes/types";
+
+interface ParsedBuiltinSlashCommand {
+	name: string;
+	args: string;
+	text: string;
+}
+
+function getKindCompletions(prefix: string): AutocompleteItem[] | null {
+	try {
+		const { kindResolver } = require("../resource-management/index") as typeof import("../resource-management/index");
+		const kinds = kindResolver.getKindsWithApiPaths();
+		const lower = prefix.toLowerCase();
+		const items = kinds
+			.filter(k => k.toLowerCase().startsWith(lower))
+			.slice(0, 20)
+			.map(k => ({ value: `${k} `, label: k }));
+		return items.length > 0 ? items : null;
+	} catch {
+		return null;
+	}
+}
+
+export async function handleResourceCommand(
+	commandName: string,
+	command: ParsedBuiltinSlashCommand,
+	ctx: InteractiveModeContext,
+): Promise<void> {
+	ctx.editor.addToHistory(command.text);
+	ctx.editor.setText("");
+
+	const {
+		parseResourceArgs,
+		ResourceClient,
+		readManifestFiles,
+		ManifestFileError,
+		parseManifests,
+		ManifestParseError,
+		KindResolutionError,
+		validateManifest,
+		formatValidationErrors,
+		formatOperationResult,
+		formatResourceList,
+		formatResourceDetail,
+		formatMultiOperationSummary,
+		formatDiff,
+	} = await import("@f5xc-salesdemos/pi-resource-management");
+	const { kindResolver } = await import("../resource-management/index");
+
+	const parsed = parseResourceArgs(command.args);
+	if ("error" in parsed) {
+		ctx.showStatus(parsed.error);
+		return;
+	}
+
+	const { ContextService } = await import("../services/f5xc-context");
+	const { createContextEnv } = await import("../services/context-env");
+	const { settings } = await import("../config/settings");
+
+	let svc: typeof ContextService.prototype;
+	try {
+		svc = ContextService.instance;
+	} catch {
+		ctx.showStatus("No F5 XC context active. Run /context create to configure one first.");
+		return;
+	}
+
+	const status = svc.getStatus();
+	if (!status.isConfigured) {
+		ctx.showStatus("No F5 XC context active. Run /context create to configure one first.");
+		return;
+	}
+
+	const contextEnv = createContextEnv(settings);
+	const apiUrl = contextEnv.get("F5XC_API_URL");
+	const apiToken = contextEnv.get("F5XC_API_TOKEN");
+	const defaultNamespace = contextEnv.get("F5XC_NAMESPACE") ?? "";
+
+	if (!apiUrl || !apiToken) {
+		ctx.showStatus("Missing API credentials. Check your context configuration.");
+		return;
+	}
+
+	const client = new ResourceClient({
+		apiUrl,
+		apiToken,
+		namespace: parsed.namespace ?? defaultNamespace,
+		resolvePayloadVars: (json: string) => contextEnv.resolvePayloadVars(json),
+	});
+
+	const ns = parsed.namespace ?? defaultNamespace;
+
+	try {
+		switch (commandName) {
+			case "apply":
+			case "create": {
+				if (parsed.filenames.length === 0) {
+					ctx.showStatus(
+						`Usage: /${commandName} -f <file.json|file.yaml|dir/> [-n namespace] [--dry-run=client|server]`,
+					);
+					return;
+				}
+				const fileResults = await readManifestFiles(parsed.filenames, parsed.recursive);
+				const allObjects = fileResults.flatMap(r => r.objects);
+				if (allObjects.length === 0) {
+					ctx.showStatus("No resources found in the specified file(s).");
+					return;
+				}
+				const manifests = parseManifests(allObjects, fileResults[0]?.sourcePath ?? "input");
+				const results = [];
+				for (const manifest of manifests) {
+					const { result: valResult, resolved } = validateManifest(manifest, kindResolver, ns);
+					if (!valResult.valid) {
+						ctx.showStatus(formatValidationErrors(manifest, valResult));
+						results.push({
+							status: "error" as const,
+							error: { kind: "validation" as const, message: "Validation failed" },
+						});
+						continue;
+					}
+					if (!resolved) continue;
+
+					if (parsed.dryRun === "client") {
+						results.push({ status: "dry-run" as const, action: "create" as const });
+						ctx.showStatus(
+							formatOperationResult({ status: "dry-run", action: "create" }, manifest, parsed.outputFormat),
+						);
+						continue;
+					}
+
+					const opResult =
+						commandName === "apply"
+							? await client.apply(manifest, resolved, ns, parsed.dryRun)
+							: await client.create(manifest, resolved, ns, parsed.dryRun);
+
+					results.push(opResult);
+					ctx.showStatus(formatOperationResult(opResult, manifest, parsed.outputFormat));
+				}
+
+				if (manifests.length > 1) {
+					ctx.showStatus(formatMultiOperationSummary(results as any, manifests));
+				}
+				break;
+			}
+
+			case "delete": {
+				let deleteTargets: { kind: string; name: string }[] = [];
+
+				if (parsed.filenames.length > 0) {
+					const fileResults = await readManifestFiles(parsed.filenames, parsed.recursive);
+					const allObjects = fileResults.flatMap(r => r.objects);
+					const manifests = parseManifests(allObjects, fileResults[0]?.sourcePath ?? "input");
+					deleteTargets = manifests.map(m => ({ kind: m.kind, name: m.metadata.name }));
+				} else if (parsed.kind && parsed.name) {
+					deleteTargets = [{ kind: parsed.kind, name: parsed.name }];
+				} else {
+					ctx.showStatus("Usage: /delete -f <file> or /delete <kind> <name> [-n namespace] [--force]");
+					return;
+				}
+
+				for (const target of deleteTargets) {
+					const resolved = kindResolver.resolveKind(target.kind);
+					const result = await client.delete(target.kind, target.name, resolved, ns);
+					ctx.showStatus(
+						formatOperationResult(
+							result,
+							{ kind: target.kind, metadata: { name: target.name }, spec: {}, rawObject: {} } as any,
+							parsed.outputFormat,
+						),
+					);
+				}
+				break;
+			}
+
+			case "describe": {
+				if (!parsed.kind) {
+					ctx.showStatus("Usage: /describe <kind> <name> [-n namespace] [-o json|yaml]");
+					return;
+				}
+				const kind = parsed.kind;
+				const name = parsed.name;
+				if (!name) {
+					ctx.showStatus("Usage: /describe <kind> <name> [-n namespace] [-o json|yaml]");
+					return;
+				}
+				const resolved = kindResolver.resolveKind(kind);
+				const result = await client.get(resolved, name, ns);
+				if (result.error) {
+					ctx.showStatus(`Error: ${result.error.message}`);
+					return;
+				}
+				if (result.resource) {
+					ctx.showStatus(formatResourceDetail(result.resource, kind, parsed.outputFormat));
+				}
+				break;
+			}
+
+			case "diff": {
+				if (parsed.filenames.length === 0) {
+					ctx.showStatus("Usage: /diff -f <file.json|file.yaml> [-n namespace]");
+					return;
+				}
+				const fileResults = await readManifestFiles(parsed.filenames, parsed.recursive);
+				const allObjects = fileResults.flatMap(r => r.objects);
+				const manifests = parseManifests(allObjects, fileResults[0]?.sourcePath ?? "input");
+
+				for (const manifest of manifests) {
+					const { resolved } = validateManifest(manifest, kindResolver, ns);
+					if (!resolved) {
+						ctx.showStatus(`Unknown kind: "${manifest.kind}"`);
+						continue;
+					}
+					const diffResult = await client.diff(manifest, resolved, ns);
+					if (diffResult.error) {
+						ctx.showStatus(`Error: ${diffResult.error.message}`);
+						continue;
+					}
+					if (diffResult.isNew) {
+						ctx.showStatus(`${manifest.kind}/${manifest.metadata.name} does not exist yet — will be created.`);
+						continue;
+					}
+					if (diffResult.diff) {
+						ctx.showStatus(formatDiff(diffResult.diff, manifest.kind, manifest.metadata.name));
+					}
+				}
+				break;
+			}
+
+			case "get": {
+				if (!parsed.kind) {
+					ctx.showStatus("Usage: /get <kind> [name] [-n namespace] [-o json|yaml|table]");
+					return;
+				}
+				const resolved = kindResolver.resolveKind(parsed.kind);
+				const result = await client.get(resolved, parsed.name, ns);
+				if (result.error) {
+					ctx.showStatus(`Error: ${result.error.message}`);
+					return;
+				}
+				if (result.items) {
+					ctx.showStatus(formatResourceList(result.items, parsed.kind, parsed.outputFormat));
+				} else if (result.resource) {
+					ctx.showStatus(formatResourceDetail(result.resource, parsed.kind, parsed.outputFormat));
+				}
+				break;
+			}
+		}
+	} catch (err) {
+		if (err instanceof ManifestFileError || err instanceof ManifestParseError || err instanceof KindResolutionError) {
+			ctx.showStatus(`Error: ${err.message}`);
+		} else {
+			ctx.showStatus(`Unexpected error: ${(err as Error).message}`);
+		}
+	}
+}
+
+export { getKindCompletions };