@bike4mind/cli 0.4.0 → 0.6.0

package/dist/{tools-DiSJh1Dv.mjs → tools-dIVxi-6-.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { $ as RechartsChartTypeList, A as ImageGenerationUsageTransaction, At as secureParameters, B as NotFoundError, C as FileEvents, Ct as getMcpProviderMetadata, D as GenericCreditAddTransaction, Dt as obfuscateApiKey, E as GenerateImageToolCallSchema, Et as isGPTImageModel, F as KnowledgeType, G as ProfileEvents, H as OpenAIImageGenerationInput, I as LLMEvents, J as PurchaseTransaction, K as ProjectEvents, L as MiscEvents, M as InboxEvents, N as InviteEvents, Nt as CollectionType, O as GenericCreditDeductTransaction, Ot as resolveNavigationIntents, P as InviteType, Q as ReceivedCreditTransaction, R as ModalEvents, S as FeedbackEvents, St as getDataLakeTags, T as GEMINI_IMAGE_MODELS, Tt as isGPTImage2Model, U as Permission, V as OpenAIEmbeddingModel, W as PermissionDeniedError, X as REASONING_SUPPORTED_MODELS, Y as QuestMasterParamsSchema, Z as RealtimeVoiceUsageTransaction, _ as CompletionApiUsageTransaction, _t as VideoModels, a as ApiKeyEvents, at as SessionEvents, b as FIXED_TEMPERATURE_MODELS, bt as b4mLLMTools, c as AppFileEvents, ct as SupportedFabFileMimeTypes, d as BFL_IMAGE_MODELS, dt as TextGenerationUsageTransaction, et as RegInviteEvents, f as BFL_SAFETY_TOLERANCE, ft as ToolUsageTransaction, g as ChatModels, gt as VideoGenerationUsageTransaction, h as ChatCompletionCreateInputSchema, ht as VIDEO_SIZE_CONSTRAINTS, i as AiEvents, it as ResearchTaskType, j as ImageModels, k as ImageEditUsageTransaction, kt as sanitizeTelemetryError, l as ArtifactTypeSchema, lt as TagType, mt as UiNavigationEvents, n as logger, nt as ResearchTaskExecutionType, o as ApiKeyScope, ot as SpeechToTextModels, p as BedrockEmbeddingModel, pt as TransferCreditTransaction, q as PromptMetaZodSchema, r as ALERT_THRESHOLDS, rt as ResearchTaskPeriodicFrequencyType, s as ApiKeyType, st as SubscriptionCreditTransaction, t as ConfigStore, tt as ResearchModeParamsSchema, u as AuthEvents, ut as TaskScheduleHandler, v as DashboardParamsSchema, vt as VoyageAIEmbeddingModel, w as FriendshipEvents, wt as getViewById, x as FavoriteDocumentType, xt as getAccessibleDataLakes, y as ElabsEvents, yt as XAI_IMAGE_MODELS, z as ModelBackend } from "./ConfigStore-DBUmvCfe.mjs";
+import { $ as RechartsChartTypeList, A as ImageGenerationUsageTransaction, At as secureParameters, B as NotFoundError, C as FileEvents, Ct as getMcpProviderMetadata, D as GenericCreditAddTransaction, Dt as obfuscateApiKey, E as GenerateImageToolCallSchema, Et as isGPTImageModel, F as KnowledgeType, G as ProfileEvents, H as OpenAIImageGenerationInput, I as LLMEvents, J as PurchaseTransaction, K as ProjectEvents, L as MiscEvents, M as InboxEvents, N as InviteEvents, Nt as CollectionType, O as GenericCreditDeductTransaction, Ot as resolveNavigationIntents, P as InviteType, Q as ReceivedCreditTransaction, R as ModalEvents, S as FeedbackEvents, St as getDataLakeTags, T as GEMINI_IMAGE_MODELS, Tt as isGPTImage2Model, U as Permission, V as OpenAIEmbeddingModel, W as PermissionDeniedError, X as REASONING_SUPPORTED_MODELS, Y as QuestMasterParamsSchema, Z as RealtimeVoiceUsageTransaction, _ as CompletionApiUsageTransaction, _t as VideoModels, a as ApiKeyEvents, at as SessionEvents, b as FIXED_TEMPERATURE_MODELS, bt as b4mLLMTools, c as AppFileEvents, ct as SupportedFabFileMimeTypes, d as BFL_IMAGE_MODELS, dt as TextGenerationUsageTransaction, et as RegInviteEvents, f as BFL_SAFETY_TOLERANCE, ft as ToolUsageTransaction, g as ChatModels, gt as VideoGenerationUsageTransaction, h as ChatCompletionCreateInputSchema, ht as VIDEO_SIZE_CONSTRAINTS, i as AiEvents, it as ResearchTaskType, j as ImageModels, k as ImageEditUsageTransaction, kt as sanitizeTelemetryError, l as ArtifactTypeSchema, lt as TagType, mt as UiNavigationEvents, n as logger, nt as ResearchTaskExecutionType, o as ApiKeyScope, ot as SpeechToTextModels, p as BedrockEmbeddingModel, pt as TransferCreditTransaction, q as PromptMetaZodSchema, r as ALERT_THRESHOLDS, rt as ResearchTaskPeriodicFrequencyType, s as ApiKeyType, st as SubscriptionCreditTransaction, t as ConfigStore, tt as ResearchModeParamsSchema, u as AuthEvents, ut as TaskScheduleHandler, v as DashboardParamsSchema, vt as VoyageAIEmbeddingModel, w as FriendshipEvents, wt as getViewById, x as FavoriteDocumentType, xt as getAccessibleDataLakes, y as ElabsEvents, yt as XAI_IMAGE_MODELS, z as ModelBackend } from "./ConfigStore-Dt6utdSA.mjs";
 import { n as isPathAllowed, t as assertPathAllowed } from "./pathValidation-CIytuhr3-Dt5dntLx.mjs";
 import { execFile, execFileSync, spawn } from "child_process";
 import { createHash, randomBytes } from "crypto";
@@ -522,6 +522,18 @@ const COMMANDS = [
 	{
 		name: "dirs",
 		description: "List all accessible directories"
+	},
+	{
+		name: "decisions",
+		description: "Show decision log for current session"
+	},
+	{
+		name: "blockers",
+		description: "Show tracked blockers for current session"
+	},
+	{
+		name: "handoff",
+		description: "Show or generate the session handoff for cross-session continuity"
 	}
 ];
 /**
@@ -3015,7 +3027,18 @@ EXAMPLES:
 - "what packages installed?" → ${TOOL_GLOB_FILES} "**/package.json" → ${TOOL_FILE_READ}
 - "find all components using React hooks" → ${TOOL_SUBAGENT_DELEGATE}(task="find all components using React hooks", type="explore")
 
-Remember: Use context from previous messages to understand follow-up questions.${directoriesSection}${projectContextSection}${skillsSection}${featureModulesSection}`;
+Remember: Use context from previous messages to understand follow-up questions.
+
+DURABLE WORKFLOW TRACKING:
+You have tools for tracking decisions and blockers during your work. These create an audit trail that persists across sessions, enabling anyone to understand why things were done and what's still outstanding.
+
+- log_decision: When you make a significant decision (architecture choice, scope narrowing, interpretation of ambiguous requirements, trade-off between alternatives), log it with rationale. Do NOT log trivial decisions. Log decisions that would matter if someone needed to understand WHY you did something or if they needed to resume this work.
+
+- track_blocker: When you encounter something blocking progress (missing information, unclear requirements, external dependencies, ambiguous specs that need human clarification), track it. This makes blockers visible so they can be addressed.
+
+- resolve_blocker: When a blocker is cleared, record how it was resolved. Use the blocker ID from the track_blocker output.
+
+These tools are lightweight — use them naturally as part of your work, not as a ceremony.${directoriesSection}${projectContextSection}${skillsSection}${featureModulesSection}`;
 }
 /**
 * Build the dynamic agent creation prompt section
@@ -3080,8 +3103,7 @@ var AIImageService = class {
 	}
 };
 //#endregion
-//#region ../../b4m-core/utils/dist/index.mjs
-var BaseStorage = class {};
+//#region ../../b4m-core/observability/dist/index.mjs
 var Logger = class Logger {
 	static globalInstance = new Logger();
 	metadata = {};
@@ -3285,6 +3307,9 @@ var Logger = class Logger {
 		blue: `\x1b[34m${args.join(" ")}\x1b[0m`
 	});
 };
+//#endregion
+//#region ../../b4m-core/utils/dist/index.mjs
+var BaseStorage = class {};
 dotenv.config();
 /**
 * Execute an array of async tasks either in parallel (with concurrency limiting)
@@ -4741,6 +4766,8 @@ var OpenAIBackend = class {
 			...options
 		};
 		const toolCallCount = options._internal?.toolCallCount ?? 0;
+		const accumInputTokens = options._internal?.accumInputTokens ?? 0;
+		const accumOutputTokens = options._internal?.accumOutputTokens ?? 0;
 		if (toolCallCount >= 10 && options.tools?.length) {
 			this.logger.warn(`⚠️ Max tool calls limit (10) reached. Disabling tools to prevent infinite loops.`);
 			await this.complete(model, messages, {
@@ -4923,7 +4950,9 @@ var OpenAIBackend = class {
 							tools: anyMcpTool ? options.tools : void 0,
 							_internal: {
 								...options._internal,
-								toolCallCount: toolCallCount + 1
+								toolCallCount: toolCallCount + 1,
+								accumInputTokens: accumInputTokens + (response.usage?.prompt_tokens || 0),
+								accumOutputTokens: accumOutputTokens + (response.usage?.completion_tokens || 0)
 							}
 						}, recursiveCallback, toolsUsed);
 						if (anyArtifactWasStreamed && recursiveBuffer) {
@@ -4934,8 +4963,8 @@ var OpenAIBackend = class {
 					} else {
 						this.logger.debug(`[Tool Execution] executeTools=false, passing tool calls to callback`);
 						await callback([null], {
-							inputTokens: response.usage?.prompt_tokens || 0,
-							outputTokens: response.usage?.completion_tokens || 0,
+							inputTokens: accumInputTokens + (response.usage?.prompt_tokens || 0),
+							outputTokens: accumOutputTokens + (response.usage?.completion_tokens || 0),
 							toolsUsed: toolsUsed.length > 0 ? toolsUsed : void 0
 						});
 						return;
@@ -4949,8 +4978,8 @@ var OpenAIBackend = class {
 				if (cacheStats) logCacheStats(this.logger, cacheStats, { streaming: false });
 			}
 			await callback(streamedText, {
-				inputTokens: response.usage?.prompt_tokens || 0,
-				outputTokens: response.usage?.completion_tokens || 0,
+				inputTokens: accumInputTokens + (response.usage?.prompt_tokens || 0),
+				outputTokens: accumOutputTokens + (response.usage?.completion_tokens || 0),
 				toolsUsed: toolsUsed.length > 0 ? toolsUsed : void 0,
 				cacheStats
 			});
@@ -4989,8 +5018,8 @@ var OpenAIBackend = class {
 				if (c.delta.content) streamedText[c.index] = (streamedText[c.index] || "") + c.delta.content;
 			});
 			await callback(streamedText, {
-				inputTokens,
-				outputTokens,
+				inputTokens: accumInputTokens + inputTokens,
+				outputTokens: accumOutputTokens + outputTokens,
 				toolsUsed: toolsUsed.length > 0 ? toolsUsed : void 0
 			});
 		}
@@ -5095,8 +5124,8 @@ var OpenAIBackend = class {
 						thisToolHadArtifact = true;
 						anyArtifactWasStreamed = true;
 						await callback(results, {
-							inputTokens,
-							outputTokens,
+							inputTokens: accumInputTokens + inputTokens,
+							outputTokens: accumOutputTokens + outputTokens,
 							toolsUsed: toolsUsed.length > 0 ? toolsUsed : void 0,
 							cacheStats
 						});
@@ -5119,7 +5148,9 @@ var OpenAIBackend = class {
 						tools: anyMcpTool ? options.tools : void 0,
 						_internal: {
 							...options._internal,
-							toolCallCount: toolCallCount + 1
+							toolCallCount: toolCallCount + 1,
+							accumInputTokens: accumInputTokens + inputTokens,
+							accumOutputTokens: accumOutputTokens + outputTokens
 						}
 					}, async (results, meta) => {
 						for (const r of results) if (r != null) recursiveBuffer += r;
@@ -5132,14 +5163,16 @@ var OpenAIBackend = class {
 					tools: anyMcpTool ? options.tools : void 0,
 					_internal: {
 						...options._internal,
-						toolCallCount: toolCallCount + 1
+						toolCallCount: toolCallCount + 1,
+						accumInputTokens: accumInputTokens + inputTokens,
+						accumOutputTokens: accumOutputTokens + outputTokens
 					}
 				}, callback, toolsUsed);
 			} else {
 				this.logger.debug(`[Tool Execution] executeTools=false, passing tool calls to callback`);
 				await callback([null], {
-					inputTokens,
-					outputTokens,
+					inputTokens: accumInputTokens + inputTokens,
+					outputTokens: accumOutputTokens + outputTokens,
 					toolsUsed: toolsUsed.length > 0 ? toolsUsed : void 0,
 					cacheStats
 				});
@@ -6675,15 +6708,26 @@ const webSearchTool = {
 };
 //#endregion
 //#region ../../b4m-core/services/dist/llm/tools/implementation/webfetch/index.mjs
+const DEFAULT_TIMEOUT_MS = 6e4;
+const PDF_TIMEOUT_MS = 9e4;
+function isPdfUrl(url) {
+	try {
+		const { pathname } = new URL(url);
+		return pathname.toLowerCase().endsWith(".pdf");
+	} catch {
+		return false;
+	}
+}
 /**
 * Fetch URL content using Firecrawl (shared function, no ToolContext)
 * Pattern follows serpApiSearch from websearch tool
 *
 * @param adapters - Database adapters for fetching Firecrawl API key
 * @param url - URL to fetch
+* @param options - Optional configuration (e.g. maxTimeoutMs for Lambda-constrained callers)
 * @returns Markdown content and title
 */
-async function firecrawlFetch(adapters, url) {
+async function firecrawlFetch(adapters, url, options) {
 	if (!/^https?:\/\/.+/i.test(url)) throw new Error(`Invalid URL format: ${url}. URL must start with http:// or https://`);
 	const apiKeySetting = await adapters.db.adminSettings.findBySettingName("FirecrawlApiKey");
 	if (!apiKeySetting?.settingValue) {
@@ -6691,45 +6735,45 @@ async function firecrawlFetch(adapters, url) {
 		throw new Error("Firecrawl API key not configured");
 	}
 	const app = new FirecrawlApp({ apiKey: apiKeySetting.settingValue });
-	const controller = new AbortController();
-	const timeoutId = setTimeout(() => controller.abort(), 6e4);
-	try {
-		console.log("📥 WebFetch Tool: Scraping URL with Firecrawl...");
-		let result;
-		try {
-			result = await app.scrapeUrl(url, {
-				formats: ["markdown"],
-				actions: [{
-					type: "wait",
-					milliseconds: 1e3
-				}]
-			});
-		} catch (scrapeError) {
-			if ((scrapeError instanceof Error ? scrapeError.message : "").includes("Actions are not supported")) {
-				console.log("📥 WebFetch Tool: Actions not supported, retrying without actions...");
-				result = await app.scrapeUrl(url, { formats: ["markdown"] });
-			} else throw scrapeError;
-		}
-		clearTimeout(timeoutId);
-		if (!result || result.error) {
-			const errorMessage = result?.error || "Unknown error";
-			console.error("❌ WebFetch Tool: Firecrawl error:", errorMessage);
-			throw new Error(`Failed to fetch content from URL: ${errorMessage}`);
-		}
-		if (!("markdown" in result) || !result.markdown) {
-			console.error("❌ WebFetch Tool: No markdown content returned");
-			throw new Error("No content could be extracted from the URL");
-		}
-		const markdown = result.markdown.slice(0, 5e4);
-		console.log(`📄 WebFetch Tool: Extracted ${markdown.length} characters of content`);
-		return {
-			markdown,
-			title: result.metadata?.title
-		};
-	} catch (error) {
-		clearTimeout(timeoutId);
-		throw error;
-	}
+	const isPdf = isPdfUrl(url);
+	const desiredTimeout = isPdf ? PDF_TIMEOUT_MS : DEFAULT_TIMEOUT_MS;
+	const timeoutMs = options?.maxTimeoutMs ? Math.min(desiredTimeout, options.maxTimeoutMs) : desiredTimeout;
+	console.log(`📥 WebFetch Tool: Scraping URL with Firecrawl${isPdf ? " (PDF mode, extended timeout)" : ""}...`);
+	const baseParams = {
+		formats: ["markdown"],
+		timeout: timeoutMs
+	};
+	let result;
+	if (isPdf) result = await app.scrapeUrl(url, baseParams);
+	else try {
+		result = await app.scrapeUrl(url, {
+			...baseParams,
+			actions: [{
+				type: "wait",
+				milliseconds: 1e3
+			}]
+		});
+	} catch (scrapeError) {
+		if ((scrapeError instanceof Error ? scrapeError.message : "").includes("Actions are not supported")) {
+			console.log("📥 WebFetch Tool: Actions not supported, retrying without actions...");
+			result = await app.scrapeUrl(url, baseParams);
+		} else throw scrapeError;
+	}
+	if (!result || result.error) {
+		const errorMessage = result?.error || "Unknown error";
+		console.error("❌ WebFetch Tool: Firecrawl error:", errorMessage);
+		throw new Error(`Failed to fetch content from URL: ${errorMessage}`);
+	}
+	if (!("markdown" in result) || !result.markdown) {
+		console.error("❌ WebFetch Tool: No markdown content returned");
+		throw new Error("No content could be extracted from the URL");
+	}
+	const markdown = result.markdown.slice(0, 5e4);
+	console.log(`📄 WebFetch Tool: Extracted ${markdown.length} characters of content`);
+	return {
+		markdown,
+		title: result.metadata?.title
+	};
 }
 const webFetchTool = {
 	name: "web_fetch",
@@ -6785,6 +6829,14 @@ const webFetchTool = {
 					await context.statusUpdate({}, `WebFetch: ${statusLabel}`);
 					return userMessage;
 				}
+				if (error instanceof FirecrawlError && error.statusCode === 500 && errorMessage.includes("PDF")) {
+					context.logger.warn("WebFetch PDF too large for Firecrawl", {
+						url: params.url,
+						error: errorMessage
+					});
+					await context.statusUpdate({}, "WebFetch: PDF too large");
+					return `This PDF is too large to process via URL. Please download the file and upload it directly instead.`;
+				}
 				if ([
 					"no response received",
 					"econnrefused",
@@ -6821,17 +6873,49 @@ const webFetchTool = {
 	})
 };
 //#endregion
-//#region ../../b4m-core/services/dist/jsonSanitize-NGoqEfny.mjs
+//#region ../../b4m-core/services/dist/jsonSanitize-DPYPbara.mjs
 /**
 * Sanitize a JSON string by escaping control characters inside string literals.
 * LLMs sometimes return JSON with unescaped newlines/tabs inside string values,
 * which causes JSON.parse to fail with "Bad control character in string literal".
 *
 * Covers all U+0000–U+001F control characters per JSON RFC 8259.
+*
+* Also applies a lookahead heuristic to escape unescaped double-quotes inside
+* string values — the most common LLM JSON failure mode (e.g., code snippets
+* containing logger.error("msg") inside a JSON string).
+*
+* Returns the sanitized string and the number of quotes repaired.
+* If the JSON is already valid, it is returned unchanged (zero repairs).
 */
 function sanitizeJsonString(jsonStr) {
+	const { result } = sanitizeJsonStringWithMeta(jsonStr);
+	return result;
+}
+function sanitizeJsonStringWithMeta(jsonStr, options) {
+	try {
+		JSON.parse(jsonStr);
+		return {
+			result: jsonStr,
+			repairedQuotes: 0
+		};
+	} catch {}
 	let result = "";
 	let inString = false;
+	/**
+	* Tracks whether we are in a key position (true) or value position (false).
+	* Starts as true — the first string in valid JSON must be a key.
+	* Flips to false after a key-closing quote + colon pair.
+	* Flips back to true after a value-closing quote (or structural char) + comma/`{`/`[`.
+	*
+	* This is used to disambiguate `:` after a `"` inside a string:
+	*   - In key position: `"` + `:` → structural (closes the key, colon follows)
+	*   - In value position: `"` + `:` → embedded (e.g., `"status": it was null"`)
+	*/
+	let inKey = true;
+	/** Tracks nested structure context for truncation repair. */
+	const structureStack = [];
+	let repairedQuotes = 0;
 	let i = 0;
 	while (i < jsonStr.length) {
 		const char = jsonStr[i];
@@ -6841,8 +6925,25 @@ function sanitizeJsonString(jsonStr) {
 			continue;
 		}
 		if (char === "\"") {
-			inString = !inString;
-			result += char;
+			if (!inString) {
+				inString = true;
+				result += char;
+				i++;
+				continue;
+			}
+			let j = i + 1;
+			while (j < jsonStr.length && (jsonStr[j] === " " || jsonStr[j] === "	" || jsonStr[j] === "\r" || jsonStr[j] === "\n")) j++;
+			const nextNonWs = j < jsonStr.length ? jsonStr[j] : "";
+			if (nextNonWs === "," || nextNonWs === "}" || nextNonWs === "]" || nextNonWs === "" || nextNonWs === ":" && inKey) {
+				inString = false;
+				result += char;
+				i++;
+				if (nextNonWs === ":") inKey = false;
+				else if (nextNonWs === "," || nextNonWs === "}" || nextNonWs === "]") inKey = true;
+				continue;
+			}
+			result += "\\\"";
+			repairedQuotes++;
 			i++;
 			continue;
 		}
@@ -6869,10 +6970,45 @@ function sanitizeJsonString(jsonStr) {
 					break;
 			}
 			else result += char;
-		} else result += char;
+		} else {
+			result += char;
+			if (char === "{") {
+				structureStack.push("{");
+				inKey = true;
+			} else if (char === "[") {
+				structureStack.push("[");
+				inKey = false;
+			} else if (char === "}" || char === "]") {
+				if (structureStack.length > 0) structureStack.pop();
+				inKey = (structureStack.length > 0 ? structureStack[structureStack.length - 1] : null) !== "[";
+			} else if (char === ",") {
+				if ((structureStack.length > 0 ? structureStack[structureStack.length - 1] : null) === "{") inKey = true;
+			}
+		}
 		i++;
 	}
-	return result;
+	if (inString) {
+		if (options?.attemptTruncationRepair && structureStack.length > 0) {
+			const closing = [...structureStack].reverse().map((c) => c === "{" ? "}" : "]").join("");
+			const salvage = result + "\"" + closing;
+			try {
+				JSON.parse(salvage);
+				return {
+					result: salvage,
+					repairedQuotes,
+					truncationRepaired: true
+				};
+			} catch {}
+		}
+		return {
+			result: jsonStr,
+			repairedQuotes: 0
+		};
+	}
+	return {
+		result,
+		repairedQuotes
+	};
 }
 //#endregion
 //#region ../../b4m-core/quantum/dist/index.mjs
@@ -8720,7 +8856,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-s4H4po60.mjs
+//#region ../../b4m-core/services/dist/tools-B55E_Q3K.mjs
 async function performDeepResearch(context, params, config) {
 	const maxDepth = config.maxDepth || 7;
 	const duration = config.duration || 4.5;
@@ -15760,56 +15896,6 @@ z.object({
 	embargoDetected: z.boolean().prefault(false),
 	suggestedTags: z.array(z.string()).prefault([])
 });
-z.object({
-	userId: z.string(),
-	sessionId: z.string(),
-	questId: z.string(),
-	message: z.string().min(1, "Message cannot be empty"),
-	messageFileIds: z.array(z.string()),
-	historyCount: z.number(),
-	fabFileIds: z.array(z.string()),
-	params: ChatCompletionCreateInputSchema,
-	dashboardParams: DashboardParamsSchema.optional(),
-	enableQuestMaster: z.boolean().optional(),
-	enableMementos: z.boolean().optional(),
-	enableArtifacts: z.boolean().optional(),
-	enableAgents: z.boolean().optional(),
-	enableLattice: z.boolean().optional(),
-	promptMeta: PromptMetaZodSchema,
-	tools: z.array(z.union([b4mLLMTools, z.string()])).optional(),
-	mcpServers: z.array(z.string()).optional(),
-	projectId: z.string().optional(),
-	organizationId: z.string().nullable().optional(),
-	questMaster: QuestMasterParamsSchema.optional(),
-	toolPromptId: z.string().optional(),
-	researchMode: ResearchModeParamsSchema.optional(),
-	fallbackModel: z.string().optional(),
-	embeddingModel: z.string().optional(),
-	queryComplexity: z.string(),
-	imageConfig: GenerateImageToolCallSchema.optional(),
-	deepResearchConfig: z.object({
-		maxDepth: z.number().optional(),
-		duration: z.number().optional(),
-		searchers: z.array(z.any()).optional()
-	}).optional(),
-	extraContextMessages: z.array(z.object({
-		role: z.enum([
-			"user",
-			"assistant",
-			"system",
-			"function",
-			"tool"
-		]),
-		content: z.union([z.string(), z.array(z.any())]),
-		fabFileIds: z.array(z.string()).optional()
-	})).optional(),
-	/** User's timezone (IANA format, e.g., "America/New_York") */
-	timezone: z.string().optional(),
-	/** Persona-based sub-agent filter — only these agent names are available for delegation */
-	allowedAgents: z.array(z.string()).optional(),
-	/** When true, Quest Processor injects Slack-specific tool configs (help, notebooks, curated files) */
-	enableSlackTools: z.boolean().optional()
-});
 /**
 * Regex patterns for extracting GitHub entities from text
 */
@@ -16307,6 +16393,56 @@ var CombinedExtractor = class {
 	}
 };
 new CombinedExtractor();
+z.object({
+	userId: z.string(),
+	sessionId: z.string(),
+	questId: z.string(),
+	message: z.string().min(1, "Message cannot be empty"),
+	messageFileIds: z.array(z.string()),
+	historyCount: z.number(),
+	fabFileIds: z.array(z.string()),
+	params: ChatCompletionCreateInputSchema,
+	dashboardParams: DashboardParamsSchema.optional(),
+	enableQuestMaster: z.boolean().optional(),
+	enableMementos: z.boolean().optional(),
+	enableArtifacts: z.boolean().optional(),
+	enableAgents: z.boolean().optional(),
+	enableLattice: z.boolean().optional(),
+	promptMeta: PromptMetaZodSchema,
+	tools: z.array(z.union([b4mLLMTools, z.string()])).optional(),
+	mcpServers: z.array(z.string()).optional(),
+	projectId: z.string().optional(),
+	organizationId: z.string().nullable().optional(),
+	questMaster: QuestMasterParamsSchema.optional(),
+	toolPromptId: z.string().optional(),
+	researchMode: ResearchModeParamsSchema.optional(),
+	fallbackModel: z.string().optional(),
+	embeddingModel: z.string().optional(),
+	queryComplexity: z.string(),
+	imageConfig: GenerateImageToolCallSchema.optional(),
+	deepResearchConfig: z.object({
+		maxDepth: z.number().optional(),
+		duration: z.number().optional(),
+		searchers: z.array(z.any()).optional()
+	}).optional(),
+	extraContextMessages: z.array(z.object({
+		role: z.enum([
+			"user",
+			"assistant",
+			"system",
+			"function",
+			"tool"
+		]),
+		content: z.union([z.string(), z.array(z.any())]),
+		fabFileIds: z.array(z.string()).optional()
+	})).optional(),
+	/** User's timezone (IANA format, e.g., "America/New_York") */
+	timezone: z.string().optional(),
+	/** Persona-based sub-agent filter — only these agent names are available for delegation */
+	allowedAgents: z.array(z.string()).optional(),
+	/** When true, Quest Processor injects Slack-specific tool configs (help, notebooks, curated files) */
+	enableSlackTools: z.boolean().optional()
+});
 (class AnomalyAlertService {
 	static {
 		this.MAX_CACHE_ENTRIES = 1e3;
@@ -23479,4 +23615,234 @@ function createGetFileStructureTool() {
 	};
 }
 //#endregion
-export { DEFAULT_MAX_ITERATIONS as A, ReActAgent as B, loadContextFiles as C, generateCliTools as D, PermissionManager as E, setWebSocketToolExecutor as F, OAuthClient as G, CheckpointStore as H, OllamaBackend as I, searchCommands as J, hasFileReferences as K, buildCoreSystemPrompt as L, DEFAULT_THOROUGHNESS as M, clearFeatureModuleTools as N, ALWAYS_DENIED_FOR_AGENTS as O, registerFeatureModuleTools as P, warmFileCache as Q, buildSkillsPromptSection as R, extractCompactInstructions as S, getEnvironmentName as T, CommandHistoryStore as U, CustomCommandStore as V, SessionStore as W, formatFileSize$1 as X, mergeCommands as Y, searchFiles as Z, WebSocketLlmBackend as _, createCoordinateTaskTool as a, substituteArguments as b, createAgentDelegateTool as c, createSkillTool as d, parseAgentConfig as f, FallbackLlmBackend as g, WebSocketConnectionManager as h, createWriteTodosTool as i, DEFAULT_RETRY_CONFIG as j, DEFAULT_AGENT_MODEL as k, AgentStore as l, WebSocketToolExecutor as m, createFindDefinitionTool as n, createBackgroundAgentTools as o, ApiClient as p, processFileReferences as q, createTodoStore as r, BackgroundAgentManager as s, createGetFileStructureTool as t, SubagentOrchestrator as u, ServerLlmBackend as v, getApiUrl as w, formatStep as x, McpManager as y, isReadOnlyTool as z };
+//#region src/tools/decisionLogTool.ts
+/**
+* Validate log_decision parameters
+* @throws Error if validation fails
+*/
+function validateParams(args) {
+	const params = args;
+	if (typeof params.summary !== "string" || params.summary.trim() === "") throw new Error("log_decision: summary must be a non-empty string");
+	if (typeof params.rationale !== "string" || params.rationale.trim() === "") throw new Error("log_decision: rationale must be a non-empty string");
+	if (params.alternatives !== void 0) {
+		if (!Array.isArray(params.alternatives)) throw new Error("log_decision: alternatives must be an array of strings");
+		for (const alt of params.alternatives) if (typeof alt !== "string") throw new Error("log_decision: each alternative must be a string");
+	}
+	if (params.context !== void 0 && typeof params.context !== "string") throw new Error("log_decision: context must be a string");
+	return {
+		summary: params.summary.trim(),
+		rationale: params.rationale.trim(),
+		alternatives: params.alternatives,
+		context: typeof params.context === "string" ? params.context.trim() : void 0
+	};
+}
+/**
+* Format decisions for display output
+*/
+function formatDecisionsOutput(decisions) {
+	if (decisions.length === 0) return "No decisions logged in this session.";
+	return decisions.map((decision, index) => {
+		const lines = [`${index + 1}. **${decision.summary}**`, `   Rationale: ${decision.rationale}`];
+		if (decision.alternatives && decision.alternatives.length > 0) lines.push(`   Alternatives considered: ${decision.alternatives.join(", ")}`);
+		if (decision.context) lines.push(`   Context: ${decision.context}`);
+		const timestamp = new Date(decision.timestamp).toLocaleTimeString();
+		lines.push(`   Logged at: ${timestamp}`);
+		return lines.join("\n");
+	}).join("\n\n");
+}
+/**
+* Create the log_decision tool.
+*
+* Allows the AI to record significant decisions with rationale during a session.
+* Decisions are persisted in the session's workflow state for audit trail
+* and cross-session continuity.
+*/
+function createDecisionLogTool(store) {
+	return {
+		toolFn: async (args) => {
+			const params = validateParams(args);
+			const decision = {
+				id: v4(),
+				timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+				summary: params.summary,
+				rationale: params.rationale,
+				alternatives: params.alternatives,
+				context: params.context
+			};
+			store.decisions.push(decision);
+			if (store.onUpdate) store.onUpdate(store.decisions);
+			return `Decision logged (#${store.decisions.length}): ${decision.summary}`;
+		},
+		toolSchema: {
+			name: "log_decision",
+			description: `Record a significant decision with its rationale for audit trail and session continuity.
+
+**When to use:**
+- Architecture or design choices (e.g., "chose Zustand over Redux because...")
+- Scope narrowing or direction changes in research
+- Trade-off decisions between viable alternatives
+- Interpretation of ambiguous requirements
+
+**When NOT to use:**
+- Routine operations (reading files, running tests)
+- Trivial choices that wouldn't matter to someone resuming this work
+- Implementation details that are obvious from the code
+
+Log decisions that would matter if someone needed to understand WHY you did something.`,
+			parameters: {
+				type: "object",
+				properties: {
+					summary: {
+						type: "string",
+						description: "What was decided — a clear, concise statement"
+					},
+					rationale: {
+						type: "string",
+						description: "Why this decision was made — the reasoning behind it"
+					},
+					alternatives: {
+						type: "array",
+						items: { type: "string" },
+						description: "What alternatives were considered (optional)"
+					},
+					context: {
+						type: "string",
+						description: "What triggered this decision — the situation or constraint (optional)"
+					}
+				},
+				required: ["summary", "rationale"]
+			}
+		}
+	};
+}
+/**
+* Create a new empty DecisionStore
+*/
+function createDecisionStore(onUpdate) {
+	return {
+		decisions: [],
+		onUpdate
+	};
+}
+//#endregion
+//#region src/tools/blockerTool.ts
+/**
+* Format blockers for display output
+*/
+function formatBlockersOutput(blockers) {
+	if (blockers.length === 0) return "No blockers tracked in this session.";
+	const open = blockers.filter((b) => b.status === "open");
+	const resolved = blockers.filter((b) => b.status === "resolved");
+	const lines = [];
+	if (open.length > 0) {
+		lines.push(`**Open blockers (${open.length}):**`);
+		for (const blocker of open) lines.push(`  - [${blocker.id.slice(0, 8)}] ${blocker.description}`);
+	}
+	if (resolved.length > 0) {
+		if (open.length > 0) lines.push("");
+		lines.push(`**Resolved blockers (${resolved.length}):**`);
+		for (const blocker of resolved) {
+			lines.push(`  - [${blocker.id.slice(0, 8)}] ${blocker.description}`);
+			lines.push(`    Resolution: ${blocker.resolution ?? "(no resolution recorded)"}`);
+		}
+	}
+	return lines.join("\n");
+}
+/**
+* Create the track_blocker and resolve_blocker tools.
+*
+* Allows the AI to track what's blocking progress and record resolutions.
+* Blockers are persisted in the session's workflow state for audit trail
+* and cross-session continuity.
+*/
+function createBlockerTools(store) {
+	return [{
+		toolFn: async (args) => {
+			const params = args;
+			if (typeof params.description !== "string" || params.description.trim() === "") throw new Error("track_blocker: description must be a non-empty string");
+			const blocker = {
+				id: v4(),
+				createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+				description: params.description.trim(),
+				status: "open"
+			};
+			store.blockers.push(blocker);
+			if (store.onUpdate) store.onUpdate(store.blockers);
+			const openCount = store.blockers.filter((b) => b.status === "open").length;
+			return `Blocker tracked [${blocker.id.slice(0, 8)}]: ${blocker.description}\n(${openCount} open blocker${openCount === 1 ? "" : "s"})`;
+		},
+		toolSchema: {
+			name: "track_blocker",
+			description: `Track something that is blocking progress.
+
+**When to use:**
+- Missing information or unclear requirements
+- External dependencies (waiting on API access, credentials, data)
+- Technical constraints discovered during work
+- Ambiguous requirements that need human clarification
+
+**When NOT to use:**
+- Normal challenges that are part of the work
+- Things you can resolve immediately`,
+			parameters: {
+				type: "object",
+				properties: { description: {
+					type: "string",
+					description: "What is blocking progress — be specific about what is needed to unblock"
+				} },
+				required: ["description"]
+			}
+		}
+	}, {
+		toolFn: async (args) => {
+			const params = args;
+			if (typeof params.blocker_id !== "string" || params.blocker_id.trim() === "") throw new Error("resolve_blocker: blocker_id must be a non-empty string");
+			if (typeof params.resolution !== "string" || params.resolution.trim() === "") throw new Error("resolve_blocker: resolution must be a non-empty string");
+			const blockerId = params.blocker_id.trim();
+			const blocker = store.blockers.find((b) => b.id === blockerId || b.id.startsWith(blockerId));
+			if (!blocker) {
+				const openBlockers = store.blockers.filter((b) => b.status === "open");
+				if (openBlockers.length === 0) return "No open blockers to resolve.";
+				return `Blocker not found. Open blockers:\n${openBlockers.map((b) => `  [${b.id.slice(0, 8)}] ${b.description}`).join("\n")}`;
+			}
+			if (blocker.status === "resolved") return `Blocker [${blocker.id.slice(0, 8)}] is already resolved.`;
+			blocker.status = "resolved";
+			blocker.resolvedAt = (/* @__PURE__ */ new Date()).toISOString();
+			blocker.resolution = params.resolution.trim();
+			if (store.onUpdate) store.onUpdate(store.blockers);
+			const openCount = store.blockers.filter((b) => b.status === "open").length;
+			return `Blocker resolved [${blocker.id.slice(0, 8)}]: ${blocker.resolution}\n(${openCount} open blocker${openCount === 1 ? "" : "s"} remaining)`;
+		},
+		toolSchema: {
+			name: "resolve_blocker",
+			description: `Mark a blocker as resolved with a description of how it was resolved.
+
+Use the blocker ID (or its first 8 characters) from the track_blocker output.`,
+			parameters: {
+				type: "object",
+				properties: {
+					blocker_id: {
+						type: "string",
+						description: "The ID of the blocker to resolve (full ID or first 8 characters)"
+					},
+					resolution: {
+						type: "string",
+						description: "How the blocker was resolved"
+					}
+				},
+				required: ["blocker_id", "resolution"]
+			}
+		}
+	}];
+}
+/**
+* Create a new empty BlockerStore
+*/
+function createBlockerStore(onUpdate) {
+	return {
+		blockers: [],
+		onUpdate
+	};
+}
+//#endregion
+export { processFileReferences as $, getApiUrl as A, registerFeatureModuleTools as B, WebSocketLlmBackend as C, formatStep as D, substituteArguments as E, DEFAULT_AGENT_MODEL as F, isReadOnlyTool as G, OllamaBackend as H, DEFAULT_MAX_ITERATIONS as I, CheckpointStore as J, ReActAgent as K, DEFAULT_RETRY_CONFIG as L, PermissionManager as M, generateCliTools as N, extractCompactInstructions as O, ALWAYS_DENIED_FOR_AGENTS as P, hasFileReferences as Q, DEFAULT_THOROUGHNESS as R, FallbackLlmBackend as S, McpManager as T, buildCoreSystemPrompt as U, setWebSocketToolExecutor as V, buildSkillsPromptSection as W, SessionStore as X, CommandHistoryStore as Y, OAuthClient as Z, createSkillTool as _, createDecisionStore as a, WebSocketToolExecutor as b, createFindDefinitionTool as c, createCoordinateTaskTool as d, searchCommands as et, createBackgroundAgentTools as f, SubagentOrchestrator as g, AgentStore as h, createDecisionLogTool as i, warmFileCache as it, getEnvironmentName as j, loadContextFiles as k, createTodoStore as l, createAgentDelegateTool as m, createBlockerTools as n, formatFileSize$1 as nt, formatDecisionsOutput as o, BackgroundAgentManager as p, CustomCommandStore as q, formatBlockersOutput as r, searchFiles as rt, createGetFileStructureTool as s, createBlockerStore as t, mergeCommands as tt, createWriteTodosTool as u, parseAgentConfig as v, ServerLlmBackend as w, WebSocketConnectionManager as x, ApiClient as y, clearFeatureModuleTools as z };