@bike4mind/cli 0.2.82 → 0.4.0

package/dist/{tools-C0eJHV0Y.mjs → tools-DiSJh1Dv.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { $ as RegInviteEvents, A as ImageGenerationUsageTransaction, B as OpenAIEmbeddingModel, C as FileEvents, Ct as getViewById, D as GenericCreditAddTransaction, E as GenerateImageToolCallSchema, Et as sanitizeTelemetryError, F as KnowledgeType, G as ProjectEvents, H as Permission, I as LLMEvents, J as QuestMasterParamsSchema, K as PromptMetaZodSchema, L as MiscEvents, M as InboxEvents, N as InviteEvents, O as GenericCreditDeductTransaction, P as InviteType, Q as RechartsChartTypeList, R as ModalEvents, S as FeedbackEvents, St as getMcpProviderMetadata, T as GEMINI_IMAGE_MODELS, Tt as resolveNavigationIntents, U as PermissionDeniedError, V as OpenAIImageGenerationInput, W as ProfileEvents, X as RealtimeVoiceUsageTransaction, Y as REASONING_SUPPORTED_MODELS, Z as ReceivedCreditTransaction, _ as CompletionApiUsageTransaction, _t as VoyageAIEmbeddingModel, a as ApiKeyEvents, at as SpeechToTextModels, b as FIXED_TEMPERATURE_MODELS, bt as getAccessibleDataLakes, c as AppFileEvents, ct as TagType, d as BFL_IMAGE_MODELS, dt as ToolUsageTransaction, et as ResearchModeParamsSchema, f as BFL_SAFETY_TOLERANCE, ft as TransferCreditTransaction, g as ChatModels, gt as VideoModels, h as ChatCompletionCreateInputSchema, ht as VideoGenerationUsageTransaction, i as AiEvents, it as SessionEvents, j as ImageModels, k as ImageEditUsageTransaction, kt as CollectionType, l as ArtifactTypeSchema, lt as TaskScheduleHandler, mt as VIDEO_SIZE_CONSTRAINTS, n as logger, nt as ResearchTaskPeriodicFrequencyType, o as ApiKeyScope, ot as SubscriptionCreditTransaction, p as BedrockEmbeddingModel, pt as UiNavigationEvents, q as PurchaseTransaction, r as ALERT_THRESHOLDS, rt as ResearchTaskType, s as ApiKeyType, st as SupportedFabFileMimeTypes, t as ConfigStore, tt as ResearchTaskExecutionType, u as AuthEvents, ut as TextGenerationUsageTransaction, v as DashboardParamsSchema, vt as XAI_IMAGE_MODELS, w as FriendshipEvents, wt as isGPTImageModel, x as FavoriteDocumentType, xt as getDataLakeTags, y as ElabsEvents, yt as b4mLLMTools, z as ModelBackend } from "./ConfigStore-DTyUBb3A.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-DBUmvCfe.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";
@@ -14,7 +14,7 @@ import { fdir } from "fdir";
 import ignore from "ignore";
 import Fuse from "fuse.js";
 import "marked";
-import { ZodError, z } from "zod";
+import { z } from "zod";
 import dayjs from "dayjs";
 import timezone from "dayjs/plugin/timezone.js";
 import utc from "dayjs/plugin/utc.js";
@@ -997,13 +997,14 @@ var CommandHistoryStore = class {
 	async load() {
 		if (this.history) return this.history;
 		try {
-			this.history = (await promises.readFile(this.historyPath, "utf-8")).trim().split("\n").filter((line) => line.length > 0).map((line) => {
+			const entries = (await promises.readFile(this.historyPath, "utf-8")).trim().split("\n").filter((line) => line.length > 0).map((line) => {
 				try {
 					return JSON.parse(line);
 				} catch {
 					return null;
 				}
-			}).filter((entry) => entry !== null).sort((a, b) => b.timestamp - a.timestamp).map((entry) => entry.command);
+			}).filter((entry) => entry !== null);
+			this.history = entries.sort((a, b) => b.timestamp - a.timestamp).map((entry) => entry.command);
 			return this.history;
 		} catch (error) {
 			if (error.code === "ENOENT") {
@@ -1401,8 +1402,11 @@ function preprocessFrontmatter(content) {
 * Hooks are shell commands executed at different points in skill lifecycle
 */
 const HooksSchema = z.object({
+	/** Script to run before skill execution */
 	"pre-invoke": z.string().optional(),
+	/** Script to run after successful skill execution */
 	"post-invoke": z.string().optional(),
+	/** Script to run when skill execution fails */
 	"on-error": z.string().optional()
 }).optional();
 /**
@@ -1448,7 +1452,9 @@ const FrontmatterSchema = z.object({
 	variables: z.record(z.string(), z.string()).optional(),
 	"allowed-tools": flexibleStringArray,
 	context: z.enum(["fork", "inline"]).prefault("inline"),
+	/** When true, skill is hidden from AI's auto-loading in system prompt */
 	"disable-model-invocation": z.boolean().prefault(false),
+	/** When false, skill is hidden from /commands menu but still callable */
 	"user-invocable": z.boolean().prefault(true),
 	hooks: HooksSchema
 });
@@ -1882,6 +1888,12 @@ var ReActAgent = class extends EventEmitter {
 	confidenceLog = [];
 	/** Confidence scores collected during the current iteration (reset each iteration) */
 	iterationConfidences = [];
+	/** Conversation history, promoted from run()-local to instance for checkpoint/resume */
+	messages = [];
+	/** Current iteration count, promoted from run()-local to instance for checkpoint/resume */
+	iterations = 0;
+	/** Whether runIteration() has been initialized (messages built, state reset) */
+	iterationInitialized = false;
 	constructor(context) {
 		super();
 		this.context = {
@@ -1912,6 +1924,7 @@ var ReActAgent = class extends EventEmitter {
 		const maxIterations = options.maxIterations ?? this.context.maxIterations ?? 5;
 		const temperature = options.temperature ?? this.context.temperature ?? .7;
 		const maxTokens = options.maxTokens ?? this.context.maxTokens ?? 4096;
+		const maxHistoryIterations = options.maxHistoryIterations ?? 4;
 		let iterations = 0;
 		try {
 			const messages = [
@@ -1925,6 +1938,7 @@ var ReActAgent = class extends EventEmitter {
 					content: query
 				}
 			];
+			this.messages = messages;
 			messages.forEach((msg, i) => {
 				const content = typeof msg.content === "string" ? msg.content : JSON.stringify(msg.content);
 				this.context.logger.debug(`  [${i}] ${msg.role}: ${content.substring(0, 150)}...`);
@@ -1953,13 +1967,17 @@ var ReActAgent = class extends EventEmitter {
 					return result;
 				}
 				iterations++;
+				this.iterations = iterations;
 				if (iterations > 1 && options.iterationDelayMs && options.iterationDelayMs > 0) await new Promise((resolve) => setTimeout(resolve, options.iterationDelayMs));
 				this.context.logger.debug(`[ReActAgent] Starting iteration ${iterations}/${maxIterations}`);
 				let iterationComplete = false;
 				let currentText = "";
 				const processedToolIds = /* @__PURE__ */ new Set();
 				let hadToolCalls = false;
-				if (options.maxHistoryIterations && options.maxHistoryIterations > 0 && iterations > 1) trimConversationHistory(messages, options.maxHistoryIterations);
+				if (maxHistoryIterations > 0 && iterations > 1) {
+					trimConversationHistory(messages, maxHistoryIterations);
+					trimSteps(this.steps, maxHistoryIterations);
+				}
 				const cacheStrategy = options.enableCaching ? {
 					enableCaching: true,
 					cacheSystemPrompt: true,
@@ -2216,9 +2234,366 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 		return this.toolCallCount;
 	}
 	/**
-	* Create and emit an action step for a tool use
+	* Serialize the agent's current execution state for persistence.
+	*
+	* Call this after each iteration to create a durable checkpoint that can
+	* survive Lambda timeouts, process restarts, or network failures.
+	* The checkpoint is JSON-serializable and can be stored in MongoDB, DynamoDB, etc.
 	*/
-	emitActionStep(toolUse) {
+	toCheckpoint() {
+		return {
+			iteration: this.iterations,
+			messages: structuredClone(this.messages),
+			steps: structuredClone(this.steps),
+			totalTokens: this.totalTokens,
+			totalInputTokens: this.totalInputTokens,
+			totalOutputTokens: this.totalOutputTokens,
+			totalCacheReadTokens: this.totalCacheReadTokens,
+			totalCacheWriteTokens: this.totalCacheWriteTokens,
+			totalCredits: this.totalCredits,
+			toolCallCount: this.toolCallCount,
+			confidenceLog: structuredClone(this.confidenceLog),
+			iterationConfidences: [...this.iterationConfidences]
+		};
+	}
+	/**
+	* Restore the agent's execution state from a previously saved checkpoint.
+	*
+	* Call this before `runIteration()` to resume execution from where it left off.
+	* The agent will continue from the next iteration after the checkpoint.
+	*
+	* **Important:** The agent context (tools, LLM backend, model) must be compatible
+	* with the checkpoint — tools are rebuilt per Lambda invocation, not serialized.
+	*/
+	fromCheckpoint(checkpoint) {
+		this.iterations = checkpoint.iteration;
+		this.messages = structuredClone(checkpoint.messages);
+		this.steps = structuredClone(checkpoint.steps);
+		this.totalTokens = checkpoint.totalTokens;
+		this.totalInputTokens = checkpoint.totalInputTokens;
+		this.totalOutputTokens = checkpoint.totalOutputTokens;
+		this.totalCacheReadTokens = checkpoint.totalCacheReadTokens;
+		this.totalCacheWriteTokens = checkpoint.totalCacheWriteTokens;
+		this.totalCredits = checkpoint.totalCredits;
+		this.toolCallCount = checkpoint.toolCallCount;
+		this.confidenceLog = structuredClone(checkpoint.confidenceLog);
+		this.iterationConfidences = [...checkpoint.iterationConfidences];
+		this.observationQueue = [];
+		this.iterationInitialized = true;
+	}
+	/**
+	* Execute a single ReAct iteration and return the result with a checkpoint.
+	*
+	* This is the serverless-native entry point. Unlike `run()` which loops internally,
+	* `runIteration()` gives the caller control over the execution loop so it can:
+	* - Checkpoint after each iteration (persist to MongoDB)
+	* - Stream progress to the client
+	* - Check timeout watchdog (self-dispatch before Lambda timeout)
+	* - Apply permission prompts between iterations
+	* - Deduct credits per iteration
+	*
+	* **First call:** Pass `query` to initialize the conversation.
+	* **Subsequent calls / resumed from checkpoint:** `query` is ignored (messages already built).
+	*
+	* @param query - The user's question or task. Required on first call, ignored when resumed from checkpoint.
+	* @param options - Run options (maxIterations, temperature, etc.)
+	* @returns Iteration result with step, completion status, and checkpoint
+	*
+	* @remarks
+	* **No `'complete'` event:** Unlike `run()`, this method does not emit a `'complete'` event.
+	* The caller controls the iteration loop and is responsible for detecting completion
+	* via `IterationResult.isComplete`.
+	*
+	* **Not concurrency-safe:** This method mutates agent state (messages, steps, tokens).
+	* Do not call concurrently on the same instance. Designed for single-threaded Lambda execution.
+	*
+	* TODO(#8005): The iteration body (LLM call, tool execution, confidence gating) is
+	* duplicated between run() and runIteration(). Extract into a shared private method
+	* once runIteration() is validated in production. Tracked as a follow-up to avoid
+	* regressing the battle-tested run() path in this PR.
+	*/
+	async runIteration(query, options = {}) {
+		const maxIterations = options.maxIterations ?? this.context.maxIterations ?? 5;
+		const temperature = options.temperature ?? this.context.temperature ?? .7;
+		const maxTokens = options.maxTokens ?? this.context.maxTokens ?? 4096;
+		if (!this.iterationInitialized) {
+			if (!query) throw new Error("query is required on the first call to runIteration(). Pass the user query, or call fromCheckpoint() first to resume.");
+			this.steps = [];
+			this.totalTokens = 0;
+			this.totalInputTokens = 0;
+			this.totalOutputTokens = 0;
+			this.totalCredits = 0;
+			this.totalCacheReadTokens = 0;
+			this.totalCacheWriteTokens = 0;
+			this.toolCallCount = 0;
+			this.confidenceLog = [];
+			this.iterationConfidences = [];
+			this.iterations = 0;
+			this.messages = [
+				{
+					role: "system",
+					content: options.context ? `${this.getSystemPrompt()}\n\nAdditional context:\n${options.context}` : this.getSystemPrompt()
+				},
+				...options.previousMessages || [],
+				{
+					role: "user",
+					content: query
+				}
+			];
+			this.iterationInitialized = true;
+		}
+		if (this.iterations >= maxIterations) {
+			const finalStep = {
+				type: "final_answer",
+				content: `I reached the maximum number of iterations (${this.iterations}/${maxIterations}) without arriving at a final answer.`,
+				metadata: { timestamp: Date.now() }
+			};
+			this.steps.push(finalStep);
+			return {
+				step: finalStep,
+				allSteps: [finalStep],
+				isComplete: true,
+				reachedMaxIterations: true,
+				checkpoint: this.toCheckpoint()
+			};
+		}
+		if (options.signal?.aborted) {
+			const finalStep = {
+				type: "final_answer",
+				content: "Interrupted",
+				metadata: { timestamp: Date.now() }
+			};
+			this.steps.push(finalStep);
+			return {
+				step: finalStep,
+				allSteps: [finalStep],
+				isComplete: true,
+				reachedMaxIterations: false,
+				checkpoint: this.toCheckpoint()
+			};
+		}
+		const preIterationCheckpoint = this.toCheckpoint();
+		this.iterations++;
+		this.iterationConfidences = [];
+		const iterationSteps = [];
+		try {
+			if (this.iterations > 1 && options.iterationDelayMs && options.iterationDelayMs > 0) await new Promise((resolve) => setTimeout(resolve, options.iterationDelayMs));
+			this.context.logger.debug(`[ReActAgent] Starting iteration ${this.iterations}/${maxIterations}`);
+			const maxHistoryIterations = options.maxHistoryIterations ?? 4;
+			if (maxHistoryIterations > 0 && this.iterations > 1) {
+				trimConversationHistory(this.messages, maxHistoryIterations);
+				trimSteps(this.steps, maxHistoryIterations);
+			}
+			let iterationComplete = false;
+			let currentText = "";
+			let finalAnswer = "";
+			const processedToolIds = /* @__PURE__ */ new Set();
+			let hadToolCalls = false;
+			const cacheStrategy = options.enableCaching ? {
+				enableCaching: true,
+				cacheSystemPrompt: true,
+				cacheTools: this.context.tools.length > 0,
+				cacheConversationHistory: false,
+				cacheTTL: "5m"
+			} : void 0;
+			await this.context.llm.complete(this.context.model, this.messages, {
+				stream: false,
+				tools: this.context.tools,
+				maxTokens,
+				temperature,
+				abortSignal: options.signal,
+				tool_choice: this.context.toolChoice,
+				executeTools: false,
+				thinking: this.context.thinking,
+				cacheStrategy
+			}, async (texts, completionInfo) => {
+				for (const text of texts) if (text) currentText += text;
+				if (completionInfo) {
+					const inputTokens = completionInfo.inputTokens || 0;
+					const outputTokens = completionInfo.outputTokens || 0;
+					this.totalTokens += inputTokens + outputTokens;
+					this.totalInputTokens += inputTokens;
+					this.totalOutputTokens += outputTokens;
+					if (completionInfo.cacheStats) {
+						this.totalCacheReadTokens += completionInfo.cacheStats.cacheReadTokens || 0;
+						this.totalCacheWriteTokens += completionInfo.cacheStats.cacheWriteTokens || 0;
+					}
+					if (completionInfo.creditsUsed) this.totalCredits += completionInfo.creditsUsed;
+					if (currentText.trim() && completionInfo.toolsUsed?.length) {
+						const thoughtStep = {
+							type: "thought",
+							content: currentText.trim(),
+							metadata: { timestamp: Date.now() }
+						};
+						this.steps.push(thoughtStep);
+						iterationSteps.push(thoughtStep);
+						this.emit("thought", thoughtStep);
+					}
+					if (!completionInfo.toolsUsed?.length && currentText.trim()) {
+						finalAnswer = currentText.trim();
+						const finalStep = {
+							type: "final_answer",
+							content: finalAnswer,
+							metadata: {
+								timestamp: Date.now(),
+								tokenUsage: {
+									prompt: inputTokens,
+									completion: outputTokens,
+									total: inputTokens + outputTokens
+								}
+							}
+						};
+						this.steps.push(finalStep);
+						iterationSteps.push(finalStep);
+						this.emit("final_answer", finalStep);
+						iterationComplete = true;
+					}
+					if (completionInfo.toolsUsed && completionInfo.toolsUsed.length > 0) {
+						hadToolCalls = true;
+						const thinkingBlocks = completionInfo.thinking || [];
+						const unprocessedTools = [];
+						for (const toolUse of completionInfo.toolsUsed) {
+							const toolCallIdStr = getToolId(toolUse);
+							if (!processedToolIds.has(toolCallIdStr)) {
+								processedToolIds.add(toolCallIdStr);
+								unprocessedTools.push(toolUse);
+							}
+						}
+						if (unprocessedTools.length > 0) if (options.parallelExecution && shouldUseParallelExecution(unprocessedTools, options.isReadOnlyTool ?? defaultIsReadOnlyTool)) {
+							for (const toolUse of unprocessedTools) {
+								const actionStep = this.buildActionStep(toolUse);
+								iterationSteps.push(actionStep);
+							}
+							const results = await executeToolsInParallel(categorizeTools(unprocessedTools, options.isReadOnlyTool ?? defaultIsReadOnlyTool), (toolUse) => this.executeToolWithQueueFallback(toolUse), options.signal);
+							for (const toolUse of unprocessedTools) {
+								const toolIdStr = getToolId(toolUse);
+								const result = results.get(toolIdStr);
+								const observation = result?.status === "fulfilled" ? result.result ?? "" : `Error: ${result?.error?.message ?? "Unknown error"}`;
+								this.appendToolMessages(this.messages, toolUse, observation, thinkingBlocks);
+								const obsStep = this.buildObservationStep(toolUse.name, observation);
+								iterationSteps.push(obsStep);
+							}
+						} else for (const toolUse of unprocessedTools) {
+							const actionStep = this.buildActionStep(toolUse);
+							iterationSteps.push(actionStep);
+							const queuedObs = this.observationQueue.find((obs) => obs.toolId === getToolId(toolUse));
+							let observation;
+							if (queuedObs) {
+								const result = queuedObs.result;
+								const index = this.observationQueue.indexOf(queuedObs);
+								this.observationQueue.splice(index, 1);
+								observation = typeof result === "string" ? result : JSON.stringify(result);
+							} else {
+								observation = await this.executeToolWithQueueFallback(toolUse);
+								this.appendToolMessages(this.messages, toolUse, observation, thinkingBlocks);
+							}
+							const obsStep = this.buildObservationStep(toolUse.name, observation);
+							iterationSteps.push(obsStep);
+						}
+					}
+				}
+			});
+			if (hadToolCalls && options.confidenceGate && this.iterationConfidences.length > 0) {
+				const iterAvg = this.iterationConfidences.reduce((a, b) => a + b, 0) / this.iterationConfidences.length;
+				const decision = options.confidenceGate(iterAvg, this.iterations);
+				if (decision.action === "wait_for_human" || decision.action === "timed_gate") {
+					const eventName = decision.action === "wait_for_human" ? "gate_paused" : "gate_timed";
+					this.emit(eventName, {
+						...decision,
+						iteration: this.iterations
+					});
+					finalAnswer = `[${decision.action === "wait_for_human" ? "Paused for review" : "Timed gate"} — confidence ${(iterAvg * 100).toFixed(0)}%] ${decision.reason}`;
+					const gateStep = {
+						type: "final_answer",
+						content: finalAnswer,
+						metadata: { timestamp: Date.now() }
+					};
+					this.steps.push(gateStep);
+					iterationSteps.push(gateStep);
+					return {
+						step: gateStep,
+						allSteps: iterationSteps,
+						isComplete: true,
+						reachedMaxIterations: false,
+						checkpoint: this.toCheckpoint()
+					};
+				}
+				this.emit("gate_proceed", {
+					...decision,
+					iteration: this.iterations
+				});
+			}
+			this.iterationConfidences = [];
+			if (!iterationComplete && hadToolCalls) this.messages.push({
+				role: "user",
+				content: "Based on the tool results above, please provide a complete answer. If I asked for multiple things, make sure to address all of them."
+			});
+			if (!iterationComplete && this.iterations >= maxIterations) {
+				finalAnswer = currentText.trim() || `I reached the maximum number of iterations (${this.iterations}/${maxIterations}) without arriving at a final answer.`;
+				const maxStep = {
+					type: "final_answer",
+					content: finalAnswer,
+					metadata: { timestamp: Date.now() }
+				};
+				this.steps.push(maxStep);
+				iterationSteps.push(maxStep);
+				this.emit("final_answer", maxStep);
+				return {
+					step: maxStep,
+					allSteps: iterationSteps,
+					isComplete: true,
+					reachedMaxIterations: true,
+					checkpoint: this.toCheckpoint()
+				};
+			}
+			return {
+				step: iterationSteps.find((s) => s.type === "final_answer") || iterationSteps[iterationSteps.length - 1] || {
+					type: "thought",
+					content: currentText.trim() || "No output from this iteration",
+					metadata: { timestamp: Date.now() }
+				},
+				allSteps: iterationSteps,
+				isComplete: iterationComplete,
+				reachedMaxIterations: false,
+				checkpoint: this.toCheckpoint()
+			};
+		} catch (error) {
+			this.fromCheckpoint(preIterationCheckpoint);
+			if (error instanceof PermissionDeniedError) {
+				this.context.logger.info(`[ReActAgent] Permission denied for tool '${error.toolName}' in runIteration - ending gracefully`);
+				const errorStep = {
+					type: "final_answer",
+					content: `Permission denied for tool '${error.toolName}'.`,
+					metadata: { timestamp: Date.now() }
+				};
+				this.steps.push(errorStep);
+				iterationSteps.push(errorStep);
+				return {
+					step: errorStep,
+					allSteps: iterationSteps,
+					isComplete: true,
+					reachedMaxIterations: false,
+					checkpoint: this.toCheckpoint()
+				};
+			}
+			this.context.logger.error("[ReActAgent] Error during runIteration:", error);
+			this.emit("error", error);
+			throw error;
+		}
+	}
+	/**
+	* Reset the iteration state so the next `runIteration()` call starts fresh.
+	* Call this when starting a new query (not when resuming from checkpoint).
+	* The next `runIteration()` call will re-initialize all state from scratch.
+	*/
+	resetIteration() {
+		this.iterationInitialized = false;
+	}
+	/**
+	* Build an action step, increment tool call count, push to steps, and emit.
+	* Returns the step for callers that need to collect iteration steps.
+	*/
+	buildActionStep(toolUse) {
 		this.toolCallCount++;
 		const actionStep = {
 			type: "action",
@@ -2231,11 +2606,19 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 		};
 		this.steps.push(actionStep);
 		this.emit("action", actionStep);
+		return actionStep;
 	}
 	/**
-	* Create and emit an observation step, scoring confidence for the result
+	* Create and emit an action step for a tool use (delegates to buildActionStep)
 	*/
-	emitObservationStep(toolName, observation) {
+	emitActionStep(toolUse) {
+		this.buildActionStep(toolUse);
+	}
+	/**
+	* Build an observation step, score confidence, push to steps, and emit.
+	* Returns the step for callers that need to collect iteration steps.
+	*/
+	buildObservationStep(toolName, observation) {
 		const confidence = this.scoreToolResult(toolName, observation);
 		const confidenceSource = observation.startsWith("Error:") ? "deterministic" : "default";
 		this.confidenceLog.push({
@@ -2257,6 +2640,13 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 		};
 		this.steps.push(observationStep);
 		this.emit("observation", observationStep);
+		return observationStep;
+	}
+	/**
+	* Create and emit an observation step, scoring confidence for the result
+	*/
+	emitObservationStep(toolName, observation) {
+		this.buildObservationStep(toolName, observation);
 	}
 	/**
 	* Score the confidence of a tool result.
@@ -2313,6 +2703,22 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 	}
 };
 /**
+* Trim the steps array to keep only the last N iterations worth of steps.
+*
+* Each iteration produces 1-5 steps (thought, action(s), observation(s), final_answer).
+* With parallel tool calls an iteration can produce more: 1 thought + N actions + N observations.
+* For 3 parallel tools = 7 steps, so we use 7 as the estimate.
+* The failure mode is benign: over-trim loses old steps (harmless), under-trim keeps
+* a few extra (also harmless — bounded by the next trim call).
+*/
+function trimSteps(steps, maxIterations) {
+	const maxSteps = maxIterations * 7;
+	if (steps.length > maxSteps) {
+		const removeCount = steps.length - maxSteps;
+		steps.splice(0, removeCount);
+	}
+}
+/**
 * Trim conversation history to keep only the initial messages (system + user query)
 * plus the last N iterations of assistant/tool/user messages.
 *
@@ -2880,10 +3286,6 @@ var Logger = class Logger {
 	});
 };
 dotenv.config();
-function obfuscateApiKey(apiKey) {
-	if (!apiKey) return apiKey;
-	return `${apiKey.slice(0, 3)}${"*".repeat(apiKey.length - 6)}${apiKey.slice(-3)}`;
-}
 /**
 * Execute an array of async tasks either in parallel (with concurrency limiting)
 * or sequentially, returning outcomes in the original order.
@@ -2966,50 +3368,6 @@ async function handleToolResultStreaming(toolName, toolResult, streamCallback) {
 }
 promisify(dns.resolve4);
 promisify(dns.resolve6);
-let HttpStatus = /* @__PURE__ */ function(HttpStatus) {
-	HttpStatus[HttpStatus["Ok"] = 200] = "Ok";
-	HttpStatus[HttpStatus["Created"] = 201] = "Created";
-	HttpStatus[HttpStatus["BadRequest"] = 400] = "BadRequest";
-	HttpStatus[HttpStatus["Unauthorized"] = 401] = "Unauthorized";
-	HttpStatus[HttpStatus["Forbidden"] = 403] = "Forbidden";
-	HttpStatus[HttpStatus["NotFound"] = 404] = "NotFound";
-	HttpStatus[HttpStatus["UnprocessableEntity"] = 422] = "UnprocessableEntity";
-	HttpStatus[HttpStatus["TooManyRequests"] = 429] = "TooManyRequests";
-	HttpStatus[HttpStatus["InternalServerError"] = 500] = "InternalServerError";
-	return HttpStatus;
-}({});
-var HTTPError = class extends Error {
-	constructor(statusCode, message, additionalInfo) {
-		super(message);
-		this.statusCode = statusCode;
-		this.additionalInfo = additionalInfo;
-		this.name = "HTTPError";
-	}
-};
-var InternalServerError = class extends HTTPError {
-	constructor(message, additionalInfo) {
-		super(HttpStatus.InternalServerError, message, additionalInfo);
-		this.additionalInfo = additionalInfo;
-		this.name = "InternalServerError";
-	}
-};
-var NotFoundError = class extends HTTPError {
-	constructor(message, additionalInfo) {
-		super(HttpStatus.NotFound, message, additionalInfo);
-		this.additionalInfo = additionalInfo;
-		this.name = "NotFoundError";
-	}
-};
-var UnprocessableEntityError = class extends HTTPError {
-	constructor(message, additionalInfo) {
-		super(HttpStatus.UnprocessableEntity, message, additionalInfo);
-		this.additionalInfo = additionalInfo;
-		this.name = "UnprocessableEntityError";
-	}
-};
-function isZodError(err) {
-	return Boolean(err && (err instanceof ZodError || err.name === "ZodError"));
-}
 SupportedFabFileMimeTypes.TXT_PLAIN, SupportedFabFileMimeTypes.TXT_MARKDOWN, SupportedFabFileMimeTypes.TXT_MD_LEGACY, SupportedFabFileMimeTypes.HTML, SupportedFabFileMimeTypes.CSV, SupportedFabFileMimeTypes.JPG, SupportedFabFileMimeTypes.PNG, SupportedFabFileMimeTypes.PDF, SupportedFabFileMimeTypes.JSON, SupportedFabFileMimeTypes.DOCX, SupportedFabFileMimeTypes.XLSX, SupportedFabFileMimeTypes.XLS, SupportedFabFileMimeTypes.JS, SupportedFabFileMimeTypes.JSX, SupportedFabFileMimeTypes.TS, SupportedFabFileMimeTypes.PY, SupportedFabFileMimeTypes.JAVA, SupportedFabFileMimeTypes.CPP, SupportedFabFileMimeTypes.CS, SupportedFabFileMimeTypes.PHP, SupportedFabFileMimeTypes.RUBY, SupportedFabFileMimeTypes.GO, SupportedFabFileMimeTypes.SWIFT, SupportedFabFileMimeTypes.KOTLIN, SupportedFabFileMimeTypes.RUST, SupportedFabFileMimeTypes.CSS, SupportedFabFileMimeTypes.LESS, SupportedFabFileMimeTypes.SASS, SupportedFabFileMimeTypes.SCSS, SupportedFabFileMimeTypes.YAML, SupportedFabFileMimeTypes.TOML, SupportedFabFileMimeTypes.SH, SupportedFabFileMimeTypes.BASH;
 /**
 * Anthropic-specific caching adapter
@@ -3676,6 +4034,7 @@ const GPT5_4_MODELS = [
 	ChatModels.GPT5_4_MINI,
 	ChatModels.GPT5_4_NANO
 ];
+const GPT5_5_MODELS = [ChatModels.GPT5_5];
 const effortMap = {
 	simple: "low",
 	contextual: "low",
@@ -3904,6 +4263,28 @@ var OpenAIBackend = class {
 				description: "OpenAI's compact reasoning model optimized for fast, cost-efficient performance with strong multimodal and agentic capabilities. Excellent for STEM tasks and coding.",
 				isSlowModel: true
 			},
+			{
+				id: ChatModels.GPT5_5,
+				type: "text",
+				name: "GPT-5.5",
+				backend: ModelBackend.OpenAI,
+				contextWindow: 105e4,
+				max_tokens: 128e3,
+				can_stream: true,
+				can_think: false,
+				pricing: { 105e4: {
+					input: 5 / 1e6,
+					output: 30 / 1e6
+				} },
+				supportsVision: true,
+				supportsImageVariation: false,
+				supportsTools: true,
+				logoFile: "OpenAI_Logo.svg",
+				rank: 0,
+				trainingCutoff: "2025-12-01",
+				releaseDate: "2026-04-27",
+				description: "OpenAI's next-generation flagship GPT-5.5 model. A new class of intelligence for coding and professional work with a 1M+ context window, advanced reasoning, vision, and tool use."
+			},
 			{
 				id: ChatModels.GPT5_4,
 				type: "text",
@@ -3924,7 +4305,7 @@ var OpenAIBackend = class {
 				rank: 1,
 				trainingCutoff: "2025-08-31",
 				releaseDate: "2026-03-05",
-				description: "OpenAI's latest and most capable GPT model. Flagship of the GPT-5 family with top-tier reasoning, creativity, and vision understanding."
+				description: "High-performing GPT-5.4 model with strong reasoning, creativity, and vision understanding. A reliable workhorse in the GPT-5 family."
 			},
 			{
 				id: ChatModels.GPT5_4_MINI,
@@ -4255,6 +4636,22 @@ var OpenAIBackend = class {
 				description: "OpenAI GPT-Image-1.5 - Enhanced version of GPT-Image-1 with improved image generation quality and text integration, supporting up to 2048x2048 resolution and image editing capabilities.",
 				rank: 9
 			},
+			{
+				id: ImageModels.GPT_IMAGE_2,
+				type: "image",
+				name: "GPT-Image-2",
+				backend: ModelBackend.OpenAI,
+				contextWindow: 1e4,
+				supportsImageVariation: true,
+				max_tokens: 1e4,
+				pricing: { 1: {
+					input: 8 / 1e6,
+					output: 30 / 1e6
+				} },
+				description: "OpenAI GPT-Image-2 - State-of-the-art image generation with flexible resolutions up to 4K, improved quality, and fast generation. Supports editing and multi-image reference inputs.",
+				rank: 8,
+				releaseDate: "2026-04-21"
+			},
 			{
 				id: ImageModels.GPT_IMAGE_1_MINI,
 				type: "image",
@@ -4360,7 +4757,8 @@ var OpenAIBackend = class {
 		const isGPT5_1Model = GPT5_1_MODELS.includes(model);
 		const isGPT5_2Model = GPT5_2_MODELS.includes(model);
 		const isGPT5_4Model = GPT5_4_MODELS.includes(model);
-		const usesMaxCompletionTokens = isO1Model || isGPT5Model || isGPT5_1Model || isGPT5_2Model || isGPT5_4Model;
+		const isGPT5_5Model = GPT5_5_MODELS.includes(model);
+		const usesMaxCompletionTokens = isO1Model || isGPT5Model || isGPT5_1Model || isGPT5_2Model || isGPT5_4Model || isGPT5_5Model;
 		const parameters = {
 			model,
 			messages: this.formatMessages(messages, isO1Model, model, options),
@@ -4751,7 +5149,7 @@ var OpenAIBackend = class {
 	formatMessages(messages, isO1Model, model, options) {
 		const filteredMessages = isO1Model ? messages.filter((msg) => msg.role !== "system") : messages;
 		const toolNames = options.tools?.map((tool) => tool.toolSchema.name) || [];
-		const isGPT5Family = GPT5_MODELS.includes(model) || GPT5_1_MODELS.includes(model) || GPT5_2_MODELS.includes(model) || GPT5_4_MODELS.includes(model);
+		const isGPT5Family = GPT5_MODELS.includes(model) || GPT5_1_MODELS.includes(model) || GPT5_2_MODELS.includes(model) || GPT5_4_MODELS.includes(model) || GPT5_5_MODELS.includes(model);
 		let systemContent;
 		if (isGPT5Family) {
 			systemContent = "You are a helpful assistant.";
@@ -4792,14 +5190,6 @@ var OpenAIBackend = class {
 		}));
 	}
 };
-function secureParameters(params, schema) {
-	try {
-		return schema.parse(params);
-	} catch (e) {
-		if (isZodError(e)) throw new UnprocessableEntityError(e.issues.map((err) => `${err.path.join(".")}: ${err.message}`).join(", "));
-		throw new InternalServerError();
-	}
-}
 var NotificationDeduplicator = class {
 	errorGroups = /* @__PURE__ */ new Map();
 	lowCreditTiers = {};
@@ -4923,28 +5313,22 @@ async function postMessageToSlack(slackWebhookUrl, message) {
 		Logger.error("Error posting message to Slack:", error);
 	}
 }
-let EmbeddingModelProvider = /* @__PURE__ */ function(EmbeddingModelProvider) {
-	EmbeddingModelProvider["OPENAI"] = "OpenAI";
-	EmbeddingModelProvider["BEDROCK"] = "Amazon Bedrock";
-	EmbeddingModelProvider["VOYAGE_AI"] = "Voyage AI";
-	return EmbeddingModelProvider;
-}({});
-BedrockEmbeddingModel.TITAN_TEXT_EMBEDDINGS_V2, EmbeddingModelProvider.BEDROCK, BedrockEmbeddingModel.TITAN_TEXT_EMBEDDINGS_V2;
+BedrockEmbeddingModel.TITAN_TEXT_EMBEDDINGS_V2, BedrockEmbeddingModel.TITAN_TEXT_EMBEDDINGS_V2;
 const OPENAI_EMBEDDING_MODEL_MAP = {
 	[OpenAIEmbeddingModel.TEXT_EMBEDDING_3_SMALL]: {
-		provider: EmbeddingModelProvider.OPENAI,
+		provider: "OpenAI",
 		model: OpenAIEmbeddingModel.TEXT_EMBEDDING_3_SMALL,
 		contextWindow: 8192,
 		dimensions: [1536]
 	},
 	[OpenAIEmbeddingModel.TEXT_EMBEDDING_3_LARGE]: {
-		provider: EmbeddingModelProvider.OPENAI,
+		provider: "OpenAI",
 		model: OpenAIEmbeddingModel.TEXT_EMBEDDING_3_LARGE,
 		contextWindow: 8192,
 		dimensions: [3072]
 	},
 	[OpenAIEmbeddingModel.TEXT_EMBEDDING_ADA_002]: {
-		provider: EmbeddingModelProvider.OPENAI,
+		provider: "OpenAI",
 		model: OpenAIEmbeddingModel.TEXT_EMBEDDING_ADA_002,
 		contextWindow: 8192,
 		dimensions: [1536]
@@ -5147,7 +5531,7 @@ const OPENAI_EMBEDDING_MODEL_MAP = {
 		return OPENAI_EMBEDDING_MODEL_MAP[this.model];
 	}
 });
-VoyageAIEmbeddingModel.VOYAGE_3_LARGE, EmbeddingModelProvider.VOYAGE_AI, VoyageAIEmbeddingModel.VOYAGE_3_LARGE, VoyageAIEmbeddingModel.VOYAGE_3, EmbeddingModelProvider.VOYAGE_AI, VoyageAIEmbeddingModel.VOYAGE_3, VoyageAIEmbeddingModel.VOYAGE_3_LITE, EmbeddingModelProvider.VOYAGE_AI, VoyageAIEmbeddingModel.VOYAGE_3_LITE, VoyageAIEmbeddingModel.VOYAGE_CODE_3, EmbeddingModelProvider.VOYAGE_AI, VoyageAIEmbeddingModel.VOYAGE_CODE_3, VoyageAIEmbeddingModel.VOYAGE_FINANCE_3, EmbeddingModelProvider.VOYAGE_AI, VoyageAIEmbeddingModel.VOYAGE_FINANCE_3, VoyageAIEmbeddingModel.VOYAGE_LAW_3, EmbeddingModelProvider.VOYAGE_AI, VoyageAIEmbeddingModel.VOYAGE_LAW_3;
+VoyageAIEmbeddingModel.VOYAGE_3_LARGE, VoyageAIEmbeddingModel.VOYAGE_3_LARGE, VoyageAIEmbeddingModel.VOYAGE_3, VoyageAIEmbeddingModel.VOYAGE_3, VoyageAIEmbeddingModel.VOYAGE_3_LITE, VoyageAIEmbeddingModel.VOYAGE_3_LITE, VoyageAIEmbeddingModel.VOYAGE_CODE_3, VoyageAIEmbeddingModel.VOYAGE_CODE_3, VoyageAIEmbeddingModel.VOYAGE_FINANCE_3, VoyageAIEmbeddingModel.VOYAGE_FINANCE_3, VoyageAIEmbeddingModel.VOYAGE_LAW_3, VoyageAIEmbeddingModel.VOYAGE_LAW_3;
 z.object({
 	text: z.string(),
 	tokenCount: z.number()
@@ -5164,7 +5548,7 @@ z.object({
 */
 const MAX_GOAL_LENGTH = 1e3;
 const MAX_DESCRIPTION_LENGTH = 2e3;
-ChatModels.GPT5, ChatModels.GPT5_MINI, ChatModels.GPT5_NANO, ChatModels.GPT5_1, ChatModels.GPT5_2, ChatModels.GPT5_4, ChatModels.GPT5_4_MINI, ChatModels.GPT5_4_NANO;
+ChatModels.GPT5, ChatModels.GPT5_MINI, ChatModels.GPT5_NANO, ChatModels.GPT5_1, ChatModels.GPT5_2, ChatModels.GPT5_4, ChatModels.GPT5_4_MINI, ChatModels.GPT5_4_NANO, ChatModels.GPT5_5;
 /**
 * Invokes the image processor Lambda to convert and resize images
 * This is a serverless alternative to using sharp directly
@@ -5256,18 +5640,34 @@ var OpenAIImageService = class extends AIImageService {
 					parameterWarnings.push(`Quality parameter ('${openaiOptions.quality}') is not supported by ${modelName} text-to-image generation and was removed`);
 					delete openaiOptions.quality;
 				}
-				const validGPTSizes = [
-					"1024x1024",
-					"1536x1024",
-					"1024x1536"
-				];
-				if (openaiOptions.size) {
-					if (!validGPTSizes.includes(openaiOptions.size)) {
-						const originalSize = openaiOptions.size;
-						openaiOptions.size = "1024x1024";
-						parameterWarnings.push(`Size '${originalSize}' is not supported by ${modelName}, changed to '1024x1024'`);
-					}
-				} else openaiOptions.size = "1024x1024";
+				if (isGPTImage2Model(options.model)) {
+					if (openaiOptions.size && openaiOptions.size !== "auto") {
+						const [w, h] = openaiOptions.size.split("x").map(Number);
+						if (w && h) {
+							const maxEdge = Math.max(w, h);
+							const minEdge = Math.min(w, h);
+							const totalPixels = w * h;
+							if (maxEdge > 3840 || w % 16 !== 0 || h % 16 !== 0 || maxEdge / minEdge > 3 || totalPixels < 655360 || totalPixels > 8294400) {
+								const originalSize = openaiOptions.size;
+								openaiOptions.size = "1024x1024";
+								parameterWarnings.push(`Size '${originalSize}' violates gpt-image-2 constraints, changed to '1024x1024'`);
+							}
+						}
+					} else if (!openaiOptions.size) openaiOptions.size = "auto";
+				} else {
+					const validGPTSizes = [
+						"1024x1024",
+						"1536x1024",
+						"1024x1536"
+					];
+					if (openaiOptions.size) {
+						if (!validGPTSizes.includes(openaiOptions.size)) {
+							const originalSize = openaiOptions.size;
+							openaiOptions.size = "1024x1024";
+							parameterWarnings.push(`Size '${originalSize}' is not supported by ${modelName}, changed to '1024x1024'`);
+						}
+					} else openaiOptions.size = "1024x1024";
+				}
 				if ("width" in openaiOptions || "height" in openaiOptions) {
 					delete openaiOptions.width;
 					delete openaiOptions.height;
@@ -5302,7 +5702,7 @@ var OpenAIImageService = class extends AIImageService {
 				const pngBuffer = await invokeImageProcessor(imageBuffer, this.imageProcessorLambdaName, 4);
 				const imageFile = new File([pngBuffer], "image.png", { type: "image/png" });
 				if (isGPTImageModel(options.model)) {
-					const editModel = options.model || ImageModels.GPT_IMAGE_1_5;
+					const editModel = options.model || ImageModels.GPT_IMAGE_2;
 					result = await openai.images.edit({
 						model: editModel,
 						image: [imageFile],
@@ -5361,7 +5761,7 @@ If you believe this is an error, you can report it to OpenAI with request ID: ${
 			throw new Error(`Image response contains neither url nor b64_json: ${JSON.stringify(Object.keys(imageData))}`);
 		});
 	}
-	async edit(image, prompt, { mask = null, model = ImageModels.GPT_IMAGE_1_5, n = 1, size, response_format = "url", user }) {
+	async edit(image, prompt, { mask = null, model = ImageModels.GPT_IMAGE_2, n = 1, size, response_format = "url", user }) {
 		try {
 			const openai = new OpenAI({ apiKey: this.apiKey });
 			const cleanImageBase64 = image.replace(/^data:image\/(png|jpeg|jpg);base64,/, "");
@@ -5379,8 +5779,8 @@ If you believe this is an error, you can report it to OpenAI with request ID: ${
 			}
 			let editModel = model;
 			if (!isGPTImageModel(model) && model !== ImageModels.DALL_E_2) {
-				console.log(`[DEBUG] ⚠️ Edit endpoint doesn't support ${model}, defaulting to gpt-image-1.5`);
-				editModel = ImageModels.GPT_IMAGE_1_5;
+				console.log(`[DEBUG] ⚠️ Edit endpoint doesn't support ${model}, defaulting to gpt-image-2`);
+				editModel = ImageModels.GPT_IMAGE_2;
 			}
 			const response = await openai.images.edit(isGPTImageModel(editModel) ? {
 				model: editModel,
@@ -6141,6 +6541,12 @@ z.object({
 	type: z.enum(KnowledgeType),
 	content: z.union([z.string(), z.instanceof(Buffer)]).optional(),
 	organizationId: z.string().optional(),
+	/**
+	* Content type of the file
+	* @example 'text/markdown'
+	* @example 'application/pdf'
+	* @example 'application/octet-stream' for binary files
+	*/
 	contentType: z.string().optional(),
 	public: z.boolean().optional(),
 	prefix: z.string().optional(),
@@ -8314,7 +8720,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-M5WOOsBu.mjs
+//#region ../../b4m-core/services/dist/tools-s4H4po60.mjs
 async function performDeepResearch(context, params, config) {
 	const maxDepth = config.maxDepth || 7;
 	const duration = config.duration || 4.5;
@@ -8794,8 +9200,8 @@ const imageGenerationTool = {
 				return "Image model selection required. A model picker has been presented to the user.";
 			}
 			const { prompt, n: toolN, quality: toolQuality, size: toolSize, safety_tolerance: toolSafetyTolerance } = val;
-			let model = imageConfig?.model || ImageModels.GPT_IMAGE_1_5;
-			if (model === ImageModels.GPT_IMAGE_1) model = ImageModels.GPT_IMAGE_1_5;
+			let model = imageConfig?.model || ImageModels.GPT_IMAGE_2;
+			if (model === ImageModels.GPT_IMAGE_1) model = ImageModels.GPT_IMAGE_2;
 			const n = toolN ?? imageConfig?.n ?? 1;
 			const quality = imageConfig?.quality || toolQuality;
 			const size = imageConfig?.size || toolSize;
@@ -9894,6 +10300,7 @@ const EDIT_SUPPORTED_MODELS = [
 	ImageModels.GPT_IMAGE_1,
 	ImageModels.GPT_IMAGE_1_5,
 	ImageModels.GPT_IMAGE_1_MINI,
+	ImageModels.GPT_IMAGE_2,
 	ImageModels.FLUX_PRO_FILL,
 	ImageModels.GEMINI_2_5_FLASH_IMAGE,
 	ImageModels.GEMINI_3_PRO_IMAGE_PREVIEW
@@ -14549,7 +14956,11 @@ z.object({
 	search: z.string().optional().prefault(""),
 	type: z.enum(CollectionType).optional()
 });
-z.object({ userId: z.string() });
+z.object({ 
+/**
+* The user to recalculate the storage for
+*/
+userId: z.string() });
 z.object({
 	coverage: z.enum(["all", "important"]).prefault("important"),
 	userId: z.string().optional()
@@ -14827,10 +15238,17 @@ z.object({ sessionId: z.string() });
 z.object({ sessionId: z.string() });
 z.object({
 	sessionId: z.string(),
+	/** The maximum number of words to include in the title */
 	maxWords: z.number().optional()
 });
 z.object({
+	/**
+	* Text search query (searches in name and description)
+	*/
 	query: z.string().optional(),
+	/**
+	* Filter by personal organizations
+	*/
 	filters: z.object({
 		personal: z.union([z.enum(["true", "false"]).transform((val) => val === "true"), z.boolean()]).optional(),
 		userId: z.string().optional()
@@ -14854,7 +15272,11 @@ z.object({
 		direction: "asc"
 	})
 });
-z.object({ id: z.string().min(1) });
+z.object({ 
+/**
+* Organization ID
+*/
+id: z.string().min(1) });
 z.object({
 	userId: z.string().optional(),
 	email: z.string().optional(),
@@ -14862,7 +15284,11 @@ z.object({
 	force: z.boolean().optional()
 });
 z.object({ id: z.string() });
-z.object({ id: z.string().min(1) });
+z.object({ 
+/**
+* Organization ID
+*/
+id: z.string().min(1) });
 z.object({ organizationId: z.string() });
 z.object({ id: z.string() });
 z.object({ id: z.string() });
@@ -14930,9 +15356,12 @@ z.object({
 		direction: z.enum(["asc", "desc"])
 	}).optional(),
 	options: z.object({
+		textSearch: z.coerce.boolean().optional(),
 		includeShared: z.coerce.boolean().optional(),
 		userGroups: z.array(z.string()).optional(),
-		dataLakeTags: z.array(z.string()).optional()
+		dataLakeTags: z.array(z.string()).optional(),
+		dataLakeTagPrefixes: z.array(z.string()).optional(),
+		excludeContent: z.coerce.boolean().optional()
 	}).optional()
 });
 z.object({ fileId: z.string() });
@@ -14958,11 +15387,13 @@ z.object({
 });
 z.object({
 	id: z.string(),
+	/** The user ID of the recipient of the friend request */
 	userId: z.string(),
 	accept: z.boolean()
 });
 z.object({
 	friendshipId: z.string(),
+	/** The user ID of the user who wants to unfriend the other user */
 	userId: z.string()
 });
 z.object({ userId: z.string() });
@@ -14972,6 +15403,9 @@ z.object({ key: z.string() });
 z.object({
 	key: z.string(),
 	value: z.any(),
+	/**
+	* Time to live in milliseconds
+	*/
 	ttl: z.number(),
 	recache: z.boolean().optional()
 });
@@ -14993,7 +15427,11 @@ z.object({
 });
 z.object({ id: z.string() });
 z.object({ id: z.string() });
-z.object({ id: z.string() });
+z.object({ 
+/**
+* The ID of the research agent
+*/
+id: z.string() });
 z.object({ id: z.string() });
 const researchTaskCreateSchema = z.object({
 	researchAgentId: z.string(),
@@ -15365,8 +15803,11 @@ z.object({
 		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()
 });
 /**
@@ -18251,7 +18692,7 @@ function wrapToolWithPermission(tool, permissionManager, showPermissionPrompt, a
 				return result;
 			}
 			if (!permissionManager.needsPermission(toolName, { isSandboxed })) return executeAndRecord();
-			const { useCliStore } = await import("./store-nZExNOWX.mjs");
+			const { useCliStore } = await import("./store-B_ILRSdP.mjs");
 			if (useCliStore.getState().autoAcceptEdits) return executeAndRecord();
 			const response = await showPermissionPrompt(toolName, effectiveArgs, await generateToolPreview(toolName, args, isSandboxed));
 			if (response.action === "deny") throw new PermissionDeniedError(toolName, args);
@@ -18974,7 +19415,7 @@ var MCPClient = class {
 				console.log(`[MCP] Using server: ${this.serverName} at ${serverScriptPath}`);
 			}
 			const stderrMode = this.suppressStderr ? "ignore" : this.onStderrLine ? "pipe" : void 0;
-			this.transport = new StdioClientTransport({
+			const transportConfig = {
 				command,
 				args,
 				env: {
@@ -18982,14 +19423,16 @@ var MCPClient = class {
 					...envVarsObject
 				},
 				...stderrMode && { stderr: stderrMode }
-			});
+			};
+			this.transport = new StdioClientTransport(transportConfig);
 			this.transport.onerror = (error) => {
 				console.error(`[MCP] Transport error for ${this.serverName}:`, error);
 			};
 			await this.mcp.connect(this.transport);
 			if (this.onStderrLine && this.transport.stderr) this.readStderr(this.transport.stderr);
 			await new Promise((resolve) => setTimeout(resolve, 100));
-			this.tools = (await this.mcp.listTools()).tools.map((tool) => {
+			const toolsResult = await this.mcp.listTools();
+			this.tools = toolsResult.tools.map((tool) => {
 				return {
 					name: tool.name,
 					description: tool.description,
@@ -19539,9 +19982,13 @@ var ServerLlmBackend = class ServerLlmBackend {
 		this.MAX_STREAM_RETRIES = 2;
 	}
 	constructor(options) {
-		this.completionsEndpoint = "/api/ai/v1/completions";
 		this.apiClient = options.apiClient;
 		this.currentModel = options.model;
+		if (options.completionsUrl) this.completionsEndpoint = options.completionsUrl;
+		else {
+			logger.debug("[ServerLlmBackend] No completionsUrl from server — is sst dev running?");
+			this.completionsEndpoint = "/api/ai/v1/completions";
+		}
 	}
 	/**
 	* Make authenticated LLM completion request via server
@@ -20841,7 +21288,8 @@ var SubagentOrchestrator = class {
 			const { result: agentResult, attempts } = await withRetry(() => agent.run(task, {
 				maxIterations,
 				parallelExecution: this.deps.enableParallelToolExecution === true,
-				isReadOnlyTool
+				isReadOnlyTool,
+				maxHistoryIterations: 4
 			}), {
 				maxRetries: agentDef.retry.maxRetries,
 				initialDelayMs: agentDef.retry.initialDelayMs,
@@ -21110,6 +21558,7 @@ const MODEL_ALIASES = {
 	"gpt-5.4": ChatModels.GPT5_4,
 	"gpt-5.4-mini": ChatModels.GPT5_4_MINI,
 	"gpt-5.4-nano": ChatModels.GPT5_4_NANO,
+	"gpt-5.5": ChatModels.GPT5_5,
 	o1: ChatModels.O1,
 	"o1-preview": ChatModels.O1_PREVIEW,
 	"o1-mini": ChatModels.O1_MINI,
@@ -21952,8 +22401,11 @@ function createBackgroundAgentTools(manager) {
 * Schema for a single decomposed task in the pipeline
 */
 const DecomposedTaskSchema = z.object({
+	/** Unique identifier for this task within the pipeline */
 	id: z.string().min(1),
+	/** Human-readable description of what needs to be done */
 	description: z.string().min(1),
+	/** Which agent type should handle this task */
 	agentType: z.enum([
 		"explore",
 		"plan",
@@ -21961,6 +22413,7 @@ const DecomposedTaskSchema = z.object({
 		"review",
 		"test"
 	]),
+	/** IDs of tasks that must complete before this one can start */
 	dependsOn: z.array(z.string()).default([])
 });
 /**
@@ -23000,7 +23453,7 @@ function createGetFileStructureTool() {
 				if (stats.isDirectory()) return `Error: Path is a directory, not a file: ${params.path}`;
 				if (stats.size > MAX_FILE_SIZE) return `Error: File too large (${(stats.size / 1024 / 1024).toFixed(2)}MB). Max: ${MAX_FILE_SIZE / 1024 / 1024}MB`;
 				const ext = path.extname(resolvedPath).toLowerCase();
-				const { getLanguageForExtension, parseFileStructure, getSupportedLanguages } = await import("./treeSitterEngine-DCSXcm_3.mjs");
+				const { getLanguageForExtension, parseFileStructure, getSupportedLanguages } = await import("./treeSitterEngine-BFTHnDwH.mjs");
 				const languageId = getLanguageForExtension(ext);
 				if (!languageId) return `Error: Unsupported file type "${ext}". Supported languages: ${getSupportedLanguages().join(", ")}`;
 				const sourceCode = await promises.readFile(resolvedPath, "utf-8");