@bike4mind/cli 0.10.0 → 0.10.1

package/dist/{ConfigStore-DPWN3-0c.mjs → ConfigStore-aeJGqjKm.mjs}

@@ -1002,6 +1002,8 @@ let ApiKeyScope = /* @__PURE__ */ function(ApiKeyScope) {
 	*  radius of a sprite-spawning credential, not a billable AI key. */
 	ApiKeyScope["CC_BRIDGE"] = "cc-bridge:connect";
 	ApiKeyScope["ADMIN"] = "admin:*";
+	ApiKeyScope["MARKETING_REPORTS_READ"] = "marketing-reports:read";
+	ApiKeyScope["MARKETING_REPORTS_WRITE"] = "marketing-reports:write";
 	return ApiKeyScope;
 }({});
 /** Valid document types that can be favorited */
@@ -3667,6 +3669,8 @@ z.enum([
 	"EnableRapidReplyDefault",
 	"EnableLattice",
 	"EnableLatticeDefault",
+	"EnableDataLakes",
+	"EnableDataLakesDefault",
 	"RapidReplySettings",
 	"EnableResearchEngine",
 	"EnableResearchEngineDefault",
@@ -5039,6 +5043,25 @@ const settingsMap = {
 		group: API_SERVICE_GROUPS.NOTEBOOK.id,
 		order: 1
 	}),
+	EnableDataLakes: makeBooleanSetting({
+		key: "EnableDataLakes",
+		name: "Enable Data Lakes",
+		defaultValue: false,
+		description: "Server-side gate for the Data Lake capability (bulk folder ingestion). Off by default — turn on to expose the data-lake APIs and wizard.",
+		category: "Experimental",
+		group: API_SERVICE_GROUPS.EXPERIMENTAL.id,
+		order: 88
+	}),
+	EnableDataLakesDefault: makeBooleanSetting({
+		key: "EnableDataLakesDefault",
+		name: "Data Lakes: On by default for users",
+		defaultValue: false,
+		description: "When enabled, Data Lakes is active for users who have never explicitly toggled it.",
+		category: "Experimental",
+		group: API_SERVICE_GROUPS.EXPERIMENTAL.id,
+		order: 89,
+		dependsOn: "EnableDataLakes"
+	}),
 	EnableQuestMaster: makeBooleanSetting({
 		key: "EnableQuestMaster",
 		name: "Enable Quest Master",
@@ -7661,18 +7684,36 @@ z$1.object({
 	slug: z$1.string().min(2).max(60).regex(slugRegex, "Slug must be lowercase alphanumeric with hyphens (e.g. \"my-data-lake\")"),
 	description: z$1.string().max(2e3).optional(),
 	fileTagPrefix: z$1.string().min(2).max(30).refine((s) => s.endsWith(":"), "Tag prefix must end with \":\" (e.g. \"acme:\")"),
-	requiredUserTag: z$1.string().min(1).max(100).optional(),
-	organizationId: z$1.string().optional()
+	requiredUserTag: z$1.string().min(1).max(100).optional()
 });
 z$1.object({
 	name: z$1.string().min(1).max(200).optional(),
 	description: z$1.string().max(2e3).optional(),
-	requiredUserTag: z$1.string().min(1).max(100).optional(),
-	status: z$1.enum(["active", "archived"]).optional()
+	requiredUserTag: z$1.string().min(1).max(100).optional()
 });
 z$1.object({
 	organizationId: z$1.string().optional(),
-	status: z$1.enum(["active", "archived"]).optional()
+	status: z$1.enum([
+		"draft",
+		"active",
+		"archived",
+		"deleted"
+	]).optional()
+});
+const ConflictResolutionSchema = z$1.enum([
+	"skip",
+	"update",
+	"duplicate"
+]);
+z$1.object({
+	dataLakeId: z$1.string(),
+	totalFiles: z$1.number().positive(),
+	totalSizeBytes: z$1.number().nonnegative(),
+	conflictResolution: ConflictResolutionSchema.optional(),
+	appliedTags: z$1.array(z$1.object({
+		name: z$1.string(),
+		strength: z$1.number()
+	})).optional()
 });
 const BatchPresignedUrlFileItem = z$1.object({
 	fileName: z$1.string().min(1),
@@ -7687,7 +7728,13 @@ const BatchPresignedUrlFileItem = z$1.object({
 });
 z$1.object({
 	files: z$1.array(BatchPresignedUrlFileItem).min(1).max(100),
-	dataLakeSlug: z$1.string().optional()
+	dataLakeSlug: z$1.string().optional(),
+	/**
+	* When uploading into a data lake batch, the batch id so each created FabFile is
+	* correlated to the batch (stamped with batchId) AND appended to the batch
+	* manifest. Without it the pipeline can't track batch progress.
+	*/
+	batchId: z$1.string().optional()
 });
 const InferTaxonomyFolderEntry = z$1.object({
 	relativePath: z$1.string(),
@@ -7713,7 +7760,9 @@ const SyncDeltaFileEntry = z$1.object({
 });
 z$1.object({
 	dataLakeSlug: z$1.string(),
-	currentFiles: z$1.array(SyncDeltaFileEntry).min(1).max(1e4)
+	currentFiles: z$1.array(SyncDeltaFileEntry).min(1).max(1e4),
+	/** Per-request dedup policy for files whose content hash already exists. Defaults to 'skip'. */
+	conflictResolution: ConflictResolutionSchema.optional()
 });
 z$1.object({
 	dataLakeSlug: z$1.string(),

package/dist/commands/apiCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as ConfigStore } from "../ConfigStore-DPWN3-0c.mjs";
+import { t as ConfigStore } from "../ConfigStore-aeJGqjKm.mjs";
 //#region src/commands/apiCommand.ts
 /**
 * External API config command (--api-url / --reset-api)

package/dist/commands/doctorCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as version, n as compareSemver, r as fetchLatestVersion } from "../updateChecker-C3DYG0Gn.mjs";
+import { a as version, n as compareSemver, r as fetchLatestVersion } from "../updateChecker-CP_jeER9.mjs";
 import { t as checkRipgrep } from "../ripgrepCheck-BmkyTK2i.mjs";
 import { execSync } from "child_process";
 import { constants, existsSync, promises } from "fs";

package/dist/commands/headlessCommand.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { C as WebSocketToolExecutor, D as ServerLlmBackend, E as WebSocketLlmBackend, F as PermissionManager, I as generateCliTools, M as loadContextFiles, N as getApiUrl, O as McpManager, Q as CheckpointStore, S as ApiClient, T as FallbackLlmBackend, W as setWebSocketToolExecutor, X as ReActAgent, Y as isReadOnlyTool, Z as CustomCommandStore, _ as createAgentDelegateTool, b as createSkillTool, d as createFindDefinitionTool, et as SessionStore, f as createTodoStore, g as BackgroundAgentManager, h as createBackgroundAgentTools, m as createCoordinateTaskTool, p as createWriteTodosTool, q as buildSystemPrompt, u as createGetFileStructureTool, v as AgentStore, w as WebSocketConnectionManager, y as SubagentOrchestrator } from "../tools-_X4rUM4L.mjs";
-import { n as logger, t as ConfigStore } from "../ConfigStore-DPWN3-0c.mjs";
+import { C as WebSocketToolExecutor, D as ServerLlmBackend, E as WebSocketLlmBackend, F as PermissionManager, I as generateCliTools, M as loadContextFiles, N as getApiUrl, O as McpManager, Q as CheckpointStore, S as ApiClient, T as FallbackLlmBackend, W as setWebSocketToolExecutor, X as ReActAgent, Y as isReadOnlyTool, Z as CustomCommandStore, _ as createAgentDelegateTool, b as createSkillTool, d as createFindDefinitionTool, et as SessionStore, f as createTodoStore, g as BackgroundAgentManager, h as createBackgroundAgentTools, m as createCoordinateTaskTool, p as createWriteTodosTool, q as buildSystemPrompt, u as createGetFileStructureTool, v as AgentStore, w as WebSocketConnectionManager, y as SubagentOrchestrator } from "../tools-RdGu37Lw.mjs";
+import { n as logger, t as ConfigStore } from "../ConfigStore-aeJGqjKm.mjs";
 import { t as DEFAULT_SANDBOX_CONFIG } from "../types-LyRNHOiS.mjs";
 import { t as createSandboxRuntime } from "../SandboxRuntimeAdapter-ChGlxSGQ.mjs";
 import { t as SandboxOrchestrator } from "../SandboxOrchestrator-BoINxbX4.mjs";

package/dist/commands/mcpCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as ConfigStore } from "../ConfigStore-DPWN3-0c.mjs";
+import { t as ConfigStore } from "../ConfigStore-aeJGqjKm.mjs";
 //#region src/commands/mcpCommand.ts
 /**
 * External MCP commands (b4m mcp list, b4m mcp add, etc.)

package/dist/commands/updateCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as version, i as forceCheckForUpdate } from "../updateChecker-C3DYG0Gn.mjs";
+import { a as version, i as forceCheckForUpdate } from "../updateChecker-CP_jeER9.mjs";
 import { t as checkRipgrep } from "../ripgrepCheck-BmkyTK2i.mjs";
 import { execSync } from "child_process";
 //#region src/commands/updateCommand.ts

package/dist/index.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { $ as CommandHistoryStore, A as formatStep, B as DEFAULT_RETRY_CONFIG, C as WebSocketToolExecutor, D as ServerLlmBackend, E as WebSocketLlmBackend, F as PermissionManager, G as OllamaBackend, H as clearFeatureModuleTools, I as generateCliTools, J as buildSkillsPromptSection, K as getPlanModeFilePath, L as ALWAYS_DENIED_FOR_AGENTS, M as loadContextFiles, N as getApiUrl, O as McpManager, P as getEnvironmentName, Q as CheckpointStore, R as DEFAULT_AGENT_MODEL, S as ApiClient, T as FallbackLlmBackend, U as registerFeatureModuleTools, V as DEFAULT_THOROUGHNESS, W as setWebSocketToolExecutor, X as ReActAgent, Y as isReadOnlyTool, Z as CustomCommandStore, _ as createAgentDelegateTool, a as createBlockerTools, at as mergeCommands, b as createSkillTool, c as createDecisionStore, ct as warmFileCache, d as createFindDefinitionTool, et as SessionStore, f as createTodoStore, g as BackgroundAgentManager, h as createBackgroundAgentTools, i as createBlockerStore, it as searchCommands, j as extractCompactInstructions, k as substituteArguments, l as formatDecisionsOutput, m as createCoordinateTaskTool, n as createReviewGateTool, nt as hasFileReferences, o as formatBlockersOutput, ot as formatFileSize, p as createWriteTodosTool, q as buildSystemPrompt, r as formatReviewGatesOutput, rt as processFileReferences, s as createDecisionLogTool, st as searchFiles, t as createReviewGateStore, tt as OAuthClient, u as createGetFileStructureTool, v as AgentStore, w as WebSocketConnectionManager, x as parseAgentConfig, y as SubagentOrchestrator, z as DEFAULT_MAX_ITERATIONS } from "./tools-_X4rUM4L.mjs";
+import { $ as CommandHistoryStore, A as formatStep, B as DEFAULT_RETRY_CONFIG, C as WebSocketToolExecutor, D as ServerLlmBackend, E as WebSocketLlmBackend, F as PermissionManager, G as OllamaBackend, H as clearFeatureModuleTools, I as generateCliTools, J as buildSkillsPromptSection, K as getPlanModeFilePath, L as ALWAYS_DENIED_FOR_AGENTS, M as loadContextFiles, N as getApiUrl, O as McpManager, P as getEnvironmentName, Q as CheckpointStore, R as DEFAULT_AGENT_MODEL, S as ApiClient, T as FallbackLlmBackend, U as registerFeatureModuleTools, V as DEFAULT_THOROUGHNESS, W as setWebSocketToolExecutor, X as ReActAgent, Y as isReadOnlyTool, Z as CustomCommandStore, _ as createAgentDelegateTool, a as createBlockerTools, at as mergeCommands, b as createSkillTool, c as createDecisionStore, ct as warmFileCache, d as createFindDefinitionTool, et as SessionStore, f as createTodoStore, g as BackgroundAgentManager, h as createBackgroundAgentTools, i as createBlockerStore, it as searchCommands, j as extractCompactInstructions, k as substituteArguments, l as formatDecisionsOutput, m as createCoordinateTaskTool, n as createReviewGateTool, nt as hasFileReferences, o as formatBlockersOutput, ot as formatFileSize, p as createWriteTodosTool, q as buildSystemPrompt, r as formatReviewGatesOutput, rt as processFileReferences, s as createDecisionLogTool, st as searchFiles, t as createReviewGateStore, tt as OAuthClient, u as createGetFileStructureTool, v as AgentStore, w as WebSocketConnectionManager, x as parseAgentConfig, y as SubagentOrchestrator, z as DEFAULT_MAX_ITERATIONS } from "./tools-RdGu37Lw.mjs";
 import { n as useCliStore, t as selectActiveBackgroundAgents } from "./store-DV5s-qni.mjs";
-import { Xt as validateNotebookPath$1, Yt as validateJupyterKernelName, g as CREDIT_DEDUCT_TRANSACTION_TYPES, n as logger, t as ConfigStore, v as ChatModels } from "./ConfigStore-DPWN3-0c.mjs";
-import { a as version, t as checkForUpdate } from "./updateChecker-C3DYG0Gn.mjs";
+import { Xt as validateNotebookPath$1, Yt as validateJupyterKernelName, g as CREDIT_DEDUCT_TRANSACTION_TYPES, n as logger, t as ConfigStore, v as ChatModels } from "./ConfigStore-aeJGqjKm.mjs";
+import { a as version, t as checkForUpdate } from "./updateChecker-CP_jeER9.mjs";
 import React, { useCallback, useEffect, useMemo, useReducer, useRef, useState } from "react";
 import { Box, Static, Text, render, useApp, useInput, usePaste, useStdout } from "ink";
 import { execSync } from "child_process";
@@ -3761,6 +3761,196 @@ Unlike agent_delegate (which uses pre-defined agents), this tool lets you compos
 	};
 }
 //#endregion
+//#region src/tools/deferredToolRegistry.ts
+/**
+* Registry of tool schemas that are NOT loaded into the model's initial tool
+* list. The model sees only the names (via the system prompt directory) and
+* must call the `tool_search` meta-tool to load schemas on demand.
+*
+* This mirrors Claude Code's deferred-tool pattern. The win is large for
+* heavy MCP integrations (e.g. 41 GitHub MCP tools at ~250-350 tokens of
+* JSONSchema each = ~10-15k tokens per turn that's now ~1-1.5k of names).
+*/
+var DeferredToolRegistry = class {
+	constructor() {
+		this.byName = /* @__PURE__ */ new Map();
+	}
+	/** Replace registry contents with the supplied tools. Idempotent. */
+	register(tools) {
+		this.byName.clear();
+		for (const tool of tools) this.byName.set(tool.toolSchema.name, tool);
+		logger.debug(`[DeferredToolRegistry] Registered ${tools.length} deferred tool(s)`);
+	}
+	clear() {
+		this.byName.clear();
+	}
+	size() {
+		return this.byName.size;
+	}
+	has(name) {
+		return this.byName.has(name);
+	}
+	get(name) {
+		return this.byName.get(name);
+	}
+	getAll() {
+		return Array.from(this.byName.values());
+	}
+	/** Return tools whose names appear in the supplied list, in input order. */
+	getByNames(names) {
+		const found = [];
+		for (const name of names) {
+			const tool = this.byName.get(name);
+			if (tool) found.push(tool);
+		}
+		return found;
+	}
+	/**
+	* Rank-search deferred tools by query terms. Name matches outrank
+	* description matches; exact substring on name wins ties.
+	*/
+	searchByKeywords(query, maxResults) {
+		const terms = query.toLowerCase().split(/\s+/).filter((t) => t.length > 0);
+		if (terms.length === 0) return [];
+		const scored = [];
+		for (const tool of this.byName.values()) {
+			const name = tool.toolSchema.name.toLowerCase();
+			const desc = (tool.toolSchema.description || "").toLowerCase();
+			let score = 0;
+			for (const term of terms) {
+				if (name.includes(term)) score += 10;
+				if (desc.includes(term)) score += 1;
+			}
+			if (score > 0) scored.push({
+				tool,
+				score
+			});
+		}
+		scored.sort((a, b) => b.score - a.score);
+		return scored.slice(0, maxResults).map((s) => s.tool);
+	}
+	/** Return the directory entries used to render the system-prompt reminder. */
+	getDirectoryNames() {
+		return Array.from(this.byName.keys()).sort();
+	}
+};
+const deferredToolRegistry = new DeferredToolRegistry();
+//#endregion
+//#region src/tools/toolSearchTool.ts
+/**
+* Default number of tools returned for a keyword search. Matches Claude
+* Code's ToolSearch convention. 5 keeps the response payload small while
+* surfacing enough alternatives for the model to refine its query.
+*/
+const DEFAULT_MAX_RESULTS = 5;
+/**
+* Runtime validation for tool_search params. The LLM produces these
+* values, so we validate at this boundary rather than trusting the
+* shape. Coerces `max_results` from string→number for models that emit
+* numeric-looking strings.
+*/
+const ToolSearchParamsSchema = z.object({
+	query: z.string().min(1, "query must be a non-empty string"),
+	max_results: z.coerce.number().int().min(1).max(20).optional()
+});
+/**
+* Parse the query string. Two forms:
+*   - `select:name1,name2,...` — exact-name selection
+*   - free text — keyword search across name + description
+*/
+function parseQuery(query) {
+	const trimmed = query.trim();
+	const selectMatch = trimmed.match(/^select:(.+)$/i);
+	if (selectMatch) return {
+		mode: "select",
+		names: selectMatch[1].split(",").map((n) => n.trim()).filter((n) => n.length > 0)
+	};
+	return {
+		mode: "search",
+		text: trimmed
+	};
+}
+/**
+* Format the loaded-tools response. Mirrors Claude Code's convention:
+* one <function>{...}</function> line per matched tool. The model has
+* already seen this format in its tool-registration system messages, so
+* it parses without additional explanation.
+*
+* Note: the schemas are *also* injected into context.tools by the caller,
+* so on the next iteration the model gets them as native tool definitions.
+* The text response here is for in-turn awareness and audit trail.
+*/
+function renderToolsBlock(tools) {
+	if (tools.length === 0) return "";
+	return `<functions>\n${tools.map((tool) => {
+		const schema = {
+			description: tool.toolSchema.description,
+			name: tool.toolSchema.name,
+			parameters: tool.toolSchema.parameters
+		};
+		return `<function>${JSON.stringify(schema)}</function>`;
+	}).join("\n")}\n</functions>`;
+}
+/**
+* Build the tool_search meta-tool. The returned tool has a closure over
+* the supplied `toolListAccessor`, which it uses to push newly-resolved
+* tool schemas into the live agent context.
+*
+* Idempotent: re-loading a tool that's already in the context is a no-op.
+*/
+function createToolSearchTool(toolListAccessor) {
+	return {
+		toolSchema: {
+			name: "tool_search",
+			description: "Fetches full schema definitions for deferred tools so they can be called. Deferred tools appear by name only in a system reminder; their parameter schemas are NOT loaded by default. Use this tool to load schemas on demand. Query forms: 'select:name1,name2' for exact selection, or free-text keywords to search by name and description. Once a tool's schema is returned, it becomes callable in subsequent turns.",
+			parameters: {
+				type: "object",
+				properties: {
+					query: {
+						type: "string",
+						description: "Either 'select:<comma-separated names>' to fetch specific tools, or free-text keywords (e.g. 'github pull request') to rank-search deferred tools."
+					},
+					max_results: {
+						type: "number",
+						description: `Maximum number of tools to return for keyword search. Defaults to ${DEFAULT_MAX_RESULTS}. Ignored for 'select:' queries.`
+					}
+				},
+				required: ["query"]
+			}
+		},
+		toolFn: async (params) => {
+			const parsedParams = ToolSearchParamsSchema.safeParse(params ?? {});
+			if (!parsedParams.success) {
+				const issue = parsedParams.error.issues[0];
+				return `tool_search: invalid parameters — ${issue.path.join(".") || "params"}: ${issue.message}`;
+			}
+			const { query, max_results } = parsedParams.data;
+			const parsed = parseQuery(query);
+			let matched;
+			let unmatched = [];
+			if (parsed.mode === "select") {
+				matched = deferredToolRegistry.getByNames(parsed.names);
+				const foundNames = new Set(matched.map((t) => t.toolSchema.name));
+				unmatched = parsed.names.filter((n) => !foundNames.has(n));
+			} else {
+				const max = max_results ?? DEFAULT_MAX_RESULTS;
+				matched = deferredToolRegistry.searchByKeywords(parsed.text, max);
+			}
+			if (matched.length === 0) return parsed.mode === "select" ? `tool_search: no deferred tools matched ${parsed.names.join(", ")}. Use a free-text query to search.` : `tool_search: no deferred tools matched query "${parsed.text}".`;
+			const liveTools = toolListAccessor();
+			const liveNames = new Set(liveTools.map((t) => t.toolSchema.name));
+			let added = 0;
+			for (const tool of matched) if (!liveNames.has(tool.toolSchema.name)) {
+				liveTools.push(tool);
+				added++;
+			}
+			logger.debug(`[tool_search] query="${query}" matched=${matched.length} added=${added} alreadyLoaded=${matched.length - added}`);
+			const block = renderToolsBlock(matched);
+			return `${`Loaded ${added} new tool schema(s)${added < matched.length ? ` (${matched.length - added} already loaded)` : ""}. These are now callable in your next message.${unmatched.length > 0 ? `\n\nNot found: ${unmatched.join(", ")}` : ""}`}\n\n${block}`;
+		}
+	};
+}
+//#endregion
 //#region src/features/FeatureModuleRegistry.ts
 /**
 * Manages the lifecycle of opt-in CLI feature modules.
@@ -5976,10 +6166,23 @@ function CliApp() {
 				loadContextFiles(agentProjectDir)
 			]);
 			const mcpTools = mcpManager.getTools();
+			const deferredB4mToolNames = new Set([
+				"math_evaluate",
+				"dice_roll",
+				"current_datetime",
+				"recent_changes",
+				"prompt_enhancement"
+			]);
+			const deferredB4mTools = b4mTools.filter((t) => deferredB4mToolNames.has(t.toolSchema.name));
+			const loadedB4mTools = b4mTools.filter((t) => !deferredB4mToolNames.has(t.toolSchema.name));
+			deferredToolRegistry.register([...mcpTools, ...deferredB4mTools]);
 			if (mcpTools.length > 0) {
 				const serverSummaries = mcpManager.getToolCount().map((s) => `${s.serverName} (${s.count})`).join(", ");
-				startupLog.push(`🛠️ Loaded ${b4mTools.length} B4M + ${mcpTools.length} MCP tool(s): ${serverSummaries}`);
-			} else startupLog.push(`🛠️ Loaded ${b4mTools.length} B4M tool(s), no MCP tools`);
+				startupLog.push(`🛠️ Loaded ${loadedB4mTools.length} B4M + ${mcpTools.length} MCP tool(s, ${deferredB4mTools.length + mcpTools.length} deferred): ${serverSummaries}`);
+			} else {
+				const suffix = deferredB4mTools.length > 0 ? ` (${deferredB4mTools.length} deferred)` : "";
+				startupLog.push(`🛠️ Loaded ${loadedB4mTools.length} B4M tool(s)${suffix}, no MCP tools`);
+			}
 			const agentSummary = agentStore.getSummary();
 			startupLog.push(`🤖 Loaded ${agentSummary.total} agent(s): ${agentSummary.builtin} built-in, ${agentSummary.global} global, ${agentSummary.project} project`);
 			const orchestrator = new SubagentOrchestrator({
@@ -6053,9 +6256,14 @@ function CliApp() {
 				cliTools.push(coordinateTaskTool);
 			}
 			const featureTools = featureRegistry.getAllTools();
+			const agentToolsRef = { current: null };
+			const toolSearchTool = deferredToolRegistry.size() > 0 ? createToolSearchTool(() => {
+				if (!agentToolsRef.current) throw new Error("tool_search invoked before agent context was wired");
+				return agentToolsRef.current;
+			}) : null;
 			const allTools = [
-				...b4mTools,
-				...mcpTools,
+				...loadedB4mTools,
+				...toolSearchTool ? [toolSearchTool] : [],
 				...cliTools,
 				...featureTools
 			];
@@ -6070,7 +6278,7 @@ function CliApp() {
 				const moduleNames = featureRegistry.getModuleNames().join(", ");
 				startupLog.push(`🏰 Feature modules: ${moduleNames} (${featureTools.length} tools)`);
 			}
-			logger.debug(`Total tools available to agent: ${allTools.length} (${b4mTools.length} B4M + ${mcpTools.length} MCP + ${cliTools.length} CLI + ${featureTools.length} feature)`);
+			logger.debug(`Total tools available to agent: ${allTools.length} (${loadedB4mTools.length} B4M loaded + ${cliTools.length} CLI + ${featureTools.length} feature + ${toolSearchTool ? 1 : 0} tool_search, ${deferredB4mTools.length} B4M + ${mcpTools.length} MCP deferred)`);
 			if (contextResult.globalContext) startupLog.push(`📄 Global context: ${contextResult.globalContext.filename}`);
 			if (contextResult.projectContext) startupLog.push(`📄 Project context: ${contextResult.projectContext.filename}`);
 			for (const error of contextResult.errors) startupLog.push(`⚠️  Context file error: ${error}`);
@@ -6084,7 +6292,8 @@ function CliApp() {
 				enableDynamicAgentCreation: config.preferences.enableDynamicAgentCreation === true,
 				additionalDirectories,
 				featureModulePrompts: featureModulePrompts || void 0,
-				planModeFilePath: mode === "plan" ? getPlanModeFilePath(newSession.id) : void 0
+				planModeFilePath: mode === "plan" ? getPlanModeFilePath(newSession.id) : void 0,
+				deferredToolNames: deferredToolRegistry.getDirectoryNames()
 			});
 			const cliSystemPrompt = buildPromptForMode(useCliStore.getState().interactionMode);
 			const maxIterations = config.preferences.maxIterations === null ? 999999 : config.preferences.maxIterations;
@@ -6097,16 +6306,17 @@ function CliApp() {
 				maxIterations,
 				maxTokens: config.preferences.maxTokens,
 				temperature: config.preferences.temperature,
-				systemPrompt: cliSystemPrompt
+				systemPrompt: cliSystemPrompt,
+				unknownToolResolver: async (toolName) => deferredToolRegistry.get(toolName) ?? null
 			});
+			agentToolsRef.current = agent.getTools();
 			agentContext.currentAgent = agent;
-			const agentInternalContext = agent.context;
 			let lastInteractionMode = useCliStore.getState().interactionMode;
 			useCliStore.subscribe((s) => {
 				if (s.interactionMode === lastInteractionMode) return;
 				lastInteractionMode = s.interactionMode;
 				if (agentContext.currentAgent !== agent) return;
-				agentInternalContext.systemPrompt = buildPromptForMode(s.interactionMode);
+				agent.setSystemPrompt(buildPromptForMode(s.interactionMode));
 			});
 			agent.observationQueue = agentContext.observationQueue;
 			const stepHandler = (step) => {
@@ -6562,7 +6772,8 @@ function CliApp() {
 				customCommands: state.customCommandStore.getAllCommands(),
 				enableSkillTool: config?.preferences.enableSkillTool !== false,
 				additionalDirectories: state.additionalDirectories,
-				featureModulePrompts: state.featureRegistry?.getSystemPromptSections() || void 0
+				featureModulePrompts: state.featureRegistry?.getSystemPromptSections() || void 0,
+				deferredToolNames: deferredToolRegistry.getDirectoryNames()
 			});
 			if (tokenCounter.countSessionTokens(activeSession, systemPrompt).totalTokens >= threshold) {
 				console.log("\n⚠️  Context window 80% full. Auto-compacting...\n");
@@ -7753,7 +7964,7 @@ Multi-line Input:
 				const skillsTokens = skillsSection ? tokenCounter.countTokens(skillsSection) : 0;
 				const agentDirectoryTokens = state.agentStore ? tokenCounter.countTokens(state.agentStore.getDirectoryContext()) : 0;
 				const mcpTools = state.mcpManager?.getTools() || [];
-				const mcpToolsTokens = tokenCounter.countToolSchemaTokens(mcpTools);
+				const deferredNames = deferredToolRegistry.getDirectoryNames();
 				const mcpToolCount = state.mcpManager?.getToolCount() || [];
 				const systemPrompt = buildSystemPrompt(variantForCount, {
 					contextContent: state.contextContent,
@@ -7761,10 +7972,13 @@ Multi-line Input:
 					customCommands: commands,
 					enableSkillTool: state.config?.preferences.enableSkillTool !== false,
 					additionalDirectories: state.additionalDirectories,
-					featureModulePrompts: state.featureRegistry?.getSystemPromptSections() || void 0
+					featureModulePrompts: state.featureRegistry?.getSystemPromptSections() || void 0,
+					deferredToolNames: deferredNames
 				});
 				const usage = tokenCounter.countSessionTokens(state.session, systemPrompt);
-				const totalWithTools = usage.totalTokens + mcpToolsTokens;
+				const agentTools = state.agent?.getTools() ?? [];
+				const agentToolsTokens = tokenCounter.countToolSchemaTokens(agentTools);
+				const totalWithTools = usage.totalTokens + agentToolsTokens;
 				const usagePercent = totalWithTools / contextWindow * 100;
 				const BAR_WIDTH = 40;
 				const filledWidth = Math.min(Math.round(usagePercent / 100 * BAR_WIDTH), BAR_WIDTH);
@@ -7781,10 +7995,14 @@ Multi-line Input:
 					console.log(`  Agent Directory:   ${agentDirectoryTokens.toLocaleString()} tokens (${agentCount} agents)`);
 				}
 				if (mcpTools.length > 0) {
-					console.log("\nMCP Tools:");
-					console.log(`  Total:             ${mcpToolsTokens.toLocaleString()} tokens (${mcpTools.length} tools)`);
+					console.log("\nMCP Tools (deferred):");
+					console.log(`  Schemas:           load on demand via tool_search (${mcpTools.length} tools available)`);
 					for (const { serverName, count } of mcpToolCount) console.log(`    ${serverName}: ${count} tools`);
 				}
+				if (agentTools.length > 0) {
+					console.log("\nLoaded Tool Schemas:");
+					console.log(`  Schemas:           ${agentToolsTokens.toLocaleString()} tokens (${agentTools.length} tools active)`);
+				}
 				console.log("\nConversation:");
 				console.log(`  Messages:          ${usage.messageTokens.toLocaleString()} tokens (${state.session.messages.length} messages)`);
 				if (usagePercent >= 80) {
@@ -8320,14 +8538,13 @@ Multi-line Input:
 			const newToolNames = newFeatureRegistry.getAllToolNames();
 			if (newToolNames.length > 0) registerFeatureModuleTools(newToolNames);
 			if (state.wsManager && newFeatureRegistry.hasModules) newFeatureRegistry.registerAllWsHandlers(state.wsManager);
-			const agentContext = state.agent.context;
 			const oldFeatureToolNames = new Set(state.featureRegistry?.getAllToolNames() ?? []);
-			const baseTools = agentContext.tools.filter((t) => !oldFeatureToolNames.has(t.toolSchema.name));
+			const baseTools = state.agent.getTools().filter((t) => !oldFeatureToolNames.has(t.toolSchema.name));
 			const newFeatureTools = newFeatureRegistry.getAllTools();
-			agentContext.tools = [...baseTools, ...newFeatureTools];
+			state.agent.setTools([...baseTools, ...newFeatureTools]);
 			const newFeaturePrompts = newFeatureRegistry.getSystemPromptSections();
 			const planFilePathForRebuild = useCliStore.getState().interactionMode === "plan" && state.session ? getPlanModeFilePath(state.session.id) : void 0;
-			agentContext.systemPrompt = buildSystemPrompt(updatedConfig.preferences.promptVariant ?? "current", {
+			state.agent.setSystemPrompt(buildSystemPrompt(updatedConfig.preferences.promptVariant ?? "current", {
 				contextContent: state.contextContent,
 				agentStore: state.agentStore || void 0,
 				customCommands: state.customCommandStore.getAllCommands(),
@@ -8335,8 +8552,9 @@ Multi-line Input:
 				enableDynamicAgentCreation: updatedConfig.preferences.enableDynamicAgentCreation === true,
 				additionalDirectories: state.additionalDirectories,
 				featureModulePrompts: newFeaturePrompts || void 0,
-				planModeFilePath: planFilePathForRebuild
-			});
+				planModeFilePath: planFilePathForRebuild,
+				deferredToolNames: deferredToolRegistry.getDirectoryNames()
+			}));
 			const moduleNames = newFeatureRegistry.getModuleNames();
 			if (moduleNames.length > 0) console.error(`\n\x1b[36m🏰 Feature modules hot-reloaded: ${moduleNames.join(", ")}\x1b[0m`);
 			else console.error(`\n\x1b[36m🏰 Feature modules disabled\x1b[0m`);

package/dist/{tools-_X4rUM4L.mjs → tools-RdGu37Lw.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { $ as PermissionDeniedError, $t as isNearLimit, A as GEMINI_IMAGE_MODELS, At as VideoGenerationUsageTransaction, B as InternalServerError, Bt as isGPTImage2Model, C as ElabsEvents, Ct as TooManyRequestsError, D as FileEvents, Dt as UnauthorizedError, E as FeedbackEvents, Et as UiNavigationEvents, F as HttpStatus, Ft as dayjsConfig_default, G as MiscEvents, Gt as resolveNavigationIntents, H as InviteType, Ht as isModelDeprecated, I as ImageEditUsageTransaction, It as getAccessibleDataLakes, J as NO_TEMPERATURE_MODELS, Jt as settingsMap, K as ModalEvents, Kt as sanitizeTelemetryError, L as ImageGenerationUsageTransaction, Lt as getDataLakeTags, M as GenericCreditAddTransaction, Mt as VoyageAIEmbeddingModel, N as GenericCreditDeductTransaction, Nt as XAI_IMAGE_MODELS, O as ForbiddenError, Ot as UnprocessableEntityError, P as HTTPError, Pt as b4mLLMTools, Q as Permission, Qt as extractSnippetMeta, R as ImageModels, Rt as getMcpProviderMetadata, S as DashboardParamsSchema, St as TextGenerationUsageTransaction, T as FavoriteDocumentType, Tt as TransferCreditTransaction, U as KnowledgeType, Ut as isZodError, V as InviteEvents, Vt as isGPTImageModel, W as LLMEvents, Wt as obfuscateApiKey, X as OpenAIEmbeddingModel, Y as NotFoundError, Z as OpenAIImageGenerationInput, Zt as buildRateLimitLogEntry, _ as ChatCompletionCreateInputSchema, _t as SpeechToTextUsageTransaction, a as ApiKeyEvents, at as QuestMasterParamsSchema, b as CompletionApiUsageTransaction, bt as TagType, c as AppFileEvents, ct as ReceivedCreditTransaction, d as BEDROCK_NO_PROMPT_CACHING_MODELS, dt as ResearchModeParamsSchema, en as parseRateLimitHeaders, et as ProfileEvents, f as BFL_IMAGE_MODELS, ft as ResearchTaskExecutionType, gt as SpeechToTextModels, h as BedrockEmbeddingModel, ht as SessionEvents, i as AiEvents, it as PurchaseTransaction, j as GenerateImageToolCallSchema, jt as VideoModels, k as FriendshipEvents, kt as VIDEO_SIZE_CONSTRAINTS, l as ArtifactTypeSchema, lt as RechartsChartTypeList, m as BadRequestError, mt as ResearchTaskType, n as logger, nt as PromptIntentSchema, o as ApiKeyScope, ot as REASONING_SUPPORTED_MODELS, p as BFL_SAFETY_TOLERANCE, pt as ResearchTaskPeriodicFrequencyType, q as ModelBackend, qt as secureParameters, r as ALERT_THRESHOLDS, rt as PromptMetaZodSchema, s as ApiKeyType, st as RealtimeVoiceUsageTransaction, t as ConfigStore, tn as CollectionType, tt as ProjectEvents, u as AuthEvents, ut as RegInviteEvents, v as ChatModels, vt as SubscriptionCreditTransaction, w as FIXED_TEMPERATURE_MODELS, wt as ToolUsageTransaction, x as CorruptedFileError, xt as TaskScheduleHandler, y as ClaudeArtifactMimeTypes, yt as SupportedFabFileMimeTypes, z as InboxEvents, zt as getViewById } from "./ConfigStore-DPWN3-0c.mjs";
+import { $ as PermissionDeniedError, $t as isNearLimit, A as GEMINI_IMAGE_MODELS, At as VideoGenerationUsageTransaction, B as InternalServerError, Bt as isGPTImage2Model, C as ElabsEvents, Ct as TooManyRequestsError, D as FileEvents, Dt as UnauthorizedError, E as FeedbackEvents, Et as UiNavigationEvents, F as HttpStatus, Ft as dayjsConfig_default, G as MiscEvents, Gt as resolveNavigationIntents, H as InviteType, Ht as isModelDeprecated, I as ImageEditUsageTransaction, It as getAccessibleDataLakes, J as NO_TEMPERATURE_MODELS, Jt as settingsMap, K as ModalEvents, Kt as sanitizeTelemetryError, L as ImageGenerationUsageTransaction, Lt as getDataLakeTags, M as GenericCreditAddTransaction, Mt as VoyageAIEmbeddingModel, N as GenericCreditDeductTransaction, Nt as XAI_IMAGE_MODELS, O as ForbiddenError, Ot as UnprocessableEntityError, P as HTTPError, Pt as b4mLLMTools, Q as Permission, Qt as extractSnippetMeta, R as ImageModels, Rt as getMcpProviderMetadata, S as DashboardParamsSchema, St as TextGenerationUsageTransaction, T as FavoriteDocumentType, Tt as TransferCreditTransaction, U as KnowledgeType, Ut as isZodError, V as InviteEvents, Vt as isGPTImageModel, W as LLMEvents, Wt as obfuscateApiKey, X as OpenAIEmbeddingModel, Y as NotFoundError, Z as OpenAIImageGenerationInput, Zt as buildRateLimitLogEntry, _ as ChatCompletionCreateInputSchema, _t as SpeechToTextUsageTransaction, a as ApiKeyEvents, at as QuestMasterParamsSchema, b as CompletionApiUsageTransaction, bt as TagType, c as AppFileEvents, ct as ReceivedCreditTransaction, d as BEDROCK_NO_PROMPT_CACHING_MODELS, dt as ResearchModeParamsSchema, en as parseRateLimitHeaders, et as ProfileEvents, f as BFL_IMAGE_MODELS, ft as ResearchTaskExecutionType, gt as SpeechToTextModels, h as BedrockEmbeddingModel, ht as SessionEvents, i as AiEvents, it as PurchaseTransaction, j as GenerateImageToolCallSchema, jt as VideoModels, k as FriendshipEvents, kt as VIDEO_SIZE_CONSTRAINTS, l as ArtifactTypeSchema, lt as RechartsChartTypeList, m as BadRequestError, mt as ResearchTaskType, n as logger, nt as PromptIntentSchema, o as ApiKeyScope, ot as REASONING_SUPPORTED_MODELS, p as BFL_SAFETY_TOLERANCE, pt as ResearchTaskPeriodicFrequencyType, q as ModelBackend, qt as secureParameters, r as ALERT_THRESHOLDS, rt as PromptMetaZodSchema, s as ApiKeyType, st as RealtimeVoiceUsageTransaction, t as ConfigStore, tn as CollectionType, tt as ProjectEvents, u as AuthEvents, ut as RegInviteEvents, v as ChatModels, vt as SubscriptionCreditTransaction, w as FIXED_TEMPERATURE_MODELS, wt as ToolUsageTransaction, x as CorruptedFileError, xt as TaskScheduleHandler, y as ClaudeArtifactMimeTypes, yt as SupportedFabFileMimeTypes, z as InboxEvents, zt as getViewById } from "./ConfigStore-aeJGqjKm.mjs";
 import { a as isUserLockedOut, c as userCanDisableMFA, d as userRequiresMFA, f as verifyBackupCode, i as getLockoutTimeRemaining, l as userEligibleForMFA, n as generateBackupCodes, o as recordFailedAttempt, p as verifyTOTPToken, r as generateTOTPSetup, s as shouldResetFailedAttempts, t as clearFailedAttempts, u as userHasMFAConfigured } from "./utils-PpNti-tY.mjs";
 import { n as isPathAllowed, t as assertPathAllowed } from "./pathValidation-D8tjkQXE-1HwvsuYT.mjs";
 import { execFile, execFileSync, spawn } from "child_process";
@@ -1945,6 +1945,35 @@ var ReActAgent = class extends EventEmitter {
 		};
 	}
 	/**
+	* Return the live tools array used by this agent. Mutations (push/splice)
+	* are reflected in subsequent ReAct iterations because the array is read
+	* each turn at the top of the loop. Intended for hosts that load tool
+	* schemas lazily (see `unknownToolResolver` and the CLI's tool_search
+	* meta-tool). Prefer this over reaching into `agent.context.tools` via a
+	* type cast.
+	*/
+	getTools() {
+		return this.context.tools;
+	}
+	/**
+	* Replace the live tools array. Used by hosts that need to swap the
+	* tool set wholesale (e.g. hot-reload of feature module tools). Prefer
+	* `getTools()` + array mutation for incremental additions — replacing
+	* the reference invalidates any closures that captured the previous
+	* array (e.g. `createToolSearchTool`'s `toolListAccessor`).
+	*/
+	setTools(tools) {
+		this.context.tools = tools;
+	}
+	/**
+	* Update the system prompt. Used to hot-swap prompts when the user
+	* cycles interaction modes (e.g. into plan mode) or when feature
+	* modules reload.
+	*/
+	setSystemPrompt(systemPrompt) {
+		this.context.systemPrompt = systemPrompt;
+	}
+	/**
 	* Run the agent to completion
 	*
 	* @param query - The user's question or task (can be text or multimodal content with images)
@@ -2826,7 +2855,20 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 			return typeof result === "string" ? result : JSON.stringify(result);
 		}
 		const tool = this.context.tools.find((t) => t.toolSchema.name === toolUse.name);
-		if (!tool) return `Error: Tool ${toolUse.name} not found in agent context`;
+		if (!tool) {
+			if (this.context.unknownToolResolver) {
+				const resolved = await this.context.unknownToolResolver(toolUse.name);
+				if (resolved) {
+					this.context.tools.push(resolved);
+					return `Tool '${toolUse.name}' was deferred and its schema is now loaded. The previous call was made without the schema visible — please re-issue the call with valid parameters per the schema below.\n\n<function>${JSON.stringify({
+						description: resolved.toolSchema.description,
+						name: resolved.toolSchema.name,
+						parameters: resolved.toolSchema.parameters
+					})}</function>`;
+				}
+			}
+			return `Error: Tool ${toolUse.name} not found in agent context`;
+		}
 		try {
 			const params = this.parseToolArguments(toolUse.arguments);
 			const result = await tool.toolFn(params);
@@ -3253,6 +3295,28 @@ const TOOL_WRITE_TODOS = "write_todos";
 const TOOL_CREATE_DYNAMIC_AGENT = "create_dynamic_agent";
 const EXPLORE_SUBAGENT_TYPE = "explore";
 /**
+* Render the deferred-tool directory: names only, no descriptions.
+* Following Claude Code's pattern, MCP tools have self-describing names
+* (e.g. mcp__github__create_pull_request) that the model parses without
+* needing extra text. The model can also call `tool_search` with free-text
+* keywords for non-obvious names.
+*/
+function buildDeferredToolDirectory(names) {
+	if (names.length === 0) return "";
+	const sorted = [...names].sort();
+	return `
+
+## Deferred tool schemas
+
+The following ${sorted.length} tool(s) are available but their parameter schemas are NOT loaded by default to save context. Calling them directly will fail with "Tool not found". Use the \`tool_search\` tool to load schemas on demand:
+- Exact selection: \`tool_search(query="select:<name>[,<name>...]")\`
+- Keyword search: \`tool_search(query="<free text>")\`
+
+Once a tool's schema is loaded, it becomes callable in subsequent turns. Deferred tool names:
+
+${sorted.join("\n")}`;
+}
+/**
 * Plan-mode section: tells the model that write tools are blocked and where to put the plan.
 * Appended dynamically when the user cycles into plan mode via Shift+Tab.
 *
@@ -3343,6 +3407,7 @@ function buildCoreSystemPrompt(contextSection, config) {
 	let directoriesSection = "";
 	let featureModulesSection = "";
 	let planModeSection = "";
+	let deferredToolSection = "";
 	if (typeof contextSection === "string") {
 		projectContextSection = contextSection;
 		if (config) {
@@ -3351,6 +3416,7 @@ function buildCoreSystemPrompt(contextSection, config) {
 			if (config.enableDynamicAgentCreation) dynamicAgentSection = buildDynamicAgentPromptSection();
 			if (config.featureModulePrompts) featureModulesSection = config.featureModulePrompts;
 			if (config.planModeFilePath) planModeSection = buildPlanModePromptSection(config.planModeFilePath);
+			if (config.deferredToolNames && config.deferredToolNames.length > 0) deferredToolSection = buildDeferredToolDirectory(config.deferredToolNames);
 		}
 	} else if (contextSection && typeof contextSection === "object") {
 		config = contextSection;
@@ -3361,6 +3427,7 @@ function buildCoreSystemPrompt(contextSection, config) {
 		if (config.additionalDirectories && config.additionalDirectories.length > 0) directoriesSection = `\n\n## Additional Allowed Directories\n\nIn addition to the working directory (${process.cwd()}), you have read/write access to these directories:\n${config.additionalDirectories.map((d) => `- ${d}`).join("\n")}\n\nTo access files in additional directories, pass the full path to the 'dir_path' parameter of file tools:\n- ${TOOL_GREP_SEARCH}(pattern="...", dir_path="/path/to/additional/dir")\n- ${TOOL_GLOB_FILES}(pattern="**/*.ts", dir_path="/path/to/additional/dir")\n- ${TOOL_FILE_READ}(path="/path/to/additional/dir/file.ts")\n\nWhen the user asks about content in an additional directory, search there first using the dir_path parameter.`;
 		if (config.featureModulePrompts) featureModulesSection = config.featureModulePrompts;
 		if (config.planModeFilePath) planModeSection = buildPlanModePromptSection(config.planModeFilePath);
+		if (config.deferredToolNames && config.deferredToolNames.length > 0) deferredToolSection = buildDeferredToolDirectory(config.deferredToolNames);
 	}
 	return `You are an autonomous AI assistant with access to tools. Your job is to help users by taking action and solving problems proactively.
 
@@ -3478,7 +3545,7 @@ These tools are lightweight — use them naturally as part of your work, not as
 
 ## Working Directory
 
-The current working directory is \`${process.cwd()}\`. All relative paths in tool calls resolve from here. When using \`${TOOL_GLOB_FILES}\` or \`${TOOL_GREP_SEARCH}\` without an explicit \`dir_path\`, they search from this directory.${directoriesSection}${projectContextSection}${skillsSection}${featureModulesSection}${planModeSection}`;
+The current working directory is \`${process.cwd()}\`. All relative paths in tool calls resolve from here. When using \`${TOOL_GLOB_FILES}\` or \`${TOOL_GREP_SEARCH}\` without an explicit \`dir_path\`, they search from this directory.${directoriesSection}${projectContextSection}${skillsSection}${featureModulesSection}${planModeSection}${deferredToolSection}`;
 }
 /**
 * Build the minimal-variant system prompt. Reuses the project context,
@@ -3492,11 +3559,13 @@ function buildMinimalSystemPrompt(config = {}) {
 	let directoriesSection = "";
 	let featureModulesSection = "";
 	let planModeSection = "";
+	let deferredToolSection = "";
 	if (config.contextContent) projectContextSection = `\n\n## Project Context\n\nFollow these project-specific instructions:\n\n${config.contextContent}`;
 	if (config.enableSkillTool !== false && config.customCommands && config.customCommands.length > 0) skillsSection = buildSkillsPromptSection(config.customCommands);
 	if (config.additionalDirectories && config.additionalDirectories.length > 0) directoriesSection = `\n\n## Additional Allowed Directories\n\nIn addition to the working directory (${process.cwd()}), you have read/write access to these directories:\n${config.additionalDirectories.map((d) => `- ${d}`).join("\n")}\n\nPass full paths to file tools' \`dir_path\` parameter to access these directories.`;
 	if (config.featureModulePrompts) featureModulesSection = config.featureModulePrompts;
 	if (config.planModeFilePath) planModeSection = buildPlanModePromptSection(config.planModeFilePath);
+	if (config.deferredToolNames && config.deferredToolNames.length > 0) deferredToolSection = buildDeferredToolDirectory(config.deferredToolNames);
 	return `You are an expert coding assistant. You help users by reading files, executing commands, editing code, and writing new files using the tools available to you.
 
 Guidelines:
@@ -3506,7 +3575,7 @@ Guidelines:
 
 ## Working Directory
 
-The current working directory is \`${process.cwd()}\`. All relative paths in tool calls resolve from here. When using \`${TOOL_GLOB_FILES}\` or \`${TOOL_GREP_SEARCH}\` without an explicit \`dir_path\`, they search from this directory.${directoriesSection}${projectContextSection}${skillsSection}${featureModulesSection}${planModeSection}`;
+The current working directory is \`${process.cwd()}\`. All relative paths in tool calls resolve from here. When using \`${TOOL_GLOB_FILES}\` or \`${TOOL_GREP_SEARCH}\` without an explicit \`dir_path\`, they search from this directory.${directoriesSection}${projectContextSection}${skillsSection}${featureModulesSection}${planModeSection}${deferredToolSection}`;
 }
 /**
 * Pick a system prompt by variant. The dispatch point for the
@@ -16332,13 +16401,12 @@ var BFLImageService = class extends AIImageService {
 			throw pollError;
 		}
 		const elapsedSeconds = Math.round((Date.now() - startTime) / 1e3);
-		const timeoutError = `Image generation is taking longer than expected (timed out after ${elapsedSeconds}s). The image may still be processing on BFL's servers. Request ID: ${requestId}`;
 		console.error(`[DEBUG] ❌ Polling timeout:`, {
 			requestId,
 			maxAttempts,
 			totalTime: `${elapsedSeconds}s`
 		});
-		throw new Error(timeoutError);
+		throw new Error("Image generation is taking longer than usual and your request could not be completed. Please try again in a few minutes.");
 	}
 };
 var XAIImageService = class extends AIImageService {
@@ -18449,7 +18517,10 @@ const webFetchTool = {
 				if (error instanceof FirecrawlError && [
 					400,
 					403,
-					408
+					408,
+					502,
+					503,
+					504
 				].includes(error.statusCode)) {
 					const { userMessage, statusLabel } = {
 						400: {
@@ -18463,6 +18534,18 @@ const webFetchTool = {
 						408: {
 							userMessage: `The page timed out before loading completely — the site may be slow or require heavy JavaScript rendering. Try using web_search to find the information instead.`,
 							statusLabel: "scrape timed out"
+						},
+						502: {
+							userMessage: `The website returned a Bad Gateway error — it may be temporarily unavailable. Try again later or use web_search to find the information instead.`,
+							statusLabel: "bad gateway"
+						},
+						503: {
+							userMessage: `The website is temporarily unavailable (Service Unavailable). Try again later or use web_search to find the information instead.`,
+							statusLabel: "service unavailable"
+						},
+						504: {
+							userMessage: `The website took too long to respond (Gateway Timeout). Try again later or use web_search to find the information instead.`,
+							statusLabel: "gateway timeout"
 						}
 					}[error.statusCode];
 					context.logger.warn("WebFetch expected Firecrawl failure", {
@@ -20651,7 +20734,7 @@ No markdown, no explanation, no code blocks — just the raw JSON object.`;
 	"Minimize: sum(error^2)"
 ].join("\n");
 //#endregion
-//#region ../../b4m-core/services/dist/tools-DeOV9w_P.mjs
+//#region ../../b4m-core/services/dist/tools-DtGzruvF.mjs
 async function performDeepResearch(context, params, config) {
 	const maxDepth = config.maxDepth || 7;
 	const duration = config.duration || 4.5;
@@ -21463,6 +21546,11 @@ async function evaluateMath(params) {
 	} catch (error) {
 		const errorMessage = error instanceof Error ? error.message : "Unknown error";
 		console.error(`❌ Math Tool: Evaluation error for expression "${params.expression}":`, errorMessage);
+		const undefinedSymbol = errorMessage.match(/Undefined symbol (\w+)/);
+		if (undefinedSymbol) {
+			const symbol = undefinedSymbol[1];
+			return `Error: Failed to evaluate math expression "${params.expression}". Reason: the symbol "${symbol}" is used but never assigned a value. Assign it first with a semicolon-separated statement (e.g. "${symbol} = <value>; ...") before referencing it, then try again.`;
+		}
 		return `Error: Failed to evaluate math expression "${params.expression}". Reason: ${errorMessage}. Please provide a valid mathematical expression using numbers and operators only (no natural language).`;
 	}
 }
@@ -24269,7 +24357,7 @@ const knowledgeBaseRetrieveTool = {
 					if (ownedFile) files = [ownedFile];
 					else {
 						const sharedFile = await context.db.fabfiles.findById(file_id);
-						if (sharedFile && !sharedFile.deletedAt) {
+						if (sharedFile && !sharedFile.deletedAt && !sharedFile.archivedAt) {
 							const { dataLakeTags, dataLakeTagPrefixes } = await getDynamicDataLakeAccess(context);
 							const fileTags = sharedFile.tags?.map((t) => t.name) || [];
 							const hasMetaTagAccess = dataLakeTags.some((dlt) => fileTags.includes(dlt));
@@ -27975,6 +28063,7 @@ z.object({
 	embargoDetected: z.boolean().prefault(false),
 	suggestedTags: z.array(z.string()).prefault([])
 });
+ImageModels.GPT_IMAGE_1, ImageModels.GPT_IMAGE_1_5, ImageModels.GPT_IMAGE_1_MINI, ImageModels.GPT_IMAGE_2;
 /**
 * Regex patterns for extracting GitHub entities from text
 */

package/dist/{updateChecker-C3DYG0Gn.mjs → updateChecker-CP_jeER9.mjs}

@@ -4,7 +4,7 @@ import { homedir } from "os";
 import path from "path";
 import axios from "axios";
 //#region package.json
-var version = "0.10.0";
+var version = "0.10.1";
 //#endregion
 //#region src/utils/updateChecker.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bike4mind/cli",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "type": "module",
   "description": "Interactive CLI tool for Bike4Mind with ReAct agents",
   "license": "UNLICENSED",
@@ -121,11 +121,11 @@
     "tsx": "^4.22.3",
     "typescript": "^5.9.3",
     "vitest": "^4.1.7",
-    "@bike4mind/agents": "0.11.1",
-    "@bike4mind/common": "2.102.0",
-    "@bike4mind/mcp": "1.37.16",
-    "@bike4mind/services": "2.90.1",
-    "@bike4mind/utils": "2.23.3"
+    "@bike4mind/agents": "0.11.3",
+    "@bike4mind/common": "2.103.0",
+    "@bike4mind/mcp": "1.37.17",
+    "@bike4mind/services": "2.90.3",
+    "@bike4mind/utils": "2.23.5"
   },
   "optionalDependencies": {
     "@vscode/ripgrep": "^1.18.0"