@f5xc-salesdemos/xcsh 14.1.1 → 14.2.1

package/package.json

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

package/src/config/settings-schema.ts

@@ -1579,6 +1579,7 @@ export const SETTINGS_SCHEMA = {
 		type: "enum",
 		values: [
 			"auto",
+			"firecrawl",
 			"exa",
 			"brave",
 			"jina",

package/src/modes/theme/defaults/xcsh-dark.json

@@ -15,7 +15,7 @@
 	},
 	"colors": {
 		"accent": "f5Red",
-		"border": "subtleGray",
+		"border": "f5Red",
 		"borderAccent": "f5Red",
 		"borderMuted": "f5Red",
 		"success": "signalGreen",
@@ -58,12 +58,12 @@
 		"syntaxType": "coolGray",
 		"syntaxOperator": "coolGray",
 		"syntaxPunctuation": "coolGray",
-		"thinkingOff": "#4a5058",
-		"thinkingMinimal": "#5a6068",
-		"thinkingLow": "#6a7078",
-		"thinkingMedium": "coolGray",
-		"thinkingHigh": "coolGray",
-		"thinkingXhigh": "warmAmber",
+		"thinkingOff": "f5Red",
+		"thinkingMinimal": "f5Red",
+		"thinkingLow": "f5Red",
+		"thinkingMedium": "f5Red",
+		"thinkingHigh": "f5Red",
+		"thinkingXhigh": "f5Red",
 		"bashMode": "signalGreen",
 		"statusLineBg": "deepCharcoal",
 		"statusLineSep": "subtleGray",

package/src/web/search/provider.ts

@@ -3,6 +3,7 @@ import type { SearchProvider } from "./providers/base";
 import { BraveProvider } from "./providers/brave";
 import { CodexProvider } from "./providers/codex";
 import { ExaProvider } from "./providers/exa";
+import { FirecrawlProvider } from "./providers/firecrawl";
 import { GeminiProvider } from "./providers/gemini";
 import { JinaProvider } from "./providers/jina";
 import { KagiProvider } from "./providers/kagi";
@@ -30,10 +31,12 @@ const SEARCH_PROVIDERS: Record<SearchProviderId, SearchProvider> = {
 	tavily: new TavilyProvider(),
 	parallel: new ParallelProvider(),
 	kagi: new KagiProvider(),
+	firecrawl: new FirecrawlProvider(),
 	synthetic: new SyntheticProvider(),
 } as const;
 
 export const SEARCH_PROVIDER_ORDER: SearchProviderId[] = [
+	"firecrawl",
 	"tavily",
 	"perplexity",
 	"brave",

package/src/web/search/providers/firecrawl.ts

@@ -0,0 +1,115 @@
+/**
+ * Firecrawl Web Search Provider
+ *
+ * Calls a local Firecrawl /v1/search API (backed by SearXNG) and maps
+ * results into the unified SearchResponse shape used by the web search tool.
+ *
+ * Set FIRECRAWL_SEARCH_URL to the Firecrawl base URL (e.g. http://localhost:3002).
+ */
+import type { SearchResponse, SearchSource } from "../../../web/search/types";
+import { SearchProviderError } from "../../../web/search/types";
+import { clampNumResults, dateToAgeSeconds } from "../utils";
+import type { SearchParams } from "./base";
+import { SearchProvider } from "./base";
+
+const DEFAULT_NUM_RESULTS = 5;
+const MAX_NUM_RESULTS = 20;
+
+export interface FirecrawlSearchParams {
+	query: string;
+	num_results?: number;
+	signal?: AbortSignal;
+}
+
+interface FirecrawlResultItem {
+	title?: string | null;
+	url?: string | null;
+	markdown?: string | null;
+	metadata?: {
+		publishedTime?: string | null;
+		[key: string]: unknown;
+	} | null;
+}
+
+interface FirecrawlSearchResponse {
+	data?: FirecrawlResultItem[];
+}
+
+/** Return the configured Firecrawl base URL, or null if unset. */
+export function getFirecrawlUrl(): string | null {
+	return process.env.FIRECRAWL_SEARCH_URL ?? null;
+}
+
+async function callFirecrawlSearch(baseUrl: string, params: FirecrawlSearchParams): Promise<FirecrawlSearchResponse> {
+	const numResults = clampNumResults(params.num_results, DEFAULT_NUM_RESULTS, MAX_NUM_RESULTS);
+
+	const response = await fetch(`${baseUrl}/v1/search`, {
+		method: "POST",
+		headers: { "Content-Type": "application/json" },
+		body: JSON.stringify({
+			query: params.query,
+			limit: numResults,
+			scrapeOptions: { formats: ["markdown"], onlyMainContent: true },
+		}),
+		signal: params.signal,
+	});
+
+	if (!response.ok) {
+		const errorText = await response.text();
+		throw new SearchProviderError(
+			"firecrawl",
+			`Firecrawl API error (${response.status}): ${errorText.trim() || response.statusText}`,
+			response.status,
+		);
+	}
+
+	return (await response.json()) as FirecrawlSearchResponse;
+}
+
+/** Execute a web search via the local Firecrawl/SearXNG instance. */
+export async function searchFirecrawl(params: FirecrawlSearchParams): Promise<SearchResponse> {
+	const baseUrl = getFirecrawlUrl();
+	if (!baseUrl) {
+		throw new Error(
+			"FIRECRAWL_SEARCH_URL is not configured. Set it to the Firecrawl base URL (e.g. http://localhost:3002).",
+		);
+	}
+
+	const numResults = clampNumResults(params.num_results, DEFAULT_NUM_RESULTS, MAX_NUM_RESULTS);
+	const response = await callFirecrawlSearch(baseUrl, params);
+	const sources: SearchSource[] = [];
+
+	for (const item of response.data ?? []) {
+		if (!item.url) continue;
+		sources.push({
+			title: item.title ?? item.url,
+			url: item.url,
+			snippet: item.markdown?.trim() || undefined,
+			publishedDate: item.metadata?.publishedTime ?? undefined,
+			ageSeconds: dateToAgeSeconds(item.metadata?.publishedTime ?? undefined),
+		});
+	}
+
+	return {
+		provider: "firecrawl",
+		sources: sources.slice(0, numResults),
+	};
+}
+
+/** Search provider for local Firecrawl/SearXNG. */
+export class FirecrawlProvider extends SearchProvider {
+	readonly id = "firecrawl" as const;
+	readonly label = "Firecrawl";
+
+	isAvailable() {
+		return !!getFirecrawlUrl();
+	}
+
+	search(params: SearchParams): Promise<SearchResponse> {
+		return searchFirecrawl({
+			query: params.query,
+			num_results: params.numSearchResults ?? params.limit,
+			signal: params.signal,
+		});
+	}
+}

package/src/web/search/types.ts

@@ -18,6 +18,7 @@ export type SearchProviderId =
 	| "tavily"
 	| "parallel"
 	| "kagi"
+	| "firecrawl"
 	| "synthetic";
 
 export function isSearchProviderId(value: string): value is SearchProviderId {
@@ -34,6 +35,7 @@ export function isSearchProviderId(value: string): value is SearchProviderId {
 		"tavily",
 		"parallel",
 		"kagi",
+		"firecrawl",
 		"synthetic",
 	].includes(value);
 }