@f5-sales-demo/xcsh 23.0.2 → 23.0.3

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

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "23.0.2",
-	"commit": "aa278eecbd560345b7571f285d77c88608b2cf01",
-	"shortCommit": "aa278ee",
+	"version": "23.0.3",
+	"commit": "a1b667ce0f3621987ad2be76de041c08185614ee",
+	"shortCommit": "a1b667c",
 	"branch": "main",
-	"tag": "v23.0.2",
-	"commitDate": "2026-10-08T14:30:28Z",
-	"buildDate": "2026-10-08T15:12:38.904Z",
+	"tag": "v23.0.3",
+	"commitDate": "2026-10-08T19:11:22Z",
+	"buildDate": "2026-10-08T19:50:26.569Z",
 	"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/aa278eecbd560345b7571f285d77c88608b2cf01",
-	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v23.0.2"
+	"commitUrl": "https://github.com/f5-sales-demo/xcsh/commit/a1b667ce0f3621987ad2be76de041c08185614ee",
+	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v23.0.3"
 };

package/src/modes/rpc/rpc-mode.ts

@@ -634,6 +634,9 @@ export async function runRpcMode(session: AgentSession): Promise<never> {
 					queuedMessageCount: session.queuedMessageCount,
 					todoPhases: session.getTodoPhases(),
 					systemPrompt: session.systemPrompt,
+					registeredToolNames: session.getRegisteredToolNames(),
+					activeToolNames: session.getActiveToolNames(),
+					toolChoiceState: session.toolChoiceQueue.snapshot(),
 					dumpTools: session.agent.state.tools.map(tool => ({
 						name: tool.name,
 						description: tool.description,

package/src/modes/rpc/rpc-types.ts

@@ -136,6 +136,10 @@ export interface RpcSessionState {
 	todoPhases: TodoPhase[];
 	/** For session dump / export (plain-text parity with /dump). */
 	systemPrompt?: string;
+	/** Read-only execution diagnostics; no credentials, inputs, or callback state. */
+	registeredToolNames?: string[];
+	activeToolNames?: string[];
+	toolChoiceState?: ReturnType<import("../../session/tool-choice-queue").ToolChoiceQueue["snapshot"]>;
 	dumpTools?: Array<{ name: string; description: string; parameters: unknown }>;
 }
 

package/src/session/agent-session.ts

@@ -3149,6 +3149,11 @@ export class AgentSession {
 		return this.agent.state.tools.map(t => t.name);
 	}
 
+	/** Complete registry names, including dormant tools, without tool payloads. */
+	getRegisteredToolNames(): string[] {
+		return [...this.#toolRegistry.keys()];
+	}
+
 	/** Numeric-only prompt/tool/provider-call profile. Raw context is never retained. */
 	getContextProfile(): ContextProfile {
 		this.#contextProfileCollector.setPrompt(this.systemPrompt, this.agent.state.tools);

package/src/session/tool-choice-queue.ts

@@ -206,6 +206,21 @@ export class ToolChoiceQueue {
 		return label;
 	}
 
+	/** Read-only diagnostics. Never advance an iterator or invoke callbacks. */
+	snapshot(): { queuedLabels: string[]; inFlight?: { label: string; choice: ToolChoice } } {
+		return {
+			queuedLabels: [...this.inspect()],
+			...(this.#inFlight
+				? {
+						inFlight: {
+							label: this.#inFlight.directive.label,
+							choice: structuredClone(this.#inFlight.yielded),
+						},
+					}
+				: {}),
+		};
+	}
+
 	/** For tests/debug: labels of currently queued directives in order. */
 	inspect(): readonly string[] {
 		return this.#queue.map(d => d.label);

package/src/web/search/index.ts

@@ -6,11 +6,12 @@
  *
  */
 
-import type {
-	AgentTool,
-	AgentToolContext,
-	AgentToolResult,
-	AgentToolUpdateCallback,
+import {
+	type AgentTool,
+	type AgentToolContext,
+	AgentToolError,
+	type AgentToolResult,
+	type AgentToolUpdateCallback,
 } from "@f5-sales-demo/pi-agent-core";
 import { StringEnum } from "@f5-sales-demo/pi-ai";
 import { prompt } from "@f5-sales-demo/pi-utils";
@@ -185,13 +186,16 @@ function formatForLLM(response: SearchResponse): string {
 async function executeSearch(
 	_toolCallId: string,
 	params: SearchQueryParams,
-): Promise<{ content: Array<{ type: "text"; text: string }>; details: SearchRenderDetails }> {
+	signal?: AbortSignal,
+): Promise<{ content: Array<{ type: "text"; text: string }>; details: SearchRenderDetails; isError?: boolean }> {
+	signal?.throwIfAborted();
 	params = { ...params, user_location: normalizeUserLocation(params.user_location) };
 	const validation = validateWebSearchParams(params);
 	if (!validation.valid) {
 		const message = `web_search invalid parameter: ${validation.error}`;
 		return {
 			content: [{ type: "text" as const, text: `Error: ${message}` }],
+			isError: true,
 			details: { response: { provider: "none", sources: [] }, error: message },
 		};
 	}
@@ -209,6 +213,7 @@ async function executeSearch(
 		const message = "No web search provider configured.";
 		return {
 			content: [{ type: "text" as const, text: `Error: ${message}` }],
+			isError: true,
 			details: { response: { provider: "none", sources: [] }, error: message },
 		};
 	}
@@ -221,6 +226,7 @@ async function executeSearch(
 		try {
 			const searchStart = performance.now();
 			const response = await provider.search({
+				signal,
 				query: params.query.replace(/202\d/g, String(new Date().getFullYear())), // LUL
 				limit: params.limit,
 				recency: params.recency,
@@ -243,6 +249,11 @@ async function executeSearch(
 				details: { response },
 			};
 		} catch (error) {
+			if (
+				signal?.aborted ||
+				(error instanceof Error && (error.name === "AbortError" || error.name === "ToolAbortError"))
+			)
+				throw error;
 			lastError = error;
 		}
 	}
@@ -255,6 +266,7 @@ async function executeSearch(
 
 	return {
 		content: [{ type: "text" as const, text: `Error: ${message}` }],
+		isError: true,
 		details: { response: { provider: lastProvider.id, sources: [] }, error: message },
 	};
 }
@@ -264,8 +276,9 @@ async function executeSearch(
  */
 export async function runSearchQuery(
 	params: SearchQueryParams,
-): Promise<{ content: Array<{ type: "text"; text: string }>; details: SearchRenderDetails }> {
-	return executeSearch("cli-web-search", params);
+	signal?: AbortSignal,
+): Promise<{ content: Array<{ type: "text"; text: string }>; details: SearchRenderDetails; isError?: boolean }> {
+	return executeSearch("cli-web-search", params, signal);
 }
 
 /**
@@ -292,7 +305,9 @@ export class SearchTool implements AgentTool<typeof webSearchSchema, SearchRende
 		_onUpdate?: AgentToolUpdateCallback<SearchRenderDetails>,
 		_context?: AgentToolContext,
 	): Promise<AgentToolResult<SearchRenderDetails>> {
-		return executeSearch(_toolCallId, params);
+		const result = await executeSearch(_toolCallId, params, _signal);
+		if (result.isError) throw new AgentToolError(result.details.error ?? "Web search failed", result);
+		return result;
 	}
 }
 
@@ -310,7 +325,9 @@ export const webSearchCustomTool: CustomTool<typeof webSearchSchema, SearchRende
 		_ctx: CustomToolContext,
 		_signal?: AbortSignal,
 	) {
-		return executeSearch(toolCallId, params);
+		const result = await executeSearch(toolCallId, params, _signal);
+		if (result.isError) throw new AgentToolError(result.details.error ?? "Web search failed", result);
+		return result;
 	},
 
 	renderCall(args: SearchToolParams, options: RenderResultOptions, theme: Theme) {

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

@@ -227,6 +227,9 @@ function parseResponse(response: AnthropicApiResponse): SearchResponse {
 				searchQueries.push(block.input.query);
 			}
 		} else if (block.type === "web_search_tool_result" && block.content) {
+			if (!Array.isArray(block.content)) {
+				throw new SearchProviderError("anthropic", `Anthropic web search failed: ${block.content.error_code}`);
+			}
 			// Search results
 			for (const result of block.content) {
 				if (result.type === "web_search_result") {

package/src/web/search/types.ts

@@ -136,7 +136,7 @@ export interface AnthropicContentBlock {
 	/** Tool input (for type="server_tool_use") */
 	input?: { query: string };
 	/** Search results (for type="web_search_tool_result") */
-	content?: AnthropicSearchResult[];
+	content?: AnthropicSearchResult[] | { type: "web_search_tool_result_error"; error_code: string };
 }
 
 export interface AnthropicApiResponse {