@f5-sales-demo/xcsh 20.4.4 → 20.4.5

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5-sales-demo/xcsh",
-	"version": "20.4.4",
+	"version": "20.4.5",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5-sales-demo/xcsh",
 	"author": "Can Boluk",
@@ -60,13 +60,13 @@
 	"dependencies": {
 		"@agentclientprotocol/sdk": "1.3.0",
 		"@mozilla/readability": "^0.6",
-		"@f5-sales-demo/xcsh-stats": "20.4.4",
-		"@f5-sales-demo/pi-agent-core": "20.4.4",
-		"@f5-sales-demo/pi-ai": "20.4.4",
-		"@f5-sales-demo/pi-natives": "20.4.4",
-		"@f5-sales-demo/pi-resource-management": "20.4.4",
-		"@f5-sales-demo/pi-tui": "20.4.4",
-		"@f5-sales-demo/pi-utils": "20.4.4",
+		"@f5-sales-demo/xcsh-stats": "20.4.5",
+		"@f5-sales-demo/pi-agent-core": "20.4.5",
+		"@f5-sales-demo/pi-ai": "20.4.5",
+		"@f5-sales-demo/pi-natives": "20.4.5",
+		"@f5-sales-demo/pi-resource-management": "20.4.5",
+		"@f5-sales-demo/pi-tui": "20.4.5",
+		"@f5-sales-demo/pi-utils": "20.4.5",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.20",

package/src/browser/extension-bridge-tools.ts

@@ -104,9 +104,10 @@ export const BROWSER_TOOL_NAMES: readonly string[] = [
  * local xcsh agent, so it gets the same general-purpose native tools the CLI has —
  * `bash` (so it can shell out to `az`, `gh`, terraform, git, …), the file tools
  * (`read`/`write`/`edit`), search (`grep`), plus planning (`todo_write`,
- * `task`) and `calc`. (File-finding is covered by `bash`; the builtin `find`
- * tool is omitted because its name collides with a browser tool.) The document's own Excel/PowerPoint/Word tools arrive at
- * runtime over the bridge via `set_host_tools`.
+ * `task`), `calc`, and image analysis (`inspect_image`). (File-finding is covered
+ * by `bash`; the builtin `find` tool is omitted because its name collides with a
+ * browser tool.) The document's own Excel/PowerPoint/Word tools arrive at runtime
+ * over the bridge via `set_host_tools`.
  *
  * DELIBERATELY EXCLUDED:
  *  - Every {@link BROWSER_TOOL_NAMES} entry — there is no browser to drive in a
@@ -143,4 +144,5 @@ export const OFFICE_TOOL_NAMES: readonly string[] = [
 	"todo_write",
 	"task",
 	"calc",
+	"inspect_image",
 ];

package/src/browser/headless-bridge.ts

@@ -142,7 +142,7 @@ export async function startHeadlessChatBridge(deps: HeadlessBridgeDeps = default
 	// the rethrow as a non-fatal "pane only" fallback.
 	try {
 		// Create ONE headless Office session with the full CLI-parity builtin set
-		// (OFFICE_TOOL_NAMES: bash/read/write/edit/grep/find/… — NO browser tools, which
+		// (OFFICE_TOOL_NAMES: bash/read/write/edit/grep/inspect_image/… — NO browser tools, which
 		// would be hallucinated in a document task pane). The document's own tools
 		// (Excel/Word/PowerPoint) arrive at runtime via set_host_tools.
 		const { session } = await deps.createAgentSession({

package/src/config/auto-config.ts

@@ -81,6 +81,9 @@ export function generateModelsYml(baseUrl: string, options?: GenerateModelsYmlOp
 		"    modelOverrides:",
 		"      gpt-5.6-sol:",
 		"        reasoning: true",
+		"        input:",
+		"          - text",
+		"          - image",
 		"        thinking:",
 		"          mode: effort",
 		"          minLevel: low",

package/src/config/model-registry.ts

@@ -2,6 +2,7 @@ import * as path from "node:path";
 import {
 	type Api,
 	type AssistantMessageEventStream,
+	applyGeneratedModelPolicies,
 	type Context,
 	createModelManager,
 	DEFAULT_LOCAL_TOKEN,
@@ -1227,6 +1228,7 @@ export class ModelRegistry {
 					return {
 						...model,
 						baseUrl: existing.baseUrl,
+						input: existing.input.includes("image") ? ["text", "image"] : model.input,
 						headers: existing.headers ? { ...existing.headers, ...model.headers } : model.headers,
 					};
 				}
@@ -1810,6 +1812,10 @@ export class ModelRegistry {
 		});
 	}
 	#applyHardcodedModelPolicies(models: Model<Api>[]): Model<Api>[] {
+		// Discovery caches contain provider-advertised metadata, which can lag the
+		// bundled corrections. Reapply generated-model policy before a cached entry
+		// replaces its bundled peer; explicit user overrides still run afterward.
+		applyGeneratedModelPolicies(models);
 		return models.map(model => {
 			if (model.id !== "gpt-5.4" || model.provider === "github-copilot") {
 				return model;

package/src/config/settings-schema.ts

@@ -157,16 +157,16 @@ const DEFAULT_CYCLE_ORDER: string[] = ["smol", "default", "slow"];
 /**
  * Binary-baked default model role. Ships in the binary so a fresh install needs
  * NO `~/.xcsh/agent/config.yml` — `/login` only supplies the (PII) proxy URL + key.
- * Claude Opus 5 High is the vision-capable production default through the
- * Anthropic route on LiteLLM. Keep the effort explicit in the role so returning
+ * GPT-5.6 Sol High is the vision-capable production default through the OpenAI
+ * Chat Completions route on LiteLLM. Keep the effort explicit in the role so returning
  * from a lower-effort role cannot inherit that role's effort.
  */
-export const DEFAULT_MODEL_ROLE = "anthropic/claude-opus-5:high";
+export const DEFAULT_MODEL_ROLE = "litellm/gpt-5.6-sol:high";
 /** Fast role for lightweight work (commit messages, titles, memory summaries). */
 const SMOL_MODEL_ROLE = "litellm/gpt-5.6-sol:low";
 /**
  * Baked role map. `smol` keeps GPT-5.6 Sol at low effort for latency-sensitive
- * work; both `default` and `slow` restore vision-capable Claude Opus 5 High.
+ * work; both `default` and `slow` restore vision-capable GPT-5.6 Sol High.
  */
 const DEFAULT_MODEL_ROLES: Record<string, string> = {
 	default: DEFAULT_MODEL_ROLE,

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

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "20.4.4",
-	"commit": "5ce2d7f85623545438b57f742f095a5be4352be0",
-	"shortCommit": "5ce2d7f",
+	"version": "20.4.5",
+	"commit": "0ccf19916f316fb84d06bd9a5a9ab36bd67d8759",
+	"shortCommit": "0ccf199",
 	"branch": "main",
-	"tag": "v20.4.4",
-	"commitDate": "2026-08-05T08:27:37Z",
-	"buildDate": "2026-08-05T08:57:05.754Z",
+	"tag": "v20.4.5",
+	"commitDate": "2026-08-05T09:48:31Z",
+	"buildDate": "2026-08-05T10:16:36.684Z",
 	"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/5ce2d7f85623545438b57f742f095a5be4352be0",
-	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v20.4.4"
+	"commitUrl": "https://github.com/f5-sales-demo/xcsh/commit/0ccf19916f316fb84d06bd9a5a9ab36bd67d8759",
+	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v20.4.5"
 };

package/src/prompts/tools/task-summary.md

@@ -6,7 +6,11 @@
 <status>{{status}}</status>
 {{#if meta}}<meta lines="{{meta.lineCount}}" size="{{meta.charSize}}" />{{/if}}
 {{#if truncated}}
-<preview full-path="agent://{{id}}">
+{{#if fullOutputUrl}}
+<preview full-path="{{fullOutputUrl}}">
+{{else}}
+<preview>
+{{/if}}
 {{preview}}
 </preview>
 {{else}}

package/src/task/index.ts

@@ -24,7 +24,7 @@ import type { Theme } from "../modes/theme/theme";
 import planModeSubagentPrompt from "../prompts/system/plan-mode-subagent.md" with { type: "text" };
 import taskDescriptionTemplate from "../prompts/tools/task.md" with { type: "text" };
 import taskSummaryTemplate from "../prompts/tools/task-summary.md" with { type: "text" };
-import { formatBytes, formatDuration } from "../tools/render-utils";
+import { formatDuration } from "../tools/render-utils";
 // Import review tools for side effects (registers subagent tool handlers)
 import "../tools/review";
 import { generateCommitMessage } from "../utils/commit-message-generator";
@@ -35,6 +35,7 @@ import { resolveIsolationBackendForTaskExecution } from "./isolation-backend";
 import { AgentOutputManager } from "./output-manager";
 import { mapWithConcurrencyLimit, Semaphore } from "./parallel";
 import { renderCall, renderResult } from "./render";
+import { buildTaskOutputSummaries } from "./summary";
 import { renderTemplate } from "./template";
 import {
 	type AgentDefinition,
@@ -108,6 +109,7 @@ export { loadBundledAgents as BUNDLED_AGENTS } from "./agents";
 export { discoverCommands, expandCommand, getCommand } from "./commands";
 export { discoverAgents, getAgent } from "./discovery";
 export { AgentOutputManager } from "./output-manager";
+export { buildTaskOutputSummaries, type TaskOutputSummary } from "./summary";
 export type {
 	AgentDefinition,
 	AgentProgress,
@@ -1123,41 +1125,8 @@ export class TaskTool implements AgentTool<TaskSchema, TaskToolDetails, Theme> {
 			const successCount = results.filter(r => r.exitCode === 0 && !r.error && !r.aborted).length;
 			const totalDuration = Date.now() - startTime;
 
-			const summaries = results.map(r => {
-				const status = r.aborted
-					? "cancelled"
-					: r.exitCode === 0 && r.error
-						? "merge failed"
-						: r.exitCode === 0
-							? "completed"
-							: `failed (exit ${r.exitCode})`;
-				const output = r.output.trim() || r.stderr.trim() || "(no output)";
-				const outputCharCount = r.outputMeta?.charCount ?? output.length;
-				const fullOutputThreshold = 5000;
-				let preview = output;
-				let truncated = false;
-				if (outputCharCount > fullOutputThreshold) {
-					const slice = output.slice(0, fullOutputThreshold);
-					const lastNewline = slice.lastIndexOf("\n");
-					preview = lastNewline >= 0 ? slice.slice(0, lastNewline) : slice;
-					truncated = true;
-				}
-				return {
-					agent: r.agent,
-					status,
-					id: r.id,
-					preview,
-					truncated,
-					meta: r.outputMeta
-						? {
-								lineCount: r.outputMeta.lineCount,
-								charSize: formatBytes(r.outputMeta.charCount),
-							}
-						: undefined,
-				};
-			});
+			const summaries = buildTaskOutputSummaries(results, artifactsDir !== null);
 
-			const outputIds = results.filter(r => !r.aborted || r.output.trim()).map(r => `agent://${r.id}`);
 			const backendSummaryPrefix = isolationBackendWarning ? `\n\n${isolationBackendWarning}` : "";
 			const summary = prompt.render(taskSummaryTemplate, {
 				successCount,
@@ -1166,7 +1135,6 @@ export class TaskTool implements AgentTool<TaskSchema, TaskToolDetails, Theme> {
 				hasCancelledNote: aborted && cancelledCount > 0,
 				duration: formatDuration(totalDuration),
 				summaries,
-				outputIds,
 				agentName,
 				mergeSummary: `${backendSummaryPrefix}${mergeSummary}`,
 			});

package/src/task/summary.ts

@@ -0,0 +1,53 @@
+import { formatBytes } from "../tools/render-utils";
+import type { SingleResult } from "./types";
+
+export interface TaskOutputSummary {
+	agent: string;
+	status: string;
+	id: string;
+	preview: string;
+	truncated: boolean;
+	fullOutputUrl?: string;
+	meta?: { lineCount: number; charSize: string };
+}
+
+/** Build the model-facing task summaries and their optional persistent output references. */
+export function buildTaskOutputSummaries(
+	results: SingleResult[],
+	hasPersistentArtifacts: boolean,
+): TaskOutputSummary[] {
+	return results.map(result => {
+		const status = result.aborted
+			? "cancelled"
+			: result.exitCode === 0 && result.error
+				? "merge failed"
+				: result.exitCode === 0
+					? "completed"
+					: `failed (exit ${result.exitCode})`;
+		const output = result.output.trim() || result.stderr.trim() || "(no output)";
+		const outputCharCount = result.outputMeta?.charCount ?? output.length;
+		const fullOutputThreshold = 5000;
+		let preview = output;
+		let truncated = false;
+		if (outputCharCount > fullOutputThreshold) {
+			const slice = output.slice(0, fullOutputThreshold);
+			const lastNewline = slice.lastIndexOf("\n");
+			preview = lastNewline >= 0 ? slice.slice(0, lastNewline) : slice;
+			truncated = true;
+		}
+		return {
+			agent: result.agent,
+			status,
+			id: result.id,
+			preview,
+			truncated,
+			...(truncated && hasPersistentArtifacts ? { fullOutputUrl: `agent://${result.id}` } : {}),
+			meta: result.outputMeta
+				? {
+						lineCount: result.outputMeta.lineCount,
+						charSize: formatBytes(result.outputMeta.charCount),
+					}
+				: undefined,
+		};
+	});
+}