@xopcai/xopc 0.0.187 → 0.0.188

package/dist/src/agent/tools/factory.d.ts

@@ -9,6 +9,7 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { Model, Api } from '@earendil-works/pi-ai';
 import type { Config } from '../../config/schema.js';
+import type { ExtensionRegistry } from '../../extensions/types/index.js';
 import type { MessageBus } from '../../infra/bus/index.js';
 import { type SkillInstallToolOptions, type SkillInstallToolResult, type MarketplaceSkillInstallToolOptions, type MarketplaceSkillInstallToolResult } from './index.js';
 import type { MemoryManager } from '../memory/manager.js';
@@ -25,7 +26,7 @@ import { type ToolExecutorConfig } from './executor.js';
 import type { CodeIntelligenceRuntimeLike } from '../code-intelligence/index.js';
 export interface ToolFactoryDeps {
     workspace: string;
-    extensionRegistry?: any;
+    extensionRegistry?: ExtensionRegistry;
     getCurrentContext: () => {
         channel: string;
         chatId: string;

package/dist/src/agent/tools/factory.js

@@ -4,6 +4,8 @@ import { isXopcDatabaseOpen } from "../../storage/sqlite/connection.js";
 import { getSessionTaskPlan, setSessionTaskPlan } from "../../storage/sqlite/session-task-plan-repository.js";
 import "../../storage/sqlite/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
+import { wrapToolsWithProtection } from "./executor.js";
+import { createDefaultExternalToolGatewayTools } from "../external-tools/index.js";
 import { createReadFileTool } from "./read.js";
 import { createWriteFileTool } from "./write.js";
 import { createListDirTool } from "./list-dir.js";
@@ -16,7 +18,6 @@ import { createFindTool } from "./find.js";
 import { createWebFetchTool, createWebSearchTool } from "./web.js";
 import { createWebExtractTool } from "./web-extract.js";
 import { createMessageTool } from "./communication.js";
-import { createComposioTools } from "./composio-tool.js";
 import { createSendMediaTool } from "./send-media.js";
 import { createReadMediaTool } from "./media-read-tool.js";
 import { createCreateShareTool, isShareToolAvailable } from "./create-share-tool.js";
@@ -49,7 +50,6 @@ import { createImageGenerateTool } from "./image-generate-tool.js";
 import "./index.js";
 import { createBrowserUseTool } from "./browser/tool/browser-use-tool.js";
 import { createWorkflowCatalog } from "../workflow/catalog.js";
-import { wrapToolsWithProtection } from "./executor.js";
 import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { createTextToSpeechTool } from "./tts-tool.js";
 import { getAgentCapabilityToolNames } from "../capabilities/registry.js";
@@ -178,15 +178,18 @@ var AgentToolsFactory = class {
 		const codeIntelligenceConfig = cfg?.codeIntelligence;
 		const agentId = options?.agentId;
 		const codeIntelligenceTools = isCodeIntelligenceEnabledForAgent(codeIntelligenceConfig, agentId) && this.deps.getCodeIntelligenceRuntime ? createCodeIntelligenceTools({ getRuntime: () => this.deps.getCodeIntelligenceRuntime(workspace) }) : [];
-		const optionalTools = [
-			imageTool,
-			imageGenerateTool,
-			...createComposioTools({
-				getConfig: () => this.deps.getConfig?.(),
-				getCurrentContext: this.deps.getCurrentContext,
-				agentId
-			})
-		].filter((t) => t != null);
+		const externalTools = createDefaultExternalToolGatewayTools({
+			workspace,
+			getConfig: () => this.deps.getConfig?.(),
+			getCurrentContext: this.deps.getCurrentContext,
+			agentId,
+			extensionRegistry: this.deps.extensionRegistry,
+			disabledTools: disabled,
+			hookRunner: this.deps.hookRunner,
+			toolExecutorConfig: this.deps.toolExecutorConfig,
+			getMemoryManager: getMemMgr
+		});
+		const optionalTools = [imageTool, imageGenerateTool].filter((t) => t != null);
 		const readTool = createReadFileTool(workspace, { profileMarkdownRoot: options?.profileMarkdownRoot });
 		const writeTool = createWriteFileTool(workspace, { profileMarkdownRoot: options?.profileMarkdownRoot });
 		const applyPatchTool = createApplyPatchTool(workspace);
@@ -223,6 +226,7 @@ var AgentToolsFactory = class {
 				}
 			}),
 			createUpdatePlanTool(),
+			...externalTools,
 			...getSkillMgr ? [
 				createSkillsListTool({
 					getSkillManager: getSkillMgr,
@@ -287,7 +291,6 @@ var AgentToolsFactory = class {
 					...this.deps.getCurrentContext?.()?.sessionKey ? { sessionKey: this.deps.getCurrentContext().sessionKey } : {}
 				})
 			})] : [],
-			...getMemMgr?.().getAdditionalTools() ?? [],
 			...this.deps.getSessionStore && getPrimary ? [createSessionSearchTool({
 				getSessionStore: this.deps.getSessionStore,
 				getPrimaryModel: getPrimary,
@@ -341,16 +344,7 @@ var AgentToolsFactory = class {
 		return ["create_desktop_pet"];
 	}
 	createAllTools(coreOptions) {
-		const coreTools = this.createCoreTools(coreOptions);
-		const disableExtensions = coreOptions?.disabledTools?.has("extensions");
-		let bundled;
-		if (!this.deps.extensionRegistry || disableExtensions) bundled = coreTools;
-		else {
-			const extensionTools = this.deps.extensionRegistry.getAllTools();
-			log.info({ count: extensionTools.length }, "Loaded extension tools");
-			bundled = [...coreTools, ...extensionTools];
-		}
-		return wrapToolsWithProtection(bundled, this.deps.toolExecutorConfig);
+		return wrapToolsWithProtection(this.createCoreTools(coreOptions), this.deps.toolExecutorConfig);
 	}
 };
 function filterToolsByDisabledSet(tools, disabled) {

package/dist/src/agent/tools/index.d.ts

@@ -12,7 +12,6 @@ export { findTool, createFindTool, type FindToolInput, type FindToolDetails, } f
 export { createWebSearchTool, createWebFetchTool } from './web.js';
 export { createWebExtractTool, stripHtmlBoilerplate, DEFAULT_WEB_EXTRACT_MAX_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, } from './web-extract.js';
 export { createMessageTool } from './communication.js';
-export { createComposioTools } from './composio-tool.js';
 export { createSendMediaTool } from './send-media.js';
 export { createReadMediaTool } from './media-read-tool.js';
 export { createCreateShareTool, isShareToolAvailable, type CreateShareToolDeps, } from './create-share-tool.js';

package/dist/src/agent/tools/index.js

@@ -14,7 +14,6 @@ import { createFindTool, findTool } from "./find.js";
 import { createWebFetchTool, createWebSearchTool } from "./web.js";
 import { DEFAULT_WEB_EXTRACT_MAX_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, createWebExtractTool, stripHtmlBoilerplate } from "./web-extract.js";
 import { createMessageTool } from "./communication.js";
-import { createComposioTools } from "./composio-tool.js";
 import { createSendMediaTool } from "./send-media.js";
 import { createReadMediaTool } from "./media-read-tool.js";
 import { createCreateShareTool, isShareToolAvailable } from "./create-share-tool.js";
@@ -43,4 +42,4 @@ import { createManagedJobTool } from "./managed-job-tool.js";
 import { resolveImageModelConfigForTool } from "../image/tool-model-config.js";
 import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool, resolveImageGenerationModelConfigForTool } from "./image-generate-tool.js";
-export { BrowserManager, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_TOOL_METADATA, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, SANDBOX_ALLOWED_TOOLS, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, buildSandboxToolMap, createApplyPatchTool, createAutomationTool, createBrowserRecipeTool, createClarifyTool, createCodeIntelligenceTools, createComposioTools, createCreateShareTool, createDelegateTool, createDesktopPetTool, createDreamingTool, createExecCommandTool, createExecuteCodeTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createListDirTool, createManagedJobTool, createMemoryGetTool, createMemorySearchTool, createMessageTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowTool, createWriteFileTool, createXopcUseTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };
+export { BrowserManager, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_TOOL_METADATA, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, SANDBOX_ALLOWED_TOOLS, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, buildSandboxToolMap, createApplyPatchTool, createAutomationTool, createBrowserRecipeTool, createClarifyTool, createCodeIntelligenceTools, createCreateShareTool, createDelegateTool, createDesktopPetTool, createDreamingTool, createExecCommandTool, createExecuteCodeTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createListDirTool, createManagedJobTool, createMemoryGetTool, createMemorySearchTool, createMessageTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowTool, createWriteFileTool, createXopcUseTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };

package/dist/src/agent/workflow/workflow-child-tools.js

@@ -1,3 +1,5 @@
+import { EXTERNAL_TOOL_NAMES } from "../external-tools/gateway-tools.js";
+import "../external-tools/index.js";
 import { AgentToolsFactory } from "../tools/factory.js";
 //#region src/agent/workflow/workflow-child-tools.ts
 /** Builds the tool set for workflow child agents (wired from gateway to avoid cycles). */
@@ -13,7 +15,11 @@ function buildWorkflowChildTools(childOptions) {
 		workspace: childOptions.workspace,
 		getPrimaryModel: () => childOptions.model,
 		agentId: childOptions.agentId,
-		disabledTools: new Set(["extensions"])
+		disabledTools: new Set([
+			EXTERNAL_TOOL_NAMES.search,
+			EXTERNAL_TOOL_NAMES.describe,
+			EXTERNAL_TOOL_NAMES.execute
+		])
 	});
 }
 //#endregion

package/dist/src/browser/providers/cloakbrowser.js

@@ -11,9 +11,9 @@ import { createReadStream, createWriteStream } from "node:fs";
 import { spawn } from "node:child_process";
 import { createHash } from "node:crypto";
 import { mkdir, mkdtemp, rm, stat } from "node:fs/promises";
+import { Readable, Transform } from "node:stream";
 import AdmZip from "adm-zip";
 import { pipeline } from "node:stream/promises";
-import { Readable, Transform } from "node:stream";
 //#region src/browser/providers/cloakbrowser.ts
 /**
 * CloakBrowser provider — anti-fingerprint Chromium with stealth capabilities.

package/dist/src/channels/channel-domain.d.ts

@@ -3,8 +3,6 @@
  */
 import type { MessageBus } from '../infra/bus/index.js';
 import type { Config } from '../config/schema.js';
-import type { ProgressStage } from '../agent/lifecycle/progress.js';
-export type { ProgressStage } from '../agent/lifecycle/progress.js';
 export type ChatType = 'direct' | 'group' | 'channel' | 'thread';
 export type DmPolicy = 'pairing' | 'allowlist' | 'open' | 'disabled';
 export type GroupPolicy = 'open' | 'disabled' | 'allowlist';
@@ -74,8 +72,6 @@ export interface ChannelSendResult {
 }
 export interface ChannelStreamHandle {
     update: (text: string) => void;
-    updateProgress?: (text: string, stage: ProgressStage, detail?: string) => void;
-    setProgress?: (stage: ProgressStage, detail?: string) => void;
     end: () => Promise<void>;
     abort: () => Promise<void>;
     messageId: () => number | undefined;

package/dist/src/channels/plugin-types.d.ts

@@ -296,8 +296,6 @@ export interface ChannelPollResult {
 export interface ChannelStreamHandle {
     update: (text: string) => void;
     updateReasoning?: (text: string) => void;
-    updateProgress?: (text: string, stage: string, detail?: string) => void;
-    setProgress?: (stage: string, detail?: string) => void;
     end: () => Promise<void>;
     abort: () => Promise<void>;
     messageId: () => number | undefined;

package/dist/src/cli/commands/doctor/checks/database-schema.js

@@ -52,7 +52,7 @@ async function checkDatabaseSchema(ctx) {
 		id: "database-schema",
 		label: "Database schema",
 		status: "pass",
-		message: `SQLite schema v${status.dbVersion} (current release v107).`,
+		message: `SQLite schema v${status.dbVersion} (current release v108).`,
 		hints: []
 	};
 }

package/dist/src/cli/commands/extension-marketplace.js

@@ -3,9 +3,9 @@ import { init_loader, loadConfig } from "../../config/loader.js";
 import { downloadExtensionStoreZipBuffer, resolveExtensionZipDownloadUrl, resolveExtensionsStoreBaseUrl, verifyStoreArtifactSha256 } from "../../agent/skills/marketplace/adapters/store/store-api-client.js";
 import { getContextWithOpts } from "../context.js";
 import { getExtensionLockfileManager } from "../../extensions/lockfile.js";
+import { fetchRegistry, findExtension, getExtensionMarketplaceStoreBaseUrl, listExtensions, searchExtensions } from "../../extensions/marketplace.js";
 import { installFromLocal, installFromNpm, peekExtensionManifestFromStoreZip } from "../../extensions/install.js";
 import { commitStagedExtensionInstall, finalizeStagedExtensionInstall, rollbackStagedExtensionInstall, stageExtensionStoreZip } from "../../extensions/install-transaction.js";
-import { fetchRegistry, findExtension, getExtensionMarketplaceStoreBaseUrl, listExtensions, searchExtensions } from "../../extensions/marketplace.js";
 import { colors } from "../utils/colors.js";
 import { validateExtensionPackageDirectory } from "./extension-pack.js";
 import { join, resolve } from "node:path";

package/dist/src/connectors/health.js

@@ -1,7 +1,7 @@
-import { listBundleMcpServerCapabilitiesForGateway } from "../agent/mcp/bundle-mcp-materialize.js";
 import { materializeConnectorMcpServer } from "./materialize.js";
 import { getConnectorInstance } from "./instances.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
+import { listBundleMcpServerCapabilitiesForGateway } from "../agent/mcp/bundle-mcp-gateway.js";
 //#region src/connectors/health.ts
 function classifyConnectorHealthError(error) {
 	const message = error instanceof Error ? error.message : String(error);

package/dist/src/extensions/extension-registry-impl.d.ts

@@ -17,6 +17,7 @@ export declare class ExtensionRegistryImpl implements ExtensionRegistry {
     services: Map<string, ExtensionService>;
     gatewayMethods: Map<string, GatewayMethodHandler>;
     tools: Map<string, AgentTool<any, any>>;
+    private toolExtensionIds;
     channelPlugins: ChannelPlugin[];
     private cliRegistrations;
     private reloadRegistrations;
@@ -36,10 +37,11 @@ export declare class ExtensionRegistryImpl implements ExtensionRegistry {
     getService(id: string): ExtensionService | undefined;
     addGatewayMethod(method: string, handler: GatewayMethodHandler): void;
     getGatewayMethod(method: string): GatewayMethodHandler | undefined;
-    addTool(tool: any): void;
+    addTool(tool: any, extensionId: string): void;
     removeTool(name: string): void;
     getTools(): Map<string, any>;
     getTool(name: string): any | undefined;
+    getToolExtensionId(name: string): string | undefined;
     getAllTools(): any[];
     addCliRegistration(reg: ExtensionCliRegistration): void;
     getCliRegistrations(): readonly ExtensionCliRegistration[];

package/dist/src/extensions/extension-registry-impl.js

@@ -11,6 +11,7 @@ var ExtensionRegistryImpl = class {
 	services = /* @__PURE__ */ new Map();
 	gatewayMethods = /* @__PURE__ */ new Map();
 	tools = /* @__PURE__ */ new Map();
+	toolExtensionIds = /* @__PURE__ */ new Map();
 	channelPlugins = [];
 	cliRegistrations = [];
 	reloadRegistrations = [];
@@ -64,12 +65,14 @@ var ExtensionRegistryImpl = class {
 	getGatewayMethod(method) {
 		return this.gatewayMethods.get(method);
 	}
-	addTool(tool) {
+	addTool(tool, extensionId) {
 		if (this.tools.has(tool.name)) log.warn({ tool: tool.name }, `Tool already registered, overwriting`);
 		this.tools.set(tool.name, tool);
+		this.toolExtensionIds.set(tool.name, extensionId);
 	}
 	removeTool(name) {
 		this.tools.delete(name);
+		this.toolExtensionIds.delete(name);
 	}
 	getTools() {
 		return this.tools;
@@ -77,6 +80,9 @@ var ExtensionRegistryImpl = class {
 	getTool(name) {
 		return this.tools.get(name);
 	}
+	getToolExtensionId(name) {
+		return this.toolExtensionIds.get(name);
+	}
 	getAllTools() {
 		return Array.from(this.tools.values());
 	}

package/dist/src/extensions/loader.js

@@ -441,7 +441,7 @@ var ExtensionLoader = class {
 				source: config.source
 			});
 			const extensionTools = api._getTools();
-			for (const tool of extensionTools.values()) this.registry.addTool(tool);
+			for (const tool of extensionTools.values()) this.registry.addTool(tool, config.id);
 			this.extensionInstances.set(config.id, api);
 			this.cache.set(cacheKey, api);
 			this.diagnostics.info(config.id, `Loaded extension: ${manifest.name}`);

package/dist/src/extensions/types/core.d.ts

@@ -237,9 +237,10 @@ export interface ExtensionService {
     stop?: () => void | Promise<void>;
 }
 export interface ExtensionRegistry {
-    addTool(tool: AgentTool): void;
+    addTool(tool: AgentTool, extensionId: string): void;
     getTools(): Map<string, AgentTool>;
     getTool(name: string): AgentTool | undefined;
+    getToolExtensionId(name: string): string | undefined;
     getAllTools(): AgentTool[];
     getCommand(name: string): ExtensionCommand | undefined;
     addCliRegistration(reg: ExtensionCliRegistration): void;

package/dist/src/extensions/update.js

@@ -4,8 +4,8 @@ import { init_paths, resolveBundledExtensionsDir, resolveExtensionsDir } from ".
 import { init_loader, loadConfig } from "../config/loader.js";
 import { downloadExtensionStoreZipBuffer, resolveExtensionZipDownloadUrl, resolveExtensionsStoreBaseUrl, verifyStoreArtifactSha256 } from "../agent/skills/marketplace/adapters/store/store-api-client.js";
 import { getExtensionLockfileManager } from "./lockfile.js";
-import { installExtensionFromStoreZip, installFromNpm } from "./install.js";
 import { findExtension } from "./marketplace.js";
+import { installExtensionFromStoreZip, installFromNpm } from "./install.js";
 import { join } from "node:path";
 import { existsSync, readFileSync, readdirSync, rmSync } from "node:fs";
 import semver from "semver";

package/dist/src/gateway/agent-builtin-tools.d.ts

@@ -2,5 +2,5 @@
  * Built-in agent tool `name` values for gateway admin UI (disable toggles).
  * Extension tools are not listed; users can still add arbitrary strings in config.
  */
-export declare const GATEWAY_BUILTIN_TOOL_IDS: readonly ["code_search", "code_read_symbol", "code_trace", "code_impact", "code_architecture", "read_file", "write_file", "apply_patch", "list_dir", "grep", "find", "exec_command", "update_plan", "session_status", "dreaming", "tool_manual", "clarify", "todo", "skills_list", "skill_view", "skill_manage", "skills_marketplace_search", "skill_install", "web_search", "web_fetch", "web_extract", "send_message", "send_media", "read_media", "create_share", "text_to_speech", "memory_search", "memory_get", "session_search", "automation", "workflow", "delegate_task", "execute_code", "image", "image_generate", "create_desktop_pet", "browser_use", "extensions", "bundle-mcp"];
+export declare const GATEWAY_BUILTIN_TOOL_IDS: readonly ["code_search", "code_read_symbol", "code_trace", "code_impact", "code_architecture", "read_file", "write_file", "apply_patch", "list_dir", "grep", "find", "exec_command", "update_plan", "session_status", "dreaming", "tool_manual", "clarify", "todo", "skills_list", "skill_view", "skill_manage", "skills_marketplace_search", "skill_install", "web_search", "web_fetch", "web_extract", "send_message", "send_media", "read_media", "create_share", "text_to_speech", "memory_search", "memory_get", "session_search", "automation", "workflow", "delegate_task", "execute_code", "image", "image_generate", "create_desktop_pet", "browser_use", "xopc_tool_search", "xopc_tool_describe", "xopc_tool_execute"];
 export type GatewayBuiltinToolId = (typeof GATEWAY_BUILTIN_TOOL_IDS)[number];

package/dist/src/gateway/agent-builtin-tools.js

@@ -1,3 +1,5 @@
+import { EXTERNAL_TOOL_NAMES } from "../agent/external-tools/gateway-tools.js";
+import "../agent/external-tools/index.js";
 //#region src/gateway/agent-builtin-tools.ts
 /**
 * Built-in agent tool `name` values for gateway admin UI (disable toggles).
@@ -46,8 +48,9 @@ const GATEWAY_BUILTIN_TOOL_IDS = [
 	"image_generate",
 	"create_desktop_pet",
 	"browser_use",
-	"extensions",
-	"bundle-mcp"
+	EXTERNAL_TOOL_NAMES.search,
+	EXTERNAL_TOOL_NAMES.describe,
+	EXTERNAL_TOOL_NAMES.execute
 ];
 //#endregion
 export { GATEWAY_BUILTIN_TOOL_IDS };

package/dist/src/gateway/chat-stream/mapper.js

@@ -1,3 +1,4 @@
+import { resolveToolActivity } from "../../../packages/gateway-contract/src/tool-activity.js";
 import { createPetFeedback } from "./pet-feedback.js";
 //#region src/gateway/chat-stream/mapper.ts
 let lastTaskPlanRevision = 0;
@@ -252,6 +253,7 @@ var ChatStreamMapper = class {
 		}
 		events.push(this.make("assistant_message_end", {
 			messageId,
+			presentation: hasToolCall(message) ? "narration" : "answer",
 			usage: extractUsage(message)
 		}));
 		this.lastAssistantMessageId = messageId;
@@ -270,7 +272,8 @@ var ChatStreamMapper = class {
 			messageId,
 			toolCallId,
 			toolName,
-			args: event.args
+			args: event.args,
+			activity: resolveToolActivity(toolName, "running")
 		})];
 		if (toolName === "exec_command") {
 			const args = asRecord(event.args);
@@ -324,6 +327,7 @@ var ChatStreamMapper = class {
 			toolCallId,
 			toolName,
 			status: event.isError ? "error" : "success",
+			activity: resolveToolActivity(toolName, event.isError ? "failed" : "completed", result),
 			result,
 			errorMessage: event.isError ? result?.text : void 0
 		})];
@@ -431,6 +435,17 @@ function userMessageFromEvent(event) {
 function extractTextFromMessage(message) {
 	return extractText(message.content);
 }
+function hasToolCall(message) {
+	const raw = message;
+	if (Array.isArray(raw.toolCalls) && raw.toolCalls.length > 0) return true;
+	if (Array.isArray(raw.tool_calls) && raw.tool_calls.length > 0) return true;
+	if (!Array.isArray(raw.content)) return false;
+	return raw.content.some((block) => {
+		if (!block || typeof block !== "object") return false;
+		const type = block.type;
+		return type === "toolCall" || type === "tool_call" || type === "tool_use";
+	});
+}
 function extractReview(message) {
 	const metadata = message.metadata;
 	const metadataReview = asRecord(metadata)?.review;

package/dist/src/gateway/chat-stream/protocol.d.ts

@@ -1,3 +1,4 @@
+import type { ToolActivity } from '@xopcai/gateway-contract';
 export type ChatStreamStatus = 'success' | 'error' | 'cancelled';
 export type PetFeedbackTaskState = 'working' | 'waiting' | 'success' | 'error';
 export type PetFeedbackSensitivity = 'public' | 'private';
@@ -58,6 +59,7 @@ export type ToolStartEvent = ChatStreamEnvelope<'tool_start', {
     toolCallId: string;
     toolName: string;
     args?: unknown;
+    activity: ToolActivity;
 }>;
 export type ToolUpdateEvent = ChatStreamEnvelope<'tool_update', {
     messageId: string;
@@ -71,6 +73,7 @@ export type ToolEndEvent = ChatStreamEnvelope<'tool_end', {
     toolCallId: string;
     toolName: string;
     status: ChatStreamStatus;
+    activity: ToolActivity;
     result?: {
         content?: unknown[];
         details?: unknown;
@@ -163,6 +166,7 @@ export type ReviewEvent = ChatStreamEnvelope<'review', {
 }>;
 export type AssistantMessageEndEvent = ChatStreamEnvelope<'assistant_message_end', {
     messageId: string;
+    presentation: 'narration' | 'answer';
     usage?: {
         inputTokens?: number;
         outputTokens?: number;

package/dist/src/gateway/file-reference-errors.d.ts

@@ -0,0 +1,6 @@
+export type FileReferenceFsError = {
+    code: 'FILE_NOT_FOUND' | 'FILE_ACCESS_DENIED' | 'FILE_ACCESS_FAILED';
+    message: string;
+    status: 404 | 403 | 500;
+};
+export declare function classifyFileReferenceFsError(err: unknown): FileReferenceFsError;

package/dist/src/gateway/file-reference-errors.js

@@ -0,0 +1,21 @@
+//#region src/gateway/file-reference-errors.ts
+function classifyFileReferenceFsError(err) {
+	const code = err?.code;
+	if (code === "ENOENT" || code === "ENOTDIR") return {
+		code: "FILE_NOT_FOUND",
+		message: "File not found",
+		status: 404
+	};
+	if (code === "EACCES" || code === "EPERM") return {
+		code: "FILE_ACCESS_DENIED",
+		message: "Gateway does not have permission to access this file",
+		status: 403
+	};
+	return {
+		code: "FILE_ACCESS_FAILED",
+		message: "Gateway could not access this file",
+		status: 500
+	};
+}
+//#endregion
+export { classifyFileReferenceFsError };

package/dist/src/gateway/heartbeat/service.js

@@ -1,9 +1,9 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { shouldSilence, stripHeartbeatToken } from "../../heartbeat/tokens.js";
-import { appendCronEventLines } from "../../heartbeat/event-prompt.js";
 import { isWithinActiveHours } from "../../heartbeat/active-hours.js";
 import { isHeartbeatContentEmpty } from "../../heartbeat/content-check.js";
+import { appendCronEventLines } from "../../heartbeat/event-prompt.js";
 import { createHeartbeatWake } from "../../heartbeat/wake.js";
 import { resolveHeartbeatMdPath } from "../workspace-heartbeat-path.js";
 import { readFile } from "fs/promises";

package/dist/src/gateway/hono/lib/config-payload.js

@@ -6,9 +6,9 @@ import { init_models_json, loadModelsJson } from "../../../config/models-json.js
 import { CredentialResolver, init_credentials } from "../../../auth/credentials.js";
 import { getProviderRegistry, init_plugin_registry } from "../../../providers/plugin-registry.js";
 import { getAllProviders, init_providers, isProviderConfigured } from "../../../providers/index.js";
+import { normalizeConfiguredMcpServers } from "../../../config/mcp-config-normalize.js";
 import { resolveShareConfig } from "../../../share/share-config.js";
 import { maskTunnelSecretForWeb } from "../../../tunnel/env.js";
-import { normalizeConfiguredMcpServers } from "../../../config/mcp-config-normalize.js";
 import { resolveSessionConfigForWeb, resolveUpdateConfigForWeb } from "../../../config/web-patch.js";
 import { GENERIC_MASKED_SECRET, maskSecretLength } from "./mask-secret-length.js";
 import { safeToolsWebForGet } from "../../config-tools-web.js";

package/dist/src/gateway/hono/routes/auth-registry-extensions.js

@@ -1,8 +1,8 @@
 import { getAllModels, getAvailableModels, init_providers } from "../../../providers/index.js";
 import { ActivationPlanner } from "../../../extensions/activation-planner.js";
 import { mergeActivationContext } from "../../../extensions/activation-context.js";
-import { fetchRegistry, listExtensions, searchExtensions } from "../../../extensions/marketplace.js";
 import { buildWhenContextSnapshot } from "../../../extensions/when-context.js";
+import { fetchRegistry, listExtensions, searchExtensions } from "../../../extensions/marketplace.js";
 import { createOAuthHandler } from "../oauth.js";
 import { createOAuthAsyncHandler } from "../oauth-async.js";
 import { extensionAssetMimeType } from "../lib/extension-assets.js";

package/dist/src/gateway/hono/routes/config-patch/misc.js

@@ -1,9 +1,9 @@
 import { ContextCompactionPolicySchema, init_config } from "../../../../user-context/config.js";
 import { BindingsConfigSchema, BrowserConfigSchema, McpConfigSchema, VoiceConfigSchema, init_schema } from "../../../../config/schema.js";
 import { CredentialResolver, init_credentials } from "../../../../auth/credentials.js";
+import { canonicalizeConfiguredMcpServer } from "../../../../config/mcp-config-normalize.js";
 import { setTuiDefaultAgentConfig } from "../../../../commands/agents.config.js";
 import { mergeTunnelConfigPatch } from "../../../../tunnel/tunnel-config.js";
-import { canonicalizeConfiguredMcpServer } from "../../../../config/mcp-config-normalize.js";
 import { mergeGatewaySkillsMarketplacePatch, mergeSessionConfigPatch, mergeUpdateConfigPatch } from "../../../../config/web-patch.js";
 import { assertGatewayAuthConfigured, resolveGatewayAuth } from "../../../auth.js";
 import { isMaskedSecretPatchValue } from "../../lib/mask-secret-length.js";

package/dist/src/gateway/hono/routes/mcp.js

@@ -1,8 +1,8 @@
 import { canonicalizeConfiguredMcpServer, normalizeConfiguredMcpServers } from "../../../config/mcp-config-normalize.js";
 import { loadMergedBundleMcpConfig } from "../../../agent/mcp/bundle-mcp-config.js";
-import { listBundleMcpServerCapabilitiesForGateway, listBundleMcpServerToolsForGateway } from "../../../agent/mcp/bundle-mcp-materialize.js";
 import { isManagedConnectorServer } from "../../../connectors/materialize.js";
 import { getWorkspacePath } from "../../../config/workspace-path-helpers.js";
+import { listBundleMcpServerCapabilitiesForGateway, listBundleMcpServerToolsForGateway } from "../../../agent/mcp/bundle-mcp-gateway.js";
 //#region src/gateway/hono/routes/mcp.ts
 function registerMcpRoutes(authenticated, deps) {
 	authenticated.get("/api/mcp/servers", (c) => {

package/dist/src/gateway/hono/routes/projects.js

@@ -17,6 +17,7 @@ import "../../../projects/index.js";
 import { TaskApplicationService } from "../../../tasks/task-application-service.js";
 import { defineTaskContract } from "../../../tasks/task-contract-definition.js";
 import "../../../tasks/index.js";
+import { classifyFileReferenceFsError } from "../../file-reference-errors.js";
 import { createGatewayRouteLogger } from "../lib/route-logger.js";
 import { parseActivityIncludeRelated, parseActivityQuery } from "./activity.js";
 import { fuzzySearchWorkspaceFiles } from "../../workspace-file-search.js";
@@ -996,6 +997,7 @@ function registerProjectsRoutes(authenticated, deps) {
 			}
 		}, resolved.status);
 		let st = null;
+		let statError = null;
 		let absolutePath = resolved.absolutePath;
 		try {
 			absolutePath = await realpath(resolved.absolutePath);
@@ -1007,22 +1009,41 @@ function registerProjectsRoutes(authenticated, deps) {
 				}
 			}, 400);
 			st = await stat(absolutePath);
-		} catch {
-			st = null;
+		} catch (err) {
+			statError = err;
 		}
 		const displayName = path$1.basename(rawPath);
-		if (!st) return c.json({
-			ok: true,
-			payload: {
-				inputPath: rawPath,
-				displayName,
-				scope: "missing",
-				exists: false,
-				absolutePath: resolved.absolutePath,
-				capabilities: ["copyPath"],
-				errorCode: "FILE_NOT_FOUND"
+		if (!st) {
+			const failure = classifyFileReferenceFsError(statError);
+			if (failure.code !== "FILE_NOT_FOUND") {
+				log.warn({
+					err: statError,
+					projectId: resolved.projectId,
+					workspaceRoot: resolved.root,
+					candidate: resolved.absolutePath,
+					errorCode: failure.code
+				}, `Project file reference access failed: ${failure.message}`);
+				return c.json({
+					ok: false,
+					error: {
+						code: failure.code,
+						message: failure.message
+					}
+				}, failure.status === 403 ? 403 : 500);
 			}
-		});
+			return c.json({
+				ok: true,
+				payload: {
+					inputPath: rawPath,
+					displayName,
+					scope: "missing",
+					exists: false,
+					absolutePath: resolved.absolutePath,
+					capabilities: ["copyPath"],
+					errorCode: "FILE_NOT_FOUND"
+				}
+			});
+		}
 		return c.json({
 			ok: true,
 			payload: {

package/dist/src/gateway/hono/routes/workflows.js

@@ -7,9 +7,9 @@ import { messagesToClientHistory } from "../../../session/client-history.js";
 import "../../../workflows/domain/index.js";
 import { resolveWorkflowRunArtifactsDir } from "../../../workflows/store/paths.js";
 import { WorkflowDraftService } from "../../../workflows/draft/workflow-draft-service.js";
+import "../../../workflows/draft/index.js";
 import { WorkflowDraftConflictError, WorkflowDraftStore } from "../../../workflows/authoring/workflow-draft-store.js";
 import "../../../workflows/authoring/index.js";
-import "../../../workflows/draft/index.js";
 import { basename, join } from "node:path";
 import { readFile, stat } from "node:fs/promises";
 //#region src/gateway/hono/routes/workflows.ts