@f5xc-salesdemos/xcsh 18.41.1 → 18.43.0

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5xc-salesdemos/xcsh",
-	"version": "18.41.1",
+	"version": "18.43.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5xc-salesdemos/xcsh",
 	"author": "Can Boluk",
@@ -48,12 +48,12 @@
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.16.1",
 		"@mozilla/readability": "^0.6",
-		"@f5xc-salesdemos/xcsh-stats": "18.41.1",
-		"@f5xc-salesdemos/pi-agent-core": "18.41.1",
-		"@f5xc-salesdemos/pi-ai": "18.41.1",
-		"@f5xc-salesdemos/pi-natives": "18.41.1",
-		"@f5xc-salesdemos/pi-tui": "18.41.1",
-		"@f5xc-salesdemos/pi-utils": "18.41.1",
+		"@f5xc-salesdemos/xcsh-stats": "18.43.0",
+		"@f5xc-salesdemos/pi-agent-core": "18.43.0",
+		"@f5xc-salesdemos/pi-ai": "18.43.0",
+		"@f5xc-salesdemos/pi-natives": "18.43.0",
+		"@f5xc-salesdemos/pi-tui": "18.43.0",
+		"@f5xc-salesdemos/pi-utils": "18.43.0",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.18",

package/src/internal-urls/api-spec-resolve.ts

@@ -412,6 +412,8 @@ function formatFieldConstraints(prop: Record<string, unknown>): string {
 	if (c.maxItems != null) parts.push(`maxItems: ${c.maxItems}`);
 	if (c.format) parts.push(`format: ${c.format}`);
 	if (Array.isArray(c.enum)) parts.push(`enum: ${(c.enum as string[]).join(", ")}`);
+	const meta = c.metadata as Record<string, unknown> | undefined;
+	if (meta?.note) parts.push(`note: ${String(meta.note)}`);
 	return parts.join(", ");
 }
 

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

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "18.41.1",
-	"commit": "7dc812d262a4be86c13968193803ffe2fb19b91b",
-	"shortCommit": "7dc812d",
+	"version": "18.43.0",
+	"commit": "3b728b77f3756587bfb90eb1e264dc60890ef4bd",
+	"shortCommit": "3b728b7",
 	"branch": "main",
-	"tag": "v18.41.1",
-	"commitDate": "2026-05-05T15:09:44Z",
-	"buildDate": "2026-05-05T15:33:02.304Z",
+	"tag": "v18.43.0",
+	"commitDate": "2026-05-05T18:56:20Z",
+	"buildDate": "2026-05-05T19:16:23.079Z",
 	"dirty": false,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5xc-salesdemos/xcsh",
 	"repoSlug": "f5xc-salesdemos/xcsh",
-	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/7dc812d262a4be86c13968193803ffe2fb19b91b",
-	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v18.41.1"
+	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/3b728b77f3756587bfb90eb1e264dc60890ef4bd",
+	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v18.43.0"
 };

package/src/internal-urls/index.ts

@@ -32,8 +32,10 @@ export * from "./local-protocol";
 export * from "./mcp-protocol";
 export * from "./memory-protocol";
 export * from "./parse";
+export * from "./profile-collectors";
 export * from "./router";
 export * from "./rule-protocol";
 export * from "./skill-protocol";
 export type * from "./types";
+export * from "./user-profile";
 export * from "./xcsh-protocol";

package/src/internal-urls/profile-collectors.ts

@@ -0,0 +1,228 @@
+import { $which, logger } from "@f5xc-salesdemos/pi-utils";
+import { $ } from "bun";
+
+import type { UserProfile } from "./user-profile";
+
+export interface ProfileCollector {
+	/** Unique identifier for this collector */
+	readonly id: string;
+	/** Human-readable name */
+	readonly name: string;
+	/** Check if this collector can run (binary exists, platform ok, etc.) */
+	available(): Promise<boolean>;
+	/** Run the collector and return partial profile fields to merge */
+	collect(): Promise<Partial<UserProfile>>;
+}
+
+// ---------------------------------------------------------------------------
+// Salesforce
+// ---------------------------------------------------------------------------
+
+const salesforceCollector: ProfileCollector = {
+	id: "salesforce",
+	name: "Salesforce",
+
+	async available(): Promise<boolean> {
+		if (!$which("sf")) return false;
+		try {
+			const proc = await $`sf org display --json`.quiet().nothrow();
+			if (proc.exitCode !== 0) return false;
+			const parsed = JSON.parse(proc.stdout.toString()) as Record<string, unknown>;
+			const result = parsed.result as Record<string, unknown> | undefined;
+			return typeof result?.username === "string" && result.username.length > 0;
+		} catch {
+			return false;
+		}
+	},
+
+	async collect(): Promise<Partial<UserProfile>> {
+		try {
+			// Get username
+			const orgProc = await $`sf org display --json`.quiet().nothrow();
+			if (orgProc.exitCode !== 0) return {};
+			const orgData = JSON.parse(orgProc.stdout.toString()) as Record<string, unknown>;
+			const orgResult = orgData.result as Record<string, unknown> | undefined;
+			const username = orgResult?.username as string | undefined;
+			if (!username) return {};
+
+			// Build and run SOQL
+			const soql = `SELECT Id, Username, FirstName, LastName, Email, Title, Department, Division, CompanyName, AboutMe, ManagerId, Manager.Name, Manager.Email, UserRole.Name, Profile.Name, Street, City, State, PostalCode, Country, Phone, MobilePhone FROM User WHERE Username = '${username}'`;
+			const queryProc = await $`sf data query --query ${soql} --json`.quiet().nothrow();
+			if (queryProc.exitCode !== 0) return {};
+
+			const queryData = JSON.parse(queryProc.stdout.toString()) as Record<string, unknown>;
+			const queryResult = queryData.result as Record<string, unknown> | undefined;
+			const records = queryResult?.records as Record<string, unknown>[] | undefined;
+			const rec = records?.[0];
+			if (!rec) return {};
+
+			// Map fields
+			const profile: Partial<UserProfile> = {};
+
+			if (rec.FirstName) profile.givenName = rec.FirstName as string;
+			if (rec.LastName) profile.familyName = rec.LastName as string;
+			if (rec.Email) profile.email = rec.Email as string;
+
+			const phone = (rec.Phone || rec.MobilePhone) as string | undefined;
+			if (phone) profile.telephone = phone;
+
+			if (rec.Title) profile.jobTitle = rec.Title as string;
+			if (rec.Department) profile.department = rec.Department as string;
+			if (rec.Division) profile.division = rec.Division as string;
+
+			const companyName = (rec.CompanyName as string) || "F5";
+			profile.worksFor = { name: companyName };
+
+			// Manager
+			const mgr = rec.Manager as Record<string, unknown> | undefined;
+			if (mgr) {
+				const mgrName = mgr.Name as string | undefined;
+				const mgrEmail = mgr.Email as string | undefined;
+				if (mgrName || mgrEmail) {
+					profile.manager = {};
+					if (mgrName) {
+						const parts = mgrName.split(" ");
+						profile.manager.givenName = parts[0];
+						if (parts.length > 1) profile.manager.familyName = parts.slice(1).join(" ");
+					}
+					if (mgrEmail) profile.manager.email = mgrEmail;
+				}
+			}
+
+			// Address
+			const street = rec.Street as string | undefined;
+			const city = rec.City as string | undefined;
+			const state = rec.State as string | undefined;
+			const postalCode = rec.PostalCode as string | undefined;
+			const country = rec.Country as string | undefined;
+			if (street || city || state || postalCode || country) {
+				profile.address = {};
+				if (street) profile.address.streetAddress = street;
+				if (city) profile.address.addressLocality = city;
+				if (state) profile.address.addressRegion = state;
+				if (postalCode) profile.address.postalCode = postalCode;
+				if (country) profile.address.addressCountry = country;
+			}
+
+			// Identifiers
+			if (rec.Id) {
+				profile.identifiers = { salesforceId: rec.Id as string };
+			}
+
+			return profile;
+		} catch (err: unknown) {
+			logger.debug("salesforce collector failed", { error: err });
+			return {};
+		}
+	},
+};
+
+// ---------------------------------------------------------------------------
+// GitHub
+// ---------------------------------------------------------------------------
+
+const githubCollector: ProfileCollector = {
+	id: "github",
+	name: "GitHub",
+
+	async available(): Promise<boolean> {
+		if (!$which("gh")) return false;
+		try {
+			const proc = await $`gh auth status`.quiet().nothrow();
+			return proc.exitCode === 0;
+		} catch {
+			return false;
+		}
+	},
+
+	async collect(): Promise<Partial<UserProfile>> {
+		try {
+			const proc = await $`gh api user`.quiet().nothrow();
+			if (proc.exitCode !== 0) return {};
+
+			const data = JSON.parse(proc.stdout.toString()) as Record<string, unknown>;
+			const profile: Partial<UserProfile> = {};
+			const sameAs: string[] = [];
+
+			const login = data.login as string | undefined;
+			if (login) {
+				profile.identifiers = { ...profile.identifiers, github: login };
+				sameAs.push(`https://github.com/${login}`);
+			}
+
+			const name = data.name as string | undefined;
+			if (name) {
+				const parts = name.split(" ");
+				if (parts.length >= 2) {
+					profile.givenName = parts[0];
+					profile.familyName = parts.slice(1).join(" ");
+				}
+			}
+
+			const email = data.email as string | undefined;
+			if (email) profile.email = email;
+
+			const bio = data.bio as string | undefined;
+			if (bio) profile.description = bio;
+
+			const blog = data.blog as string | undefined;
+			if (blog) {
+				profile.url = blog;
+				sameAs.push(blog);
+			}
+
+			const twitterUsername = data.twitter_username as string | undefined;
+			if (twitterUsername) {
+				profile.identifiers = { ...profile.identifiers, twitter: twitterUsername };
+				sameAs.push(`https://x.com/${twitterUsername}`);
+			}
+
+			if (sameAs.length > 0) profile.sameAs = sameAs;
+
+			return profile;
+		} catch (err: unknown) {
+			logger.debug("github collector failed", { error: err });
+			return {};
+		}
+	},
+};
+
+// ---------------------------------------------------------------------------
+// System (macOS)
+// ---------------------------------------------------------------------------
+
+const systemCollector: ProfileCollector = {
+	id: "system",
+	name: "System",
+
+	async available(): Promise<boolean> {
+		return process.platform === "darwin";
+	},
+
+	async collect(): Promise<Partial<UserProfile>> {
+		try {
+			const proc = await $`defaults read NSGlobalDomain AppleLanguages`.quiet().nothrow();
+			if (proc.exitCode !== 0) return {};
+
+			const raw = proc.stdout.toString().trim();
+			// Plist array format: (\n    "en-US",\n    "fr-FR"\n)
+			const inner = raw.replace(/^\(\s*/, "").replace(/\s*\)$/, "");
+			const languages = inner
+				.split(",")
+				.map(s => s.trim().replace(/^"/, "").replace(/"$/, ""))
+				.filter(s => s.length > 0);
+
+			if (languages.length === 0) return {};
+			return { knowsLanguage: languages };
+		} catch (err: unknown) {
+			logger.debug("system collector failed", { error: err });
+			return {};
+		}
+	},
+};
+
+// ---------------------------------------------------------------------------
+// Registry
+// ---------------------------------------------------------------------------
+
+export const PROFILE_COLLECTORS: readonly ProfileCollector[] = [salesforceCollector, githubCollector, systemCollector];

package/src/internal-urls/user-profile.ts

@@ -0,0 +1,287 @@
+import * as os from "node:os";
+import * as path from "node:path";
+import { isEnoent, logger } from "@f5xc-salesdemos/pi-utils";
+import { PROFILE_COLLECTORS } from "./profile-collectors";
+
+export interface UserProfileObservation {
+	key: string;
+	value: string;
+	source?: string;
+	observedAt?: string;
+}
+
+export interface UserProfile {
+	givenName?: string;
+	familyName?: string;
+	additionalName?: string;
+	email?: string;
+	telephone?: string;
+	jobTitle?: string;
+	department?: string;
+	division?: string;
+	worksFor?: { name?: string; url?: string };
+	manager?: { givenName?: string; familyName?: string; email?: string };
+	address?: {
+		streetAddress?: string;
+		addressLocality?: string;
+		addressRegion?: string;
+		postalCode?: string;
+		addressCountry?: string;
+	};
+	birthDate?: string;
+	birthPlace?: {
+		addressLocality?: string;
+		addressRegion?: string;
+		addressCountry?: string;
+	};
+	nationality?: string;
+	gender?: string;
+	knowsLanguage?: string[];
+	spouse?: { givenName?: string; familyName?: string };
+	children?: Array<{ givenName?: string; familyName?: string; birthDate?: string }>;
+	parent?: Array<{ givenName?: string; familyName?: string }>;
+	sibling?: Array<{ givenName?: string; familyName?: string }>;
+	url?: string;
+	description?: string;
+	image?: string;
+	sameAs?: string[];
+	identifiers?: { github?: string; twitter?: string; salesforceId?: string };
+	observations?: UserProfileObservation[];
+	sources?: { salesforce?: string; github?: string; system?: string; conversation?: string };
+	updatedAt?: string;
+}
+
+const PROFILE_PATH = path.join(os.homedir(), ".xcsh", "user-profile.json");
+
+export async function loadProfile(): Promise<UserProfile> {
+	try {
+		return (await Bun.file(PROFILE_PATH).json()) as UserProfile;
+	} catch (err: unknown) {
+		if (isEnoent(err)) return {};
+		logger.warn("Failed to load user profile", { error: err });
+		return {};
+	}
+}
+
+export async function saveProfile(profile: UserProfile): Promise<void> {
+	profile.updatedAt = new Date().toISOString();
+	await Bun.write(PROFILE_PATH, JSON.stringify(profile, null, 2));
+}
+
+export function mergeProfile(target: UserProfile, source: Partial<UserProfile>): void {
+	for (const [key, value] of Object.entries(source)) {
+		if (value === undefined || value === null) continue;
+		const k = key as keyof UserProfile;
+		if (k === "sources" || k === "observations" || k === "updatedAt") continue;
+		if (k === "sameAs") {
+			// Merge arrays without duplicates
+			if (!target.sameAs) target.sameAs = [];
+			for (const url of value as string[]) {
+				if (!target.sameAs.includes(url)) target.sameAs.push(url);
+			}
+			continue;
+		}
+		if (k === "knowsLanguage") {
+			if (!target.knowsLanguage) target.knowsLanguage = value as string[];
+			continue;
+		}
+		// For objects (worksFor, manager, address, etc.), merge sub-fields
+		if (typeof value === "object" && !Array.isArray(value)) {
+			const existing = target[k] as Record<string, unknown> | undefined;
+			if (!existing) {
+				(target as Record<string, unknown>)[k] = value;
+			}
+			continue;
+		}
+		// For simple values, don't overwrite
+		if (target[k] === undefined || target[k] === null) {
+			(target as Record<string, unknown>)[k] = value;
+		}
+	}
+}
+
+export async function seedProfile(): Promise<UserProfile> {
+	const profile = await loadProfile();
+	if (!profile.sources) profile.sources = {};
+
+	for (const collector of PROFILE_COLLECTORS) {
+		try {
+			const isAvailable = await collector.available();
+			if (!isAvailable) {
+				logger.debug(`Profile collector '${collector.id}' not available, skipping`);
+				continue;
+			}
+			const partial = await collector.collect();
+			mergeProfile(profile, partial);
+			(profile.sources as Record<string, string>)[collector.id] = new Date().toISOString();
+			logger.debug(`Profile collector '${collector.id}' completed`);
+		} catch (err: unknown) {
+			logger.debug(`Profile collector '${collector.id}' failed`, { error: err });
+		}
+	}
+
+	await saveProfile(profile);
+	return profile;
+}
+
+function formatAddress(addr: NonNullable<UserProfile["address"]>): string {
+	const parts: string[] = [];
+	if (addr.streetAddress) parts.push(addr.streetAddress);
+	const cityState = [addr.addressLocality, addr.addressRegion].filter(Boolean).join(", ");
+	if (cityState) parts.push(cityState);
+	if (addr.postalCode) parts.push(addr.postalCode);
+	if (addr.addressCountry) parts.push(addr.addressCountry);
+	return parts.join(", ");
+}
+
+function hasValues(obj: Record<string, unknown> | undefined): boolean {
+	if (!obj) return false;
+	return Object.values(obj).some(v => v !== undefined && v !== null && v !== "");
+}
+
+export function renderProfileMarkdown(profile: UserProfile): string {
+	const sections: string[] = [];
+
+	sections.push("# User Profile\n");
+
+	const isEmpty = !profile.givenName && !profile.familyName && !profile.email && !profile.jobTitle;
+	if (isEmpty) {
+		sections.push(
+			"No profile data yet. Use `xcsh://user?seed=true` to populate from Salesforce, GitHub, and system sources.\n",
+		);
+		sections.push("Profile facts can also be added progressively during conversation.\n");
+		return sections.join("\n");
+	}
+
+	// Identity
+	const identityLines: string[] = [];
+	const fullName = [profile.givenName, profile.additionalName, profile.familyName].filter(Boolean).join(" ");
+	if (fullName) identityLines.push(`- **Name:** ${fullName}`);
+	if (profile.email) identityLines.push(`- **Email:** ${profile.email}`);
+	if (profile.telephone) identityLines.push(`- **Phone:** ${profile.telephone}`);
+	if (profile.image) identityLines.push(`- **Avatar:** ${profile.image}`);
+	if (identityLines.length > 0) {
+		sections.push("## Identity\n");
+		sections.push(identityLines.join("\n"));
+	}
+
+	// Employment
+	const employmentLines: string[] = [];
+	if (profile.jobTitle) employmentLines.push(`- **Title:** ${profile.jobTitle}`);
+	if (profile.department) employmentLines.push(`- **Department:** ${profile.department}`);
+	if (profile.division) employmentLines.push(`- **Division:** ${profile.division}`);
+	if (profile.worksFor?.name) {
+		const org = profile.worksFor.url ? `[${profile.worksFor.name}](${profile.worksFor.url})` : profile.worksFor.name;
+		employmentLines.push(`- **Organization:** ${org}`);
+	}
+	if (profile.manager) {
+		const mgrName = [profile.manager.givenName, profile.manager.familyName].filter(Boolean).join(" ");
+		const mgrLine = profile.manager.email ? `${mgrName} (${profile.manager.email})` : mgrName;
+		if (mgrLine) employmentLines.push(`- **Manager:** ${mgrLine}`);
+	}
+	if (employmentLines.length > 0) {
+		sections.push("\n## Employment\n");
+		sections.push(employmentLines.join("\n"));
+	}
+
+	// Address
+	if (hasValues(profile.address)) {
+		sections.push("\n## Address\n");
+		sections.push(`- ${formatAddress(profile.address!)}`);
+	}
+
+	// Demographics
+	const demoLines: string[] = [];
+	if (profile.birthDate) demoLines.push(`- **Birth Date:** ${profile.birthDate}`);
+	if (profile.birthPlace && hasValues(profile.birthPlace)) {
+		const bp = [
+			profile.birthPlace.addressLocality,
+			profile.birthPlace.addressRegion,
+			profile.birthPlace.addressCountry,
+		]
+			.filter(Boolean)
+			.join(", ");
+		if (bp) demoLines.push(`- **Birth Place:** ${bp}`);
+	}
+	if (profile.nationality) demoLines.push(`- **Nationality:** ${profile.nationality}`);
+	if (profile.gender) demoLines.push(`- **Gender:** ${profile.gender}`);
+	if (profile.knowsLanguage && profile.knowsLanguage.length > 0) {
+		demoLines.push(`- **Languages:** ${profile.knowsLanguage.join(", ")}`);
+	}
+	if (demoLines.length > 0) {
+		sections.push("\n## Demographics\n");
+		sections.push(demoLines.join("\n"));
+	}
+
+	// Family
+	const familyLines: string[] = [];
+	if (profile.spouse) {
+		const spouseName = [profile.spouse.givenName, profile.spouse.familyName].filter(Boolean).join(" ");
+		if (spouseName) familyLines.push(`- **Spouse:** ${spouseName}`);
+	}
+	if (profile.children && profile.children.length > 0) {
+		for (const child of profile.children) {
+			const childName = [child.givenName, child.familyName].filter(Boolean).join(" ");
+			const childLine = child.birthDate ? `${childName} (b. ${child.birthDate})` : childName;
+			if (childLine) familyLines.push(`- **Child:** ${childLine}`);
+		}
+	}
+	if (profile.parent && profile.parent.length > 0) {
+		for (const p of profile.parent) {
+			const pName = [p.givenName, p.familyName].filter(Boolean).join(" ");
+			if (pName) familyLines.push(`- **Parent:** ${pName}`);
+		}
+	}
+	if (profile.sibling && profile.sibling.length > 0) {
+		for (const s of profile.sibling) {
+			const sName = [s.givenName, s.familyName].filter(Boolean).join(" ");
+			if (sName) familyLines.push(`- **Sibling:** ${sName}`);
+		}
+	}
+	if (familyLines.length > 0) {
+		sections.push("\n## Family\n");
+		sections.push(familyLines.join("\n"));
+	}
+
+	// Online Presence
+	const onlineLines: string[] = [];
+	if (profile.url) onlineLines.push(`- **Website:** ${profile.url}`);
+	if (profile.description) onlineLines.push(`- **Bio:** ${profile.description}`);
+	if (profile.identifiers?.github) onlineLines.push(`- **GitHub:** ${profile.identifiers.github}`);
+	if (profile.identifiers?.twitter) onlineLines.push(`- **Twitter/X:** ${profile.identifiers.twitter}`);
+	if (profile.identifiers?.salesforceId) onlineLines.push(`- **Salesforce ID:** ${profile.identifiers.salesforceId}`);
+	if (profile.sameAs && profile.sameAs.length > 0) {
+		for (const link of profile.sameAs) {
+			onlineLines.push(`- **Profile:** ${link}`);
+		}
+	}
+	if (onlineLines.length > 0) {
+		sections.push("\n## Online Presence\n");
+		sections.push(onlineLines.join("\n"));
+	}
+
+	// Observations
+	if (profile.observations && profile.observations.length > 0) {
+		sections.push("\n## Observations\n");
+		sections.push("| Key | Value | Source | Observed |");
+		sections.push("|-----|-------|--------|----------|");
+		for (const obs of profile.observations) {
+			sections.push(`| ${obs.key} | ${obs.value} | ${obs.source ?? ""} | ${obs.observedAt ?? ""} |`);
+		}
+	}
+
+	// Sources
+	if (profile.sources && hasValues(profile.sources as unknown as Record<string, unknown>)) {
+		sections.push("\n---\n");
+		sections.push("**Sources:**");
+		const srcLines: string[] = [];
+		if (profile.sources.salesforce) srcLines.push(`Salesforce: ${profile.sources.salesforce}`);
+		if (profile.sources.github) srcLines.push(`GitHub: ${profile.sources.github}`);
+		if (profile.sources.system) srcLines.push(`System: ${profile.sources.system}`);
+		if (profile.sources.conversation) srcLines.push(`Conversation: ${profile.sources.conversation}`);
+		sections.push(srcLines.join(" | "));
+		if (profile.updatedAt) sections.push(`\n*Last updated: ${profile.updatedAt}*`);
+	}
+
+	return sections.join("\n");
+}

package/src/internal-urls/xcsh-protocol.ts

@@ -16,6 +16,8 @@
  * - xcsh://api-spec/glossary/ - Acronym glossary
  * - xcsh://api-catalog/ - API operation catalog
  * - xcsh://api-catalog/{category} - Category operations with curl templates
+ * - xcsh://user - Human user profile
+ * - xcsh://user?seed=true - Seed profile from sources and render
  */
 import * as path from "node:path";
 import { logger } from "@f5xc-salesdemos/pi-utils";
@@ -27,11 +29,13 @@ import type { ApiSpecIndex, OpenAPISpec } from "./api-spec-types";
 import { getRuntimeBuildInfo, type RuntimeBuildInfo, renderAboutDoc } from "./build-info-runtime";
 import { EMBEDDED_DOC_FILENAMES, EMBEDDED_DOCS } from "./docs-index.generated";
 import type { InternalResource, InternalUrl, ProtocolHandler } from "./types";
+import { loadProfile, renderProfileMarkdown, seedProfile } from "./user-profile";
 
 const SCHEME_PREFIX = "xcsh://";
 const ABOUT_ROUTE = "about";
 const API_SPEC_HOST = "api-spec";
 const API_CATALOG_HOST = "api-catalog";
+const USER_ROUTE = "user";
 
 const EMPTY_INDEX: ApiSpecIndex = { version: "unavailable", timestamp: "", domains: [] };
 const EMPTY_CATALOG_INDEX: ApiCatalogIndex = {
@@ -163,6 +167,10 @@ export class InternalDocsProtocolHandler implements ProtocolHandler {
 			return this.#getApiCatalogResolver().resolve(url);
 		}
 
+		if (host === USER_ROUTE) {
+			return this.#resolveUserProfile(url);
+		}
+
 		const pathname = url.rawPathname ?? url.pathname;
 		const filename = host ? (pathname && pathname !== "/" ? host + pathname : host) : "";
 
@@ -173,6 +181,22 @@ export class InternalDocsProtocolHandler implements ProtocolHandler {
 		return this.#readDoc(filename, url);
 	}
 
+	async #resolveUserProfile(url: InternalUrl): Promise<InternalResource> {
+		const params = new URLSearchParams(url.search);
+		const shouldSeed = params.get("seed") === "true";
+
+		const profile = shouldSeed ? await seedProfile() : await loadProfile();
+		const content = renderProfileMarkdown(profile);
+
+		return {
+			url: url.href,
+			content,
+			contentType: "text/markdown",
+			size: Buffer.byteLength(content, "utf-8"),
+			sourcePath: `xcsh://${USER_ROUTE}`,
+		};
+	}
+
 	async #listDocs(url: InternalUrl): Promise<InternalResource> {
 		if (EMBEDDED_DOC_FILENAMES.length === 0) {
 			throw new Error("No documentation files found");
@@ -183,13 +207,15 @@ export class InternalDocsProtocolHandler implements ProtocolHandler {
 		const syntheticEntry = `- [${ABOUT_ROUTE}](${SCHEME_PREFIX}${ABOUT_ROUTE}) — identity and build fingerprint`;
 		const apiSpecEntry = `- [${API_SPEC_HOST}/](${SCHEME_PREFIX}${API_SPEC_HOST}/) — F5 XC API specifications (${specs.index.domains.length} domains, v${specs.version})`;
 		const apiCatalogEntry = `- [${API_CATALOG_HOST}/](${SCHEME_PREFIX}${API_CATALOG_HOST}/) — F5 XC API operation catalog (${catalog.summaries.length} categories, v${catalog.index.version})`;
+		const userEntry = `- [${USER_ROUTE}](${SCHEME_PREFIX}${USER_ROUTE}) — human user profile`;
 		const listing = [
 			syntheticEntry,
 			apiSpecEntry,
 			apiCatalogEntry,
+			userEntry,
 			...EMBEDDED_DOC_FILENAMES.map(f => `- [${f}](${SCHEME_PREFIX}${f})`),
 		].join("\n");
-		const totalCount = EMBEDDED_DOC_FILENAMES.length + 3;
+		const totalCount = EMBEDDED_DOC_FILENAMES.length + 4;
 		const content = `# Documentation\n\n${totalCount} files available:\n\n${listing}\n`;
 
 		return {

package/src/prompts/tools/bash.md

@@ -46,19 +46,19 @@ You **MUST** use specialized tools instead of bash for ALL file operations:
 |---|---|
 |`cat file`, `head -n N file`|`read(path="file", limit=N)`|
 |`cat -n file \|sed -n '50,150p'`|`read(path="file", offset=50, limit=100)`|
-<!-- markdownlint-disable MD055 MD056 -->
+<!-- markdownlint-disable MD055 MD056 -→
 {{#if hasGrep}}|`grep -A 20 'pat' file`|`grep(pattern="pat", path="file", post=20)`|
 |`grep -rn 'pat' dir/`|`grep(pattern="pat", path="dir/")`|
 |`rg 'pattern' dir/`|`grep(pattern="pattern", path="dir/")`|{{/if}}
 {{#if hasFind}}|`find dir -name '*.ts'`|`find(pattern="dir/**/*.ts")`|{{/if}}
-<!-- markdownlint-enable MD055 MD056 -->
+<!-- markdownlint-enable MD055 MD056 -→
 |`ls dir/`|`read(path="dir/")`|
 |`cat <<'EOF' > file`|`write(path="file", content="…")`|
 |`sed -i 's/old/new/' file`|`edit(path="file", edits=[…])`|
 
-<!-- markdownlint-disable MD055 MD056 -->
+<!-- markdownlint-disable MD055 MD056 -→
 {{#if hasAstEdit}}|`sed -i 's/oldFn(/newFn(/' src/*.ts`|`ast_edit({ops:[{pat:"oldFn($$$A)", out:"newFn($$$A)"}], path:"src/"})`|{{/if}}
-<!-- markdownlint-enable MD055 MD056 -->
+<!-- markdownlint-enable MD055 MD056 -→
 {{#if hasAstGrep}}- You **MUST** use `ast_grep` for structural code search instead of bash `grep`/`awk`/`perl` pipelines{{/if}}
 {{#if hasAstEdit}}- You **MUST** use `ast_edit` for structural rewrites instead of bash `sed`/`awk`/`perl` pipelines{{/if}}
 - You **MUST NOT** use Bash for these operations like read, grep, find, edit, write, where specialized tools exist.

package/src/prompts/tools/sf-query.md

@@ -3,7 +3,7 @@ Execute SOQL queries against Salesforce via sf CLI. Returns structured results a
 <instruction>
 Use for pipeline reporting, case management, account intelligence, and ad-hoc data queries.
 
-Common query templates (substitute {userId} from cached xcsh.user.id in ~/.sf/config.json):
+Common query templates (substitute {userId} from user profile — read `xcsh://user` to get identifiers.salesforceId):
 
 Pipeline summary:
   SELECT StageName, COUNT(Id) TotalDeals, SUM(Amount) TotalAmount FROM Opportunity WHERE IsClosed = false GROUP BY StageName ORDER BY SUM(Amount) DESC LIMIT 50

package/src/prompts/tools/sf-setup.md

@@ -1,10 +1,10 @@
-Salesforce onboarding wizard via sf CLI. Check installation, detect authentication, guide login, extract user profile.
+Salesforce onboarding wizard via sf CLI. Check installation, detect authentication, guide login.
 
 <instruction>
-Actions: "check" (verify sf installed), "status" (auth + default org + profile), "login" (detect auth and prompt user with login command), "list_orgs" (show all orgs), "set_default" (switch default org — requires org parameter with a valid alias), "profile" (extract and cache user profile via SOQL).
+Actions: "check" (verify sf installed), "status" (auth + default org), "login" (detect auth and prompt user with login command), "list_orgs" (show all orgs), "set_default" (switch default org — requires org parameter with a valid alias).
 
-When the user first asks about Salesforce, pipeline, cases, or accounts and no org is authenticated, run check, then status, then login if needed, then profile after auth is confirmed. The login action shows the user the exact command to run (sf org login web --set-default --alias SFDC for workstations, or echo "$SFDX_AUTH_URL" | sf org login sfdx-url --sfdx-url-stdin=- --set-default --alias f5 for containers).
+When the user first asks about Salesforce, pipeline, cases, or accounts and no org is authenticated, run check, then status, then login if needed. The login action shows the user the exact command to run (sf org login web --set-default --alias SFDC for workstations, or echo "$SFDX_AUTH_URL" | sf org login sfdx-url --sfdx-url-stdin=- --set-default --alias f5 for containers).
 
 The login action does NOT execute authentication. It detects state and tells the user what command to run.
-The profile action runs a SOQL query against the User object and caches results as xcsh.user.* keys in ~/.sf/config.json.
+User profile data is managed by the central profile builder via `xcsh://user?seed=true`.
 </instruction>

package/src/tools/sf/formatters.ts

@@ -1,4 +1,4 @@
-import type { SfOrg, SfQueryResult, SfUserProfile } from "./types";
+import type { SfOrg, SfQueryResult } from "./types";
 
 export function formatOrgTable(orgs: SfOrg[]): string {
 	if (orgs.length === 0) {
@@ -100,51 +100,3 @@ export function formatQueryResults(result: SfQueryResult): string {
 
 	return `${result.totalSize} records returned.\n\n${[header, divider, ...rows].join("\n")}`;
 }
-
-export function formatUserProfile(profile: SfUserProfile): string {
-	const lines: string[] = [];
-
-	lines.push(`**${profile.firstName} ${profile.lastName}** (${profile.username})`);
-
-	if (profile.title) {
-		lines.push(`Title: ${profile.title}`);
-	}
-
-	if (profile.department) {
-		lines.push(`Department: ${profile.department}`);
-	}
-
-	if (profile.division) {
-		lines.push(`Division: ${profile.division}`);
-	}
-
-	if (profile.role) {
-		lines.push(`Role: ${profile.role}`);
-	}
-
-	if (profile.profile) {
-		lines.push(`Profile: ${profile.profile}`);
-	}
-
-	if (profile.aboutMe) {
-		lines.push(`About: ${profile.aboutMe}`);
-	}
-
-	if (profile.managerName) {
-		const managerLine = profile.managerEmail
-			? `Manager: ${profile.managerName} (${profile.managerEmail})`
-			: `Manager: ${profile.managerName}`;
-		lines.push(managerLine);
-	}
-
-	if (profile.phone) {
-		lines.push(`Phone: ${profile.phone}`);
-	}
-
-	const locationParts = [profile.city, profile.state, profile.country].filter(Boolean);
-	if (locationParts.length > 0) {
-		lines.push(`Location: ${locationParts.join(", ")}`);
-	}
-
-	return lines.join("\n");
-}

package/src/tools/sf/types.ts

@@ -1,28 +1,3 @@
-export interface SfUserProfile {
-	userId: string;
-	username: string;
-	firstName: string;
-	lastName: string;
-	email: string;
-	title?: string;
-	department?: string;
-	division?: string;
-	role?: string;
-	profile?: string;
-	aboutMe?: string;
-	companyName?: string;
-	managerId?: string;
-	managerName?: string;
-	managerEmail?: string;
-	phone?: string;
-	street?: string;
-	city?: string;
-	state?: string;
-	postalCode?: string;
-	country?: string;
-	fetchedAt: string;
-}
-
 export interface SfOrg {
 	alias?: string;
 	username: string;
@@ -62,6 +37,4 @@ export interface SfRawResult {
 
 export const SF_ORG_SAFE_FIELDS = ["username", "orgId", "instanceUrl", "connectedStatus", "alias"] as const;
 
-export const USER_PROFILE_SOQL = `SELECT Id, Username, FirstName, LastName, Email, Title, Department, Division, CompanyName, AboutMe, ManagerId, Manager.Name, Manager.Email, UserRole.Name, Profile.Name, Street, City, State, PostalCode, Country, Phone, MobilePhone FROM User WHERE Username = '{username}'`;
-
 export const ORG_ALIAS_PATTERN = /^[a-zA-Z0-9._@-]+$/;

package/src/tools/sf.ts

@@ -6,16 +6,16 @@ import type {
 } from "@f5xc-salesdemos/pi-agent-core";
 import { $which, prompt } from "@f5xc-salesdemos/pi-utils";
 import { type Static, Type } from "@sinclair/typebox";
+import { loadProfile } from "../internal-urls/user-profile";
 import sfOrgDisplayDescription from "../prompts/tools/sf-org-display.md" with { type: "text" };
 import sfQueryDescription from "../prompts/tools/sf-query.md" with { type: "text" };
 import sfSetupDescription from "../prompts/tools/sf-setup.md" with { type: "text" };
 import type { ToolSession } from ".";
-import { loadUserProfile, saveUserProfile } from "./sf/config";
 import type { SfExecApi } from "./sf/exec";
 import { execSfJson, execSfRaw } from "./sf/exec";
-import { formatOrgDetail, formatOrgTable, formatQueryResults, formatUserProfile } from "./sf/formatters";
-import type { SfOrg, SfQueryResult, SfRawResult, SfUserProfile } from "./sf/types";
-import { ORG_ALIAS_PATTERN, USER_PROFILE_SOQL } from "./sf/types";
+import { formatOrgDetail, formatOrgTable, formatQueryResults } from "./sf/formatters";
+import type { SfOrg, SfQueryResult, SfRawResult } from "./sf/types";
+import { ORG_ALIAS_PATTERN } from "./sf/types";
 
 function makeExecApi(cwd: string): SfExecApi {
 	return {
@@ -57,7 +57,6 @@ const sfSetupSchema = Type.Object({
 			Type.Literal("login"),
 			Type.Literal("list_orgs"),
 			Type.Literal("set_default"),
-			Type.Literal("profile"),
 		],
 		{ description: "Onboarding action to perform" },
 	),
@@ -84,7 +83,6 @@ type SfOrgDisplayInput = Static<typeof sfOrgDisplaySchema>;
 interface SfToolDetails {
 	orgs?: SfOrg[];
 	queryResult?: SfQueryResult;
-	profile?: SfUserProfile;
 }
 
 function textResult(text: string, details?: SfToolDetails): AgentToolResult<SfToolDetails> {
@@ -125,19 +123,6 @@ export function collectAllOrgs(orgList: Record<string, unknown[]>): SfOrg[] {
 	});
 }
 
-function extractRelationshipField(
-	record: Record<string, unknown>,
-	relationship: string,
-	field: string,
-): string | undefined {
-	const related = record[relationship];
-	if (related && typeof related === "object" && !Array.isArray(related)) {
-		const value = (related as Record<string, unknown>)[field];
-		if (value) return String(value);
-	}
-	return undefined;
-}
-
 // ─── SfSetupTool ─────────────────────────────────────────────────────────
 
 export class SfSetupTool implements AgentTool<typeof sfSetupSchema, SfToolDetails> {
@@ -179,9 +164,10 @@ export class SfSetupTool implements AgentTool<typeof sfSetupSchema, SfToolDetail
 				const allOrgs = collectAllOrgs(orgResult.result as Record<string, unknown[]>);
 				let output = formatOrgTable(allOrgs);
 
-				const cached = await loadUserProfile();
-				if (cached) {
-					output += `\n\nCached user profile: **${cached.firstName} ${cached.lastName}** (${cached.username}), fetched ${cached.fetchedAt}`;
+				const userProfile = await loadProfile();
+				if (userProfile.givenName || userProfile.familyName) {
+					const name = [userProfile.givenName, userProfile.familyName].filter(Boolean).join(" ");
+					output += `\n\nUser profile: **${name}** (${userProfile.email ?? "no email"})`;
 				}
 
 				return textResult(output, { orgs: allOrgs });
@@ -191,7 +177,7 @@ export class SfSetupTool implements AgentTool<typeof sfSetupSchema, SfToolDetail
 				const orgResult = await execSfJson(api, ["org", "list"], signal);
 				const allOrgs = collectAllOrgs(orgResult.result as Record<string, unknown[]>);
 				if (allOrgs.length > 0) {
-					return textResult("Already authenticated. Use 'profile' action to extract your user data.", {
+					return textResult("Already authenticated. Use 'status' action to see your orgs and profile.", {
 						orgs: allOrgs,
 					});
 				}
@@ -221,59 +207,6 @@ export class SfSetupTool implements AgentTool<typeof sfSetupSchema, SfToolDetail
 				await execSfRaw(api, ["config", "set", "target-org", params.org, "--global"], signal);
 				return textResult(`Default org set to: **${params.org}**`);
 			}
-
-			case "profile": {
-				// Step 1: Get the current user's username from org display
-				const orgInfo = await execSfJson(api, ["org", "display"], signal);
-				const orgResult = orgInfo.result as Record<string, unknown>;
-				const username = orgResult.username as string;
-				if (!username) {
-					return textResult("Could not determine username from org display. Ensure a default org is set.");
-				}
-
-				// Step 2: Build and run SOQL query for user profile
-				const soql = USER_PROFILE_SOQL.replace("{username}", username);
-				const queryResult = await execSfJson(api, ["data", "query", "--query", soql], signal, soql);
-				const queryData = queryResult.result as SfQueryResult<Record<string, unknown>>;
-
-				if (!queryData.records || queryData.records.length === 0) {
-					return textResult(`No user record found for username: ${username}`);
-				}
-
-				const record = queryData.records[0];
-
-				// Step 3: Map SOQL fields to SfUserProfile
-				const profile: SfUserProfile = {
-					userId: String(record.Id ?? ""),
-					username: String(record.Username ?? ""),
-					firstName: String(record.FirstName ?? ""),
-					lastName: String(record.LastName ?? ""),
-					email: String(record.Email ?? ""),
-					title: record.Title ? String(record.Title) : undefined,
-					department: record.Department ? String(record.Department) : undefined,
-					division: record.Division ? String(record.Division) : undefined,
-					companyName: record.CompanyName ? String(record.CompanyName) : undefined,
-					aboutMe: record.AboutMe ? String(record.AboutMe) : undefined,
-					managerId: record.ManagerId ? String(record.ManagerId) : undefined,
-					managerName: extractRelationshipField(record, "Manager", "Name"),
-					managerEmail: extractRelationshipField(record, "Manager", "Email"),
-					role: extractRelationshipField(record, "UserRole", "Name"),
-					profile: extractRelationshipField(record, "Profile", "Name"),
-					phone: record.Phone || record.MobilePhone ? String(record.Phone ?? record.MobilePhone) : undefined,
-					street: record.Street ? String(record.Street) : undefined,
-					city: record.City ? String(record.City) : undefined,
-					state: record.State ? String(record.State) : undefined,
-					postalCode: record.PostalCode ? String(record.PostalCode) : undefined,
-					country: record.Country ? String(record.Country) : undefined,
-					fetchedAt: new Date().toISOString(),
-				};
-
-				// Step 4: Cache the profile
-				await saveUserProfile(profile);
-
-				return textResult(formatUserProfile(profile), { profile });
-			}
-
 			default:
 				return textResult(`Unknown action: ${params.action}`);
 		}

package/src/tools/sf/config.ts

@@ -1,44 +0,0 @@
-import * as fs from "node:fs/promises";
-import * as path from "node:path";
-import { isEnoent } from "@f5xc-salesdemos/pi-utils";
-import type { SfUserProfile } from "./types";
-
-export function getProfilePath(): string {
-	const home = process.env.HOME || process.env.USERPROFILE || "";
-	return path.join(home, ".xcsh", "sf-profile.json");
-}
-
-export async function loadUserProfile(): Promise<SfUserProfile | null> {
-	try {
-		const raw = await fs.readFile(getProfilePath(), "utf8");
-		const profile = JSON.parse(raw) as SfUserProfile;
-		if (
-			!profile.userId ||
-			!profile.username ||
-			!profile.firstName ||
-			!profile.lastName ||
-			!profile.email ||
-			!profile.fetchedAt
-		) {
-			return null;
-		}
-		return profile;
-	} catch (err) {
-		if (isEnoent(err)) return null;
-		return null;
-	}
-}
-
-export async function saveUserProfile(profile: SfUserProfile): Promise<void> {
-	const profilePath = getProfilePath();
-	await fs.mkdir(path.dirname(profilePath), { recursive: true });
-	await fs.writeFile(profilePath, JSON.stringify(profile, null, 2), "utf8");
-}
-
-export async function clearUserProfile(): Promise<void> {
-	try {
-		await fs.unlink(getProfilePath());
-	} catch (err) {
-		if (!isEnoent(err)) throw err;
-	}
-}