@f5xc-salesdemos/xcsh 19.30.3 → 19.31.0

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5xc-salesdemos/xcsh",
-	"version": "19.30.3",
+	"version": "19.31.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5xc-salesdemos/xcsh",
 	"author": "Can Boluk",
@@ -50,13 +50,13 @@
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.16.1",
 		"@mozilla/readability": "^0.6",
-		"@f5xc-salesdemos/xcsh-stats": "19.30.3",
-		"@f5xc-salesdemos/pi-agent-core": "19.30.3",
-		"@f5xc-salesdemos/pi-ai": "19.30.3",
-		"@f5xc-salesdemos/pi-natives": "19.30.3",
-		"@f5xc-salesdemos/pi-resource-management": "19.30.3",
-		"@f5xc-salesdemos/pi-tui": "19.30.3",
-		"@f5xc-salesdemos/pi-utils": "19.30.3",
+		"@f5xc-salesdemos/xcsh-stats": "19.31.0",
+		"@f5xc-salesdemos/pi-agent-core": "19.31.0",
+		"@f5xc-salesdemos/pi-ai": "19.31.0",
+		"@f5xc-salesdemos/pi-natives": "19.31.0",
+		"@f5xc-salesdemos/pi-resource-management": "19.31.0",
+		"@f5xc-salesdemos/pi-tui": "19.31.0",
+		"@f5xc-salesdemos/pi-utils": "19.31.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.30.3",
-	"commit": "09ac1c3ce47be3d522f797475f3aeb098f4eae6d",
-	"shortCommit": "09ac1c3",
+	"version": "19.31.0",
+	"commit": "f162b28f59b6db856a5c429de1dc9041767fc341",
+	"shortCommit": "f162b28",
 	"branch": "main",
-	"tag": "v19.30.3",
-	"commitDate": "2026-06-15T01:36:15Z",
-	"buildDate": "2026-06-15T02:01:00.865Z",
+	"tag": "v19.31.0",
+	"commitDate": "2026-06-15T02:42:18Z",
+	"buildDate": "2026-06-15T03:07:55.063Z",
 	"dirty": true,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5xc-salesdemos/xcsh",
 	"repoSlug": "f5xc-salesdemos/xcsh",
-	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/09ac1c3ce47be3d522f797475f3aeb098f4eae6d",
-	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v19.30.3"
+	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/f162b28f59b6db856a5c429de1dc9041767fc341",
+	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v19.31.0"
 };

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

@@ -185,6 +185,32 @@ Use these values when constructing API payloads and resource names.
 Available F5 XC documentation topics: {{knowledgeTopics}}.
 {{/if}}
 {{/if}}
+
+## Resource Manifest Format
+
+When a user asks you to write, export, or save a resource manifest, produce a clean `{kind, metadata, spec}` JSON file that is compatible with the `/apply` slash command.
+
+**Format:**
+```json
+{
+  "kind": "<resource_kind>",
+  "metadata": {
+    "name": "<resource_name>",
+    "namespace": "<namespace>"
+  },
+  "spec": { ... }
+}
+```
+
+**Rules:**
+- `kind` — the resource type in snake_case (e.g., `http_loadbalancer`, `origin_pool`, `app_firewall`)
+- `metadata` — include only: `name`, `namespace`, `labels`, `annotations`, `description`, `disable`
+- `spec` — include the full spec from the API response
+- **Exclude:** `system_metadata`, `status`, and any other server-managed fields
+- The output must round-trip through `/apply -f` without errors
+
+When fetching a resource from the API, strip the server-added metadata fields and inject the `kind` field (which the API response does not include). The `/manifest` slash command does this automatically.
+
 {{#if userProfile}}
 ## Primary Human
 

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

@@ -1475,6 +1475,24 @@ const BUILTIN_SLASH_COMMAND_REGISTRY: ReadonlyArray<BuiltinSlashCommandSpec> = [
 			await handleResourceCommand("get", command, runtime.ctx);
 		},
 	},
+	{
+		name: "manifest",
+		description: "Export live F5 XC resources as {kind, metadata, spec} manifest files",
+		inlineHint: "<kind> [name] [-n namespace] [-o json|yaml] [-f output-path] [--all]",
+		allowArgs: true,
+		getArgumentCompletions(prefix: string) {
+			try {
+				const { getExportKindCompletions } = require("./export-command") as typeof import("./export-command");
+				return getExportKindCompletions(prefix);
+			} catch {
+				return null;
+			}
+		},
+		handle: async (command, runtime) => {
+			const { handleExportResourceCommand } = await import("./export-command");
+			await handleExportResourceCommand(command, runtime.ctx);
+		},
+	},
 	{
 		name: "context",
 		description: t("commands.context.description"),

package/src/slash-commands/export-command.ts

@@ -0,0 +1,170 @@
+import type { AutocompleteItem } from "@f5xc-salesdemos/pi-tui";
+import type { InteractiveModeContext } from "../modes/types";
+
+interface ParsedBuiltinSlashCommand {
+	name: string;
+	args: string;
+	text: string;
+}
+
+function getExportKindCompletions(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 handleExportResourceCommand(
+	command: ParsedBuiltinSlashCommand,
+	ctx: InteractiveModeContext,
+): Promise<void> {
+	ctx.editor.addToHistory(command.text);
+	ctx.editor.setText("");
+
+	const { parseExportArgs, ResourceClient, KindResolutionError, toManifest, formatManifestOutput } = await import(
+		"@f5xc-salesdemos/pi-resource-management"
+	);
+	const { kindResolver } = await import("../resource-management/index");
+
+	const parsed = parseExportArgs(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 ns = parsed.namespace ?? defaultNamespace;
+	const client = new ResourceClient({
+		apiUrl,
+		apiToken,
+		namespace: ns,
+	});
+
+	if (parsed.outputFormat === "hcl") {
+		ctx.showStatus(
+			'HCL export requires AI-assisted transformation. Use a conversational request instead:\n  "Export my-lb as Terraform HCL"',
+		);
+		return;
+	}
+
+	const fmt = parsed.outputFormat as "json" | "yaml";
+
+	try {
+		const manifests: Array<{ kind: string; metadata: Record<string, unknown>; spec: Record<string, unknown> }> = [];
+
+		if (parsed.all) {
+			const result = await client.exportAll(kindResolver, ns, (kind, count) => {
+				ctx.showStatus(`Exporting ${kind} (${count} found)...`);
+			});
+
+			for (const err of result.errors) {
+				ctx.showStatus(`Warning: ${err.kind}: ${err.error.message}`);
+			}
+
+			manifests.push(...result.manifests);
+		} else if (parsed.kind && parsed.name) {
+			const resolved = kindResolver.resolveKind(parsed.kind);
+			const result = await client.exportOne(parsed.kind, resolved, parsed.name, ns);
+			if (result.error) {
+				ctx.showStatus(`Error: ${result.error.message}`);
+				return;
+			}
+			manifests.push(result.manifest!);
+		} else if (parsed.kind) {
+			const resolved = kindResolver.resolveKind(parsed.kind);
+			const getResult = await client.get(resolved, undefined, ns);
+			if (getResult.error) {
+				ctx.showStatus(`Error: ${getResult.error.message}`);
+				return;
+			}
+			if (!getResult.items || getResult.items.length === 0) {
+				ctx.showStatus(`No ${parsed.kind} resources found.`);
+				return;
+			}
+			for (const item of getResult.items) {
+				manifests.push(toManifest(item, parsed.kind));
+			}
+		}
+
+		if (manifests.length === 0) {
+			ctx.showStatus("No resources found to export.");
+			return;
+		}
+
+		const output = formatManifestOutput(manifests, fmt);
+
+		if (parsed.outputFile) {
+			const { writeFile, mkdir } = await import("node:fs/promises");
+			const { dirname, resolve, sep } = await import("node:path");
+			const isDir = parsed.outputFile.endsWith("/");
+
+			if (isDir) {
+				await mkdir(parsed.outputFile, { recursive: true });
+				const baseDir = resolve(parsed.outputFile);
+				const ext = fmt === "yaml" ? "yaml" : "json";
+				for (const m of manifests) {
+					const safeKind = m.kind.replace(/[/\\]/g, "_");
+					const safeName = ((m.metadata.name as string) ?? "unknown").replace(/[/\\]/g, "_");
+					const filename = `${safeKind}-${safeName}.${ext}`;
+					const filepath = resolve(parsed.outputFile, filename);
+					if (!filepath.startsWith(baseDir + sep) && filepath !== baseDir) {
+						ctx.showStatus(`Skipping unsafe resource name: ${m.metadata.name}`);
+						continue;
+					}
+					const content = formatManifestOutput([m], fmt);
+					await writeFile(filepath, content, "utf-8");
+				}
+				ctx.showStatus(`Exported ${manifests.length} resource(s) to ${parsed.outputFile}`);
+			} else {
+				await mkdir(dirname(parsed.outputFile), { recursive: true });
+				await writeFile(parsed.outputFile, output, "utf-8");
+				ctx.showStatus(`Exported ${manifests.length} resource(s) to ${parsed.outputFile}`);
+			}
+		} else {
+			ctx.showStatus(output);
+		}
+	} catch (err) {
+		if (err instanceof KindResolutionError) {
+			ctx.showStatus(`Error: ${err.message}`);
+		} else {
+			ctx.showStatus(`Unexpected error: ${(err as Error).message}`);
+		}
+	}
+}
+
+export { getExportKindCompletions };