@librechat/agents 3.8.5 → 3.8.7

package/dist/esm/tools/BashExecutor.mjs

@@ -4,8 +4,10 @@ import { resolveFetchProxyAgent } from "../utils/proxy.mjs";
 import { INTENT_PROPERTY } from "./intentArg.mjs";
 import { appendArtifactDeliveryWarning, normalizeArtifactDeliveryFailure } from "./ArtifactDelivery.mjs";
 import { logCodeApiDiagnostic } from "./diagnostics.mjs";
-import { appendCodeSessionFileSummary } from "./CodeSessionFileSummary.mjs";
-import { BASH_SHELL_GUIDANCE, CODE_ARTIFACT_PATH_GUIDANCE, CodeApiRequestError, addCodeApiExecutionProfileHeader, appendFailedExecutionFileReminder, appendTmpScratchReminder, buildCodeApiEndpoint, buildCodeApiHttpErrorMessage, emptyOutputMessage, getCodeBaseURL, normalizeCodeApiRequestError, resolveCodeApiAuthHeaders, selectRuntimeSessionHint } from "./CodeExecutor.mjs";
+import { appendCodeSessionFileSummary, appendExecutionArtifactFileSummary } from "./CodeSessionFileSummary.mjs";
+import { BASH_SHELL_GUIDANCE, CODE_ARTIFACT_PATH_GUIDANCE, CodeApiRequestError, addCodeApiExecutionProfileHeader, appendFailedExecutionFileReminder, appendTmpScratchReminder, buildCodeApiEndpoint, buildCodeApiExecutionErrorMessage, buildCodeApiHttpErrorMessage, emptyOutputMessage, getCodeBaseURL, normalizeCodeApiRequestError, resolveCodeApiAuthHeaders, selectRuntimeSessionHint } from "./CodeExecutor.mjs";
+import { makeRequest } from "./ProgrammaticToolCalling.mjs";
+import { prepareBashProgrammaticCode } from "./BashProgrammaticToolCalling.mjs";
 import { tool } from "@langchain/core/tools";
 import { config } from "dotenv";
 import fetch from "node-fetch";
@@ -58,6 +60,16 @@ Usage:
 - ${BASH_SHELL_GUIDANCE}
 - NEVER use this tool to execute malicious commands.
 `.trim();
+const AttachedWorkspaceBashExecutionToolDescription = `
+Runs bash commands in the selected persistent project through an isolated sandbox process.
+
+Usage:
+- Project file changes persist between calls; shell variables, background processes, and execution-private temporary files do not.
+- Injected files and generated artifacts use \${LIBRECHAT_CODE_DATA_DIR:-/mnt/data}; write durable files to the project root.
+- Generated artifacts are automatically delivered; **DO NOT** provide download links.
+- ${BASH_SHELL_GUIDANCE}
+- NEVER use this tool to execute malicious commands.
+`.trim();
 const BashToolOutputReferencesGuide = `
 Referencing previous tool outputs:
 - Every successful tool result is tagged with a reference key of the form \`tool<idx>turn<turn>\` (e.g., \`tool0turn0\`). The key appears either as a \`[ref: tool0turn0]\` prefix line or, when the output is a JSON object, as a \`_ref\` field on the object.
@@ -69,15 +81,23 @@ Referencing previous tool outputs:
 - Unknown reference keys are left in place and surfaced as \`[unresolved refs: …]\` after the output.
 `.trim();
 function buildBashExecutionToolDescription(options) {
-	const base = options?.statefulSessions === true ? StatefulBashExecutionToolDescription : BashExecutionToolDescription;
+	let base = BashExecutionToolDescription;
+	if (options?.attachedWorkspace === true) base = AttachedWorkspaceBashExecutionToolDescription;
+	else if (options?.statefulSessions === true) base = StatefulBashExecutionToolDescription;
 	if (options?.enableToolOutputReferences === true) return `${base}\n\n${BashToolOutputReferencesGuide}`;
 	return base;
 }
 const STATELESS_BASH_PARAM_NOTE = "The environment is stateless; variables and state don't persist between executions.";
 const STATEFUL_BASH_PARAM_NOTE = "Files written to /mnt/data persist between calls on the same warm machine. Each call runs in a fresh sandbox: shell variables, cwd, /tmp, and background processes do NOT survive the call. Only /mnt/data is durable.";
+const ATTACHED_BASH_PARAM_NOTE = "Commands start in the selected persistent project. Project file changes persist, but shell variables, background processes, and execution-private temporary files do not.";
+const ATTACHED_BASH_ARTIFACT_PATH_GUIDANCE = "Injected files and generated artifacts use `${LIBRECHAT_CODE_DATA_DIR:-/mnt/data}` for this execution only. Write anything needed later into the selected project.";
+const ATTACHED_BASH_TMP_REMINDER = "Note: /tmp files are same-call scratch only and were not persisted; write files needed later into the selected project.";
 function buildBashExecutionToolSchema(opts) {
-	const note = opts?.statefulSessions === true ? STATEFUL_BASH_PARAM_NOTE : STATELESS_BASH_PARAM_NOTE;
-	const commandDescription = BashExecutionToolSchema.properties.command.description.replace(STATELESS_BASH_PARAM_NOTE, note);
+	let note = STATELESS_BASH_PARAM_NOTE;
+	if (opts?.attachedWorkspace === true) note = ATTACHED_BASH_PARAM_NOTE;
+	else if (opts?.statefulSessions === true) note = STATEFUL_BASH_PARAM_NOTE;
+	let commandDescription = BashExecutionToolSchema.properties.command.description.replace(STATELESS_BASH_PARAM_NOTE, note);
+	if (opts?.attachedWorkspace === true) commandDescription = commandDescription.replace("- Prior /mnt/data files are available and can be modified in place.\n", "").replace(CODE_ARTIFACT_PATH_GUIDANCE, ATTACHED_BASH_ARTIFACT_PATH_GUIDANCE);
 	return {
 		...BashExecutionToolSchema,
 		properties: {
@@ -90,20 +110,33 @@ function buildBashExecutionToolSchema(opts) {
 	};
 }
 const BashExecutionToolName = "bash_tool";
+function quoteBashArgument(value) {
+	return `'${value.replace(/'/g, "'\"'\"'")}'`;
+}
+function commandWithArguments(command, args) {
+	if (args == null || args.length === 0) return command;
+	return `bash -c ${quoteBashArgument(command)} -- ${args.map(quoteBashArgument).join(" ")}`;
+}
 const BashExecutionToolDefinition = {
 	name: BashExecutionToolName,
 	description: BashExecutionToolDescription,
 	schema: BashExecutionToolSchema
 };
 function createBashExecutionTool(params = {}) {
-	const execEndpoint = buildCodeApiEndpoint(params?.baseUrl ?? getCodeBaseURL(), "exec");
+	const workspaceId = params?.workspaceId?.trim();
+	const hasWorkspace = workspaceId != null && workspaceId !== "";
+	if (hasWorkspace && !/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/.test(workspaceId)) throw new Error("Invalid attached workspace identifier");
+	const execEndpoint = buildCodeApiEndpoint(params?.baseUrl ?? getCodeBaseURL(), hasWorkspace ? "exec/programmatic" : "exec");
 	return tool(async (rawInput, config) => {
-		const { authHeaders, baseUrl: _baseUrl, executionProfile, runtimeSessionHint, statefulSessions, ...executionParams } = params ?? {};
-		const { command, intent: _ignoredIntent, runtime_session_hint: _ignoredModelHint, ...rest } = rawInput;
+		const { authHeaders, baseUrl: _baseUrl, executionProfile, runtimeSessionHint, statefulSessions, workspaceId: _workspaceId, ...executionParams } = params ?? {};
+		const { command: rawCommand, intent: _ignoredIntent, runtime_session_hint: _ignoredModelHint, args, ...rest } = rawInput;
+		const command = hasWorkspace ? commandWithArguments(rawCommand, args) : rawCommand;
 		const { session_id, _injected_files, _runtime_session_hint } = config.toolCall ?? {};
 		const postData = {
 			lang: "bash",
-			code: command,
+			code: hasWorkspace ? prepareBashProgrammaticCode(command) : command,
+			...hasWorkspace ? { tools: [] } : {},
+			...!hasWorkspace && args != null ? { args } : {},
 			...rest,
 			...executionParams
 		};
@@ -112,40 +145,53 @@ function createBashExecutionTool(params = {}) {
 		if (_injected_files && _injected_files.length > 0) postData.files = _injected_files;
 		else if (session_id != null && session_id.length > 0 && !Array.isArray(postData.files)) logCodeApiDiagnostic("BashExecutor", "debug", "session carried no injected files; exec will run without input files", { files: "none" });
 		try {
-			const fetchOptions = {
-				method: "POST",
-				headers: {
-					"Content-Type": "application/json",
-					"User-Agent": "LibreChat/1.0",
-					...addCodeApiExecutionProfileHeader(await resolveCodeApiAuthHeaders(authHeaders), executionProfile)
-				},
-				body: JSON.stringify(postData)
-			};
-			const proxyAgent = resolveFetchProxyAgent(execEndpoint);
-			if (proxyAgent != null) fetchOptions.agent = proxyAgent;
-			const response = await fetch(execEndpoint, fetchOptions);
-			if (!response.ok) throw new CodeApiRequestError(await buildCodeApiHttpErrorMessage("POST", execEndpoint, response, { profile: executionProfile }));
-			const result = await response.json();
+			const resolvedAuthHeaders = await resolveCodeApiAuthHeaders(authHeaders);
+			let result;
+			if (hasWorkspace) result = await makeRequest(execEndpoint, postData, void 0, {
+				...resolvedAuthHeaders,
+				"X-LibreChat-Code-Workspace-ID": workspaceId
+			}, executionProfile, config.signal);
+			else {
+				const fetchOptions = {
+					method: "POST",
+					headers: {
+						"Content-Type": "application/json",
+						"User-Agent": "LibreChat/1.0",
+						...addCodeApiExecutionProfileHeader(resolvedAuthHeaders, executionProfile)
+					},
+					body: JSON.stringify(postData),
+					signal: config.signal
+				};
+				const proxyAgent = resolveFetchProxyAgent(execEndpoint);
+				if (proxyAgent != null) fetchOptions.agent = proxyAgent;
+				const response = await fetch(execEndpoint, fetchOptions);
+				if (!response.ok) throw new CodeApiRequestError(await buildCodeApiHttpErrorMessage("POST", execEndpoint, response, { profile: executionProfile }));
+				result = await response.json();
+			}
+			if (hasWorkspace && result.status !== "completed") throw new CodeApiRequestError(buildCodeApiExecutionErrorMessage(result));
 			let formattedOutput = "";
-			if (result.stdout) formattedOutput += `stdout:\n${result.stdout}\n`;
+			if (typeof result.stdout === "string" && result.stdout.length > 0) formattedOutput += `stdout:\n${result.stdout}\n`;
 			else formattedOutput += emptyOutputMessage;
-			if (result.stderr) formattedOutput += `stderr:\n${result.stderr}\n`;
-			const outputWithReminder = appendTmpScratchReminder(formattedOutput, command);
+			if (typeof result.stderr === "string" && result.stderr.length > 0) formattedOutput += `stderr:\n${result.stderr}\n`;
+			const outputWithReminder = appendTmpScratchReminder(formattedOutput, command, hasWorkspace ? ATTACHED_BASH_TMP_REMINDER : void 0);
 			const artifactDelivery = normalizeArtifactDeliveryFailure(result.artifact_delivery);
 			const outputWithDeliveryWarning = appendArtifactDeliveryWarning(outputWithReminder, artifactDelivery);
 			const hasFiles = result.files != null && result.files.length > 0;
+			const deletionEcho = result.deleted_files != null ? { deleted_files: result.deleted_files } : {};
 			const runtimeEcho = result.runtime_session_id != null ? {
 				runtime_session_id: result.runtime_session_id,
 				runtime_status: result.runtime_status
 			} : {};
-			return [appendCodeSessionFileSummary(outputWithDeliveryWarning, result.files), hasFiles ? {
+			return [hasWorkspace ? appendExecutionArtifactFileSummary(outputWithDeliveryWarning, result.files) : appendCodeSessionFileSummary(outputWithDeliveryWarning, result.files), hasFiles ? {
 				session_id: result.session_id,
 				files: result.files,
 				...artifactDelivery != null ? { artifact_delivery: artifactDelivery } : {},
+				...deletionEcho,
 				...runtimeEcho
 			} : {
 				session_id: result.session_id,
 				...artifactDelivery != null ? { artifact_delivery: artifactDelivery } : {},
+				...deletionEcho,
 				...runtimeEcho
 			}];
 		} catch (error) {
@@ -153,8 +199,14 @@ function createBashExecutionTool(params = {}) {
 		}
 	}, {
 		name: BashExecutionToolName,
-		description: buildBashExecutionToolDescription({ statefulSessions: params?.statefulSessions }),
-		schema: buildBashExecutionToolSchema(params ?? void 0),
+		description: buildBashExecutionToolDescription({
+			statefulSessions: params?.statefulSessions,
+			attachedWorkspace: hasWorkspace
+		}),
+		schema: buildBashExecutionToolSchema({
+			statefulSessions: params?.statefulSessions,
+			attachedWorkspace: hasWorkspace
+		}),
 		responseFormat: "content_and_artifact"
 	});
 }

package/dist/esm/tools/BashExecutor.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"BashExecutor.mjs","names":[],"sources":["../../../src/tools/BashExecutor.ts"],"mappings":"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"}
+{"version":3,"file":"BashExecutor.mjs","names":[],"sources":["../../../src/tools/BashExecutor.ts"],"mappings":"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"}

package/dist/esm/tools/BashProgrammaticToolCalling.mjs

@@ -2,7 +2,7 @@ import "../common/enum.mjs";
 import "../common/index.mjs";
 import { INTENT_PROPERTY } from "./intentArg.mjs";
 import { logCodeApiDiagnostic } from "./diagnostics.mjs";
-import { BASH_SHELL_GUIDANCE, CODE_ARTIFACT_PATH_GUIDANCE, CodeApiRequestError, appendFailedExecutionFileReminder, buildCodeApiEndpoint, buildCodeApiExecutionErrorMessage, getCodeBaseURL, selectRuntimeSessionHint } from "./CodeExecutor.mjs";
+import { BASH_SHELL_GUIDANCE, CODE_ARTIFACT_PATH_GUIDANCE, CodeApiRequestError, appendFailedExecutionFileReminder, buildCodeApiEndpoint, buildCodeApiExecutionErrorMessage, getCodeBaseURL, resolveCodeApiAuthHeaders, selectRuntimeSessionHint } from "./CodeExecutor.mjs";
 import { assertUnambiguousIdentifiers, projectProgrammaticToolMap, resolveProgrammaticToolDefinitions, selectProgrammaticTools } from "./ProgrammaticCallerPolicy.mjs";
 import { clampCodeApiRunTimeoutMs, createCodeApiRunTimeoutSchema, resolveCodeApiRunTimeoutMs } from "./ptcTimeout.mjs";
 import { executeTools, formatCompletedResponse, makeRequest, runPlainExecution } from "./ProgrammaticToolCalling.mjs";
@@ -13,6 +13,9 @@ config();
 const DEFAULT_MAX_ROUND_TRIPS = 20;
 const DEFAULT_RUN_TIMEOUT_MS = resolveCodeApiRunTimeoutMs();
 const BASH_LAST_BACKGROUND_PID_GUARD = ": &\nwait \"$!\"";
+const CODE_API_WORKSPACE_HEADER = "X-LibreChat-Code-Workspace-ID";
+const ATTACHED_BASH_DATA_DIRECTORY = "\"${LIBRECHAT_CODE_DATA_DIR:-/mnt/data}\"";
+const ATTACHED_BASH_ARTIFACT_PATH_GUIDANCE = `Use ${ATTACHED_BASH_DATA_DIRECTORY} for injected files and generated artifacts. The directory is execution-scoped; the selected workspace is the persistent project root.`;
 const BASH_RESERVED = new Set([
 	"if",
 	"then",
@@ -42,6 +45,10 @@ const STATELESS_WARNING = `CRITICAL - STATELESS EXECUTION:
 Each call is a fresh bash shell. Variables and state do NOT persist between calls.
 You MUST complete your entire workflow in ONE code block.
 DO NOT split work across multiple calls expecting to reuse variables.`;
+const ATTACHED_WORKSPACE_WARNING = `ATTACHED WORKSPACE EXECUTION:
+- Commands start in the selected persistent workspace; project file changes persist between calls.
+- Each sandbox run is a fresh process, so shell variables, background processes, and temporary execution data do not persist.
+- Injected files and generated artifacts use \${LIBRECHAT_CODE_DATA_DIR:-/mnt/data}; do not copy them into the project unless the task requires it.`;
 const CORE_RULES = `Rules:
 - One call: state does not persist
 - Tools are pre-defined as bash functions—DO NOT redefine them
@@ -64,6 +71,28 @@ Example (Parallel calls):
   wait
   echo "SF: $(jq -r . /mnt/data/sf.json)"
   echo "NY: $(jq -r . /mnt/data/ny.json)"`;
+const ATTACHED_CORE_RULES = `Rules:
+- One call: process state does not persist; project files do
+- Tools are pre-defined as bash functions—DO NOT redefine them
+- Each tool function accepts a JSON string argument
+- Resolve tool calls into variables before changing project files; do not redirect a tool call directly into the project
+- Set data_dir=${ATTACHED_BASH_DATA_DIRECTORY}; save generated artifacts there, and write durable project files relative to the working directory
+- Tool stdout is normalized to one compact JSON value when possible; parse saved stdout once, then use fromjson? // . only for JSON-string fields
+- Only echo/printf output returns to the model
+- ${ATTACHED_BASH_ARTIFACT_PATH_GUIDANCE}
+- ${BASH_SHELL_GUIDANCE}
+- timeout caps one sandbox run/replay iteration, not the total multi-round-trip workflow`;
+const ATTACHED_EXAMPLES = `Example (Complete workflow in one call):
+  data=$(query_database '{"sql": "SELECT * FROM users"}')
+  echo "$data" | jq '.[] | .name'
+
+Example (Parallel calls):
+  data_dir=${ATTACHED_BASH_DATA_DIRECTORY}
+  { sf=$(web_search '{"query": "SF weather"}'); printf '%s\n' "$sf" > "$data_dir/sf.json"; } &
+  { ny=$(web_search '{"query": "NY weather"}'); printf '%s\n' "$ny" > "$data_dir/ny.json"; } &
+  wait
+  echo "SF: $(jq -r . "$data_dir/sf.json")"
+  echo "NY: $(jq -r . "$data_dir/ny.json")"`;
 const CODE_PARAM_DESCRIPTION = `Bash code that calls tools programmatically. Tools are available as bash functions.
 
 ${STATELESS_WARNING}
@@ -175,7 +204,17 @@ function createBashProgrammaticToolCallingTool(initParams = {}) {
 	const maxRunTimeoutMs = resolveCodeApiRunTimeoutMs(initParams.runTimeoutMs);
 	const proxy = initParams.proxy ?? process.env.PROXY;
 	const debug = initParams.debug ?? process.env.BASH_PTC_DEBUG === "true";
+	const workspaceId = initParams.workspaceId?.trim();
+	const hasWorkspace = workspaceId != null && workspaceId !== "";
+	if (hasWorkspace && !/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/.test(workspaceId)) throw new Error("Invalid attached workspace identifier");
+	const requestAuthHeaders = hasWorkspace ? async () => ({
+		...await resolveCodeApiAuthHeaders(initParams.authHeaders),
+		[CODE_API_WORKSPACE_HEADER]: workspaceId
+	}) : initParams.authHeaders ?? {};
 	const EXEC_ENDPOINT = buildCodeApiEndpoint(baseUrl, "exec/programmatic");
+	const description = hasWorkspace ? BashProgrammaticToolCallingDescription.replace(STATELESS_WARNING, ATTACHED_WORKSPACE_WARNING).replace(CORE_RULES, ATTACHED_CORE_RULES).replace(EXAMPLES, ATTACHED_EXAMPLES) : BashProgrammaticToolCallingDescription;
+	const schema = createBashProgrammaticToolCallingSchema(maxRunTimeoutMs);
+	if (hasWorkspace) schema.properties.code.description = CODE_PARAM_DESCRIPTION.replace(STATELESS_WARNING, ATTACHED_WORKSPACE_WARNING).replace(CORE_RULES, ATTACHED_CORE_RULES).replace(EXAMPLES, ATTACHED_EXAMPLES);
 	return tool(async (rawParams, config) => {
 		const params = rawParams;
 		const { code } = params;
@@ -206,7 +245,7 @@ function createBashProgrammaticToolCallingTool(initParams = {}) {
 			else if (session_id != null && session_id.length > 0) logCodeApiDiagnostic("BashProgrammaticToolCalling", "debug", "session carried no injected files; exec will run without input files", { files: "none" });
 			const selectedRuntimeSessionHint = selectRuntimeSessionHint(initParams.runtimeSessionHint, _runtime_session_hint);
 			const runtimeSessionHint = initParams.executionProfile !== "default" && typeof selectedRuntimeSessionHint === "string" && selectedRuntimeSessionHint !== "" ? selectedRuntimeSessionHint : void 0;
-			if (needsNoTools) return await runPlainExecution({
+			if (needsNoTools && !hasWorkspace) return await runPlainExecution({
 				baseUrl,
 				lang: "bash",
 				code,
@@ -215,7 +254,7 @@ function createBashProgrammaticToolCallingTool(initParams = {}) {
 				files,
 				runtimeSessionHint,
 				proxy,
-				authHeaders: initParams.authHeaders,
+				authHeaders: requestAuthHeaders,
 				executionProfile: initParams.executionProfile
 			});
 			let response = await makeRequest(EXEC_ENDPOINT, {
@@ -226,7 +265,7 @@ function createBashProgrammaticToolCallingTool(initParams = {}) {
 				timeout,
 				...files && files.length > 0 ? { files } : {},
 				...runtimeSessionHint != null ? { runtime_session_hint: runtimeSessionHint } : {}
-			}, proxy, initParams.authHeaders, initParams.executionProfile);
+			}, proxy, requestAuthHeaders, initParams.executionProfile, config.signal);
 			while (response.status === "tool_call_required") {
 				roundTrip++;
 				if (roundTrip > maxRoundTrips) throw new Error(`Exceeded maximum round trips (${maxRoundTrips}). This may indicate an infinite loop, excessive tool calls, or a logic error in your code.`);
@@ -235,9 +274,9 @@ function createBashProgrammaticToolCallingTool(initParams = {}) {
 				response = await makeRequest(EXEC_ENDPOINT, {
 					continuation_token: response.continuation_token,
 					tool_results: toolResults
-				}, proxy, initParams.authHeaders, initParams.executionProfile);
+				}, proxy, requestAuthHeaders, initParams.executionProfile, config.signal);
 			}
-			if (response.status === "completed") return formatCompletedResponse(response, code);
+			if (response.status === "completed") return formatCompletedResponse(response, code, hasWorkspace ? "execution" : "session");
 			if (response.status === "error") throw new Error(buildCodeApiExecutionErrorMessage(response));
 			throw new CodeApiRequestError();
 		} catch (error) {
@@ -247,12 +286,12 @@ function createBashProgrammaticToolCallingTool(initParams = {}) {
 		}
 	}, {
 		name: "run_tools_with_bash",
-		description: BashProgrammaticToolCallingDescription,
-		schema: createBashProgrammaticToolCallingSchema(maxRunTimeoutMs),
+		description,
+		schema,
 		responseFormat: "content_and_artifact"
 	});
 }
 //#endregion
-export { BashProgrammaticToolCallingDefinition, BashProgrammaticToolCallingDescription, BashProgrammaticToolCallingName, BashProgrammaticToolCallingSchema, createBashProgrammaticToolCallingSchema, createBashProgrammaticToolCallingTool, extractUsedBashToolNames, filterBashToolsByUsage, normalizeBashToolResultsForReplay, normalizeToBashIdentifier };
+export { BashProgrammaticToolCallingDefinition, BashProgrammaticToolCallingDescription, BashProgrammaticToolCallingName, BashProgrammaticToolCallingSchema, createBashProgrammaticToolCallingSchema, createBashProgrammaticToolCallingTool, extractUsedBashToolNames, filterBashToolsByUsage, normalizeBashToolResultsForReplay, normalizeToBashIdentifier, prepareBashProgrammaticCode };
 
 //# sourceMappingURL=BashProgrammaticToolCalling.mjs.map

package/dist/esm/tools/BashProgrammaticToolCalling.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"BashProgrammaticToolCalling.mjs","names":[],"sources":["../../../src/tools/BashProgrammaticToolCalling.ts"],"mappings":"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"}
+{"version":3,"file":"BashProgrammaticToolCalling.mjs","names":[],"sources":["../../../src/tools/BashProgrammaticToolCalling.ts"],"mappings":"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"}

package/dist/esm/tools/CodeExecutor.mjs

@@ -25,9 +25,9 @@ const TMP_PATH_PATTERN = /(^|[^A-Za-z0-9_])\/tmp(?:\/|\b)/;
 const MNT_DATA_PATH_PATTERN = /(^|[^A-Za-z0-9_])\/mnt\/data(?:\/|\b)/;
 const TMP_SCRATCH_OUTPUT_REMINDER = "Note: /tmp files are same-call scratch only and were not persisted; use /mnt/data for files needed later.";
 const FAILED_EXECUTION_FILE_REMINDER = "Note: any files written during this failed call were not registered for later calls; fix the error and rerun before relying on them.";
-function appendTmpScratchReminder(output, code) {
+function appendTmpScratchReminder(output, code, reminder = TMP_SCRATCH_OUTPUT_REMINDER) {
 	if (!TMP_PATH_PATTERN.test(code)) return output;
-	return `${output.trimEnd()}\n${TMP_SCRATCH_OUTPUT_REMINDER}\n`;
+	return `${output.trimEnd()}\n${reminder}\n`;
 }
 function appendFailedExecutionFileReminder(output, code) {
 	if (output.includes("Code execution is not supported by the selected environment.") || !MNT_DATA_PATH_PATTERN.test(code) || output.includes("Note: any files written during this failed call were not registered for later calls; fix the error and rerun before relying on them.")) return output;
@@ -310,6 +310,7 @@ function createCodeExecutionTool(params = {}) {
 			const artifactDelivery = normalizeArtifactDeliveryFailure(result.artifact_delivery);
 			const outputWithDeliveryWarning = appendArtifactDeliveryWarning(outputWithReminder, artifactDelivery);
 			const hasFiles = result.files != null && result.files.length > 0;
+			const deletionEcho = result.deleted_files != null ? { deleted_files: result.deleted_files } : {};
 			const runtimeEcho = result.runtime_session_id != null ? {
 				runtime_session_id: result.runtime_session_id,
 				runtime_status: result.runtime_status
@@ -318,10 +319,12 @@ function createCodeExecutionTool(params = {}) {
 				session_id: result.session_id,
 				files: result.files,
 				...artifactDelivery != null ? { artifact_delivery: artifactDelivery } : {},
+				...deletionEcho,
 				...runtimeEcho
 			} : {
 				session_id: result.session_id,
 				...artifactDelivery != null ? { artifact_delivery: artifactDelivery } : {},
+				...deletionEcho,
 				...runtimeEcho
 			}];
 		} catch (error) {

package/dist/esm/tools/CodeExecutor.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"CodeExecutor.mjs","names":[],"sources":["../../../src/tools/CodeExecutor.ts"],"mappings":";;;;;;;;;;;;AAyBA,OAAO;AAEP,MAAa,uBACX,uBAAA,wBAA0C,KAAA;AAG5C,SAAgB,qBAAqB,SAAiB,OAAuB;CAC3E,OAAO,GAAG,QAAQ,QAAQ,QAAQ,EAAE,EAAE,GAAG,MAAM,QAAQ,QAAQ,EAAE;AACnE;AAEA,SAAgB,yBACd,aACA,cACoB;CACpB,OAAO,eAAe,QAAQ,gBAAgB,KAAK,cAAc;AACnE;AAEA,MAAa,qBACX;AAEF,MAAa,8BACX;AAEF,MAAa,sBACX;AAEF,MAAM,mBAAmB;AACzB,MAAM,wBAAwB;AAE9B,MAAa,8BACX;AAEF,MAAa,iCACX;AAEF,SAAgB,yBAAyB,QAAgB,MAAsB;CAC7E,IAAI,CAAC,iBAAiB,KAAK,IAAI,GAC7B,OAAO;CAET,OAAO,GAAG,OAAO,QAAQ,EAAE,IAAI,4BAA4B;AAC7D;AAEA,SAAgB,kCACd,QACA,MACQ;CACR,IACE,OAAO,SAAA,8DAA0C,KACjD,CAAC,sBAAsB,KAAK,IAAI,KAChC,OAAO,SAAA,sIAAuC,GAE9C,OAAO;CAET,OAAO,GAAG,OAAO,QAAQ,EAAE,IAAI,+BAA+B;AAChE;AAEA,MAAM,sBAAsB;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAa,0BAA0B;CACrC,MAAM;CACN,YAAY;EACV,QAAQ,EAAE,GAAG,gBAAgB;EAC7B,MAAM;GACJ,MAAM;GACN,MAAM;GACN,aACE;EACJ;EACA,MAAM;GACJ,MAAM;GACN,aAAa;;;IAGf,4BAA4B;;;;;;;;;EAS5B;EACA,MAAM;GACJ,MAAM;GACN,OAAO,EAAE,MAAM,SAAS;GACxB,aACE;EACJ;CACF;CACA,UAAU,CAAC,QAAQ,MAAM;AAC3B;AAEA,MAAa,mCAAmC;AAIhD,MAAM,0BAA0B;AAEhC,MAAa,qCACX;AACF,MAAa,uCACX;AACF,MAAa,0CAA0C;AACvD,MAAa,yCACX;AACF,MAAa,sCACX;AAEF,MAAM,wCAEF;CACF,iCAAiC;CACjC,iBAAiB;CACjB,uBAAuB;CACvB,0FACE;CACF,0BAA0B;CAC1B,0BAA0B;AAC5B;AAEA,MAAa,oCACX;AACF,MAAM,qCACJ;AAEF,MAAM,kCAEF;CACF,wBACE;CACF,4BACE;CACF,qBACE;CACF,wBACE;CACF,gCACE;AACJ;AAEA,SAAS,iCACP,cACoB;CACpB,IAAI;EACF,MAAM,SAAS,KAAK,MAAM,YAAY;EAKtC,MAAM,OAAO,QAAQ,QAAQ,QAAQ;EACrC,IAAI,OAAO,SAAS,UAAU,OAAO,KAAA;EACrC,MAAM,iBAAiB,KAAK,YAAY;EACxC,IAAI,CAAC,OAAO,OAAO,iCAAiC,cAAc,GAChE,OAAO,KAAA;EACT,IAAI,aAAa,gCAAgC;EACjD,IAAI,cAAc,MAAM,OAAO,KAAA;EAC/B,IACE,mBAAmB,4BACnB,OAAO,QAAQ,YAAY,YAC3B,yEAAyE,KACvE,OAAO,OACT,GAEA,aACE,gCAAgC;EAEpC,OAAO,GAAG,kCAAkC,GAAG,WAAW,GAAG;CAC/D,QAAQ;EACN;CACF;AACF;AAEA,IAAa,sBAAb,cAAyC,MAAM;CAC7C;CAEA,YAAY,UAAU,oCAAoC;EACxD,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,YACH,QAAQ,SAAA,0DAA2C,KACnD,QAAQ,SAAS,6CAA6C;CAClE;AACF;AAEA,SAAS,qBAAqB,cAA0C;CACtE,IAAI;EACF,MAAM,SAAS,KAAK,MAAM,YAAY;EAItC,IACE,OAAO,UAAU,kBACjB,OAAO,OAAO,wBAAwB,YACtC,CAAC,OAAO,SAAS,OAAO,mBAAmB,KAC3C,OAAO,uBAAuB,GAE9B;EAEF,OAAO,KAAK,IACV,KAAK,KAAK,OAAO,mBAAmB,GACpC,uBACF;CACF,QAAQ;EACN;CACF;AACF;AAEA,SAAgB,6BACd,OACqB;CACrB,OAAO,iBAAiB,sBACpB,QACA,IAAI,oBAAoB;AAC9B;AAEA,SAAS,mCACP,OACoB;CACpB,IAAI,OAAO,UAAU,UACnB;CAEF,MAAM,aAAa,sCAAsC;CACzD,IAAI,cAAc,MAChB,OAAO;CAET,IAAI,mDAAmD,KAAK,KAAK,GAC/D,OAAO,MAAM,QAAQ,YAAY,WAAW;CAE9C,IAAI,+CAA+C,KAAK,KAAK,GAC3D,OAAO;AAGX;AAEA,SAAgB,kCAAkC,UAGvC;CACT,MAAM,aAAa,mCAAmC,SAAS,KAAK;CACpE,MAAM,UACJ,cAAc,OACV,GAAG,wCAAwC,GAAG,eAC9C;CACN,IAAI,OAAO,SAAS,WAAW,YAAY,SAAS,WAAW,IAC7D,OAAO,GAAG,QAAQ,eAAe,SAAS;CAE5C,OAAO;AACT;AAEA,eAAsB,0BACpB,aACA,SACiC;CACjC,IAAI,eAAe,MACjB,OAAO,CAAC;CAEV,IAAI,OAAO,gBAAgB,YACzB,IAAI;EAEF,OAAO,MADuB,YAAY;CAE5C,SAAS,OAAO;EACd,IAAI,SAAS,gBAAgB,MAC3B,qBACE,gBACA,SACA,sEACA,qBAAqB,KAAK,CAC5B;EAEF,MAAM,IAAI,oBAAoB,oCAAoC;CACpE;CAEF,OAAO;AACT;AAEA,SAAgB,iCACd,SACA,kBACwB;CACxB,IAAI,oBAAoB,MACtB,OAAO;CAET,OAAO;EACL,GAAG;GACF,mCAAmC;CACtC;AACF;AAYA,SAAS,oBAAoB,UAAsC;CACjE,MAAM,OAAO,SAAS;CACtB,IAAI,QAAQ,QAAQ,EAAE,aAAa,OACjC;CAEF,MAAM,UAAW,KAAmD;CACpE,IAAI,OAAO,YAAY,YACrB;CAEF,IAAI;EACF,QAAQ,KAAK,IAAI;CACnB,QAAQ,CAER;AACF;AAEA,MAAM,gCAAgC,KAAK;AAC3C,MAAM,iCAAiC;AAGvC,eAAe,qBACb,UACiB;CACjB,IAAI;CACJ,IAAI;EACF,MAAM,OAAO,YAA6B;GACxC,IAAI,SAAS,QAAQ,QAAQ,OAAO,iBAAiB,SAAS,MAAM;IAClE,IAAI,QAAQ;IACZ,MAAM,SAAmB,CAAC;IAC1B,WAAW,MAAM,SAAS,SAAS,MAEhC;KACD,MAAM,SAAS,OAAO,SAAS,KAAK,IAAI,QAAQ,OAAO,KAAK,KAAK;KACjE,SAAS,OAAO;KAChB,IAAI,QAAQ,+BAA+B,OAAO;KAClD,OAAO,KAAK,MAAM;IACpB;IACA,OAAO,OAAO,OAAO,MAAM,CAAC,CAAC,SAAS,MAAM;GAC9C;GACA,MAAM,OAAO,MAAM,SAAS,KAAK;GACjC,OAAO,OAAO,WAAW,IAAI,KAAK,gCAC9B,OACA;EACN;EACA,OAAO,MAAM,QAAQ,KAAK,CACxB,KAAK,GACL,IAAI,SAAiB,YAAY;GAC/B,QAAQ,iBAAiB,QAAQ,EAAE,GAAG,8BAA8B;EACtE,CAAC,CACH,CAAC;CACH,QAAQ;EACN,OAAO;CACT,UAAU;EACR,aAAa,KAAK;EAClB,oBAAoB,QAAQ;CAC9B;AACF;AAEA,eAAsB,6BACpB,QACA,WACA,UACA,SACiB;CAUjB,IAAI,SAAS,gBAAgB,MAC3B,qBACE,gBACA,SAAS,WAAW,MAAM,SAAS,SACnC,iCACA;EACE;EACA,SAAS,SAAS,WAAW;EAC7B,QAAQ,SAAS;CACnB,CACF;CAEF,MAAM,eAAe,MAAM,qBAAqB,QAAQ;CACxD,MAAM,kBAAkB,iCAAiC,YAAY;CACrE,IAAI,mBAAmB,MACrB,OAAO;CAET,IAAI,SAAS,WAAW,KAAK;EAC3B,MAAM,oBAAoB,qBAAqB,YAAY;EAC3D,OAAO,qBAAqB,OACxB,2DAA2D,kBAAkB,aAC7E;CACN;CACA,IAAI,SAAS,WAAW,OAAO,SAAS,WAAW,KACjD,OAAO;CAET,IAAI,SAAS,WAAW,OAAO,SAAS,WAAW,KACjD,OAAO;CAET,OAAO;AACT;AAEA,MAAa,+BAA+B;;;;;;IAMxC,4BAA4B;;EAE9B,KAAK;AAUP,MAAa,oBACX;AAEF,MAAa,uCAAuC;;;EAGlD,kBAAkB;;;;;IAKhB,4BAA4B;;EAE9B,KAAK;AAEP,SAAgB,kCAAkC,MAEvC;CACT,OAAO,MAAM,qBAAqB,OAC9B,uCACA;AACN;AAEA,MAAM,4BACJ;AACF,MAAM,2BACJ;AAEF,SAAgB,6BAA6B,MAEV;CACjC,MAAM,OACJ,MAAM,qBAAqB,OACvB,2BACA;CACN,MAAM,kBACJ,wBAAwB,WAAW,KAAK,YAAY,QAClD,2BACA,IACF;CACF,OAAO;EACL,GAAG;EACH,YAAY;GACV,GAAG,wBAAwB;GAC3B,MAAM;IACJ,GAAG,wBAAwB,WAAW;IACtC,aAAa;GACf;EACF;CACF;AACF;AAEA,MAAa,wBAAA;AAEb,MAAa,8BAA8B;CACzC,MAAM;CACN,aAAa;CACb,QAAQ;AACV;AAEA,SAAS,wBACP,SAA2C,CAAC,GACrB;CACvB,MAAM,eAAe,qBACnB,QAAQ,WAAW,eAAe,GAClC,MACF;CAEA,OAAO,KACL,OAAO,UAAU,WAAW;EAG1B,MAAM,EACJ,aACA,SAAS,UACT,kBACA,oBACA,kBACA,GAAG,oBACD,UAAU,CAAC;EAQf,MAAM,EACJ,MACA,MACA,QAAQ,gBACR,sBAAsB,mBACtB,GAAG,SACD;EAcJ,MAAM,EAAE,YAAY,iBAAiB,0BAClC,OAAO,YAAY,CAAC;EAMvB,MAAM,WAAoC;GACxC;GACA;GACA,GAAG;GACH,GAAG;EACL;EAKA,MAAM,8BAA8B,yBAClC,oBACA,qBACF;EACA,IACE,qBAAqB,QACrB,qBAAqB,aACrB,OAAO,gCAAgC,YACvC,gCAAgC,IAEhC,SAAS,uBAAuB;EAUlC,IAAI,mBAAmB,gBAAgB,SAAS,GAC9C,SAAS,QAAQ;OACZ,IACL,cAAc,QACd,WAAW,SAAS,KACpB,CAAC,MAAM,QAAQ,SAAS,KAAK,GAE7B,qBACE,gBACA,SACA,wEACA,EAAE,OAAO,OAAO,CAClB;EAGF,IAAI;GAGF,MAAM,eAA4B;IAChC,QAAQ;IACR,SAAS;KACP,gBAAgB;KAChB,cAAc;KACd,GAAG,iCACD,MAPE,0BAA0B,WAAW,GAQvC,gBACF;IACF;IACA,MAAM,KAAK,UAAU,QAAQ;GAC/B;GAEA,MAAM,aAAa,uBAAuB,YAAY;GACtD,IAAI,cAAc,MAChB,aAAa,QAAQ;GAEvB,MAAM,WAAW,MAAM,MAAM,cAAc,YAAY;GACvD,IAAI,CAAC,SAAS,IACZ,MAAM,IAAI,oBACR,MAAM,6BAA6B,QAAQ,cAAc,UAAU,EACjE,SAAS,iBACX,CAAC,CACH;GAGF,MAAM,SAA0B,MAAM,SAAS,KAAK;GACpD,IAAI,kBAAkB;GACtB,IAAI,OAAO,QACT,mBAAmB,YAAY,OAAO,OAAO;QAE7C,mBAAmB;GAErB,IAAI,OAAO,QAAQ,mBAAmB,YAAY,OAAO,OAAO;GAEhE,MAAM,qBAAqB,yBACzB,iBACA,IACF;GACA,MAAM,mBAAmB,iCACvB,OAAO,iBACT;GACA,MAAM,4BAA4B,8BAChC,oBACA,gBACF;GACA,MAAM,WAAW,OAAO,SAAS,QAAQ,OAAO,MAAM,SAAS;GAI/D,MAAM,cACJ,OAAO,sBAAsB,OACzB;IACA,oBAAoB,OAAO;IAC3B,gBAAgB,OAAO;GACzB,IACE,CAAC;GACP,OAAO,CACL,6BAA6B,2BAA2B,OAAO,KAAK,GACnE,WACG;IACA,YAAY,OAAO;IACnB,OAAO,OAAO;IACd,GAAI,oBAAoB,OACpB,EAAE,mBAAmB,iBAAiB,IACtC,CAAC;IACL,GAAG;GACL,IACE;IACA,YAAY,OAAO;IACnB,GAAI,oBAAoB,OACpB,EAAE,mBAAmB,iBAAiB,IACtC,CAAC;IACL,GAAG;GACL,CACJ;EACF,SAAS,OAAO;GAKd,MAAM,IAAI,oBACR,uBAL0B,kCAC1B,6BAA6B,KAAK,CAAC,CAAC,SACpC,IAGyC,GAC3C;EACF;CACF,GACA;EACE,MAAM;EACN,aAAa,kCAAkC,UAAU,KAAA,CAAS;EAClE,QAAQ,6BAA6B,UAAU,KAAA,CAAS;EACxD,gBAAA;CACF,CACF;AACF"}
+{"version":3,"file":"CodeExecutor.mjs","names":[],"sources":["../../../src/tools/CodeExecutor.ts"],"mappings":"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"}

package/dist/esm/tools/CodeSessionFileSummary.mjs

@@ -12,6 +12,7 @@ const IMAGE_FILE_EXTENSIONS = new Set([
 	".webp"
 ]);
 const CODE_SESSION_FILE_SUMMARY_PATTERN = /^Generated files:\nSession files: \d+ persisted file\(s\) are available in \/mnt\/data, including \d+ image\(s\)\. Use known \/mnt\/data paths directly in later code-tool calls\. The app displays files\/images automatically; do not invent download links or wrap generated images in Markdown\.$/;
+const EXECUTION_ARTIFACT_FILE_SUMMARY_PATTERN = /^Generated files:\nExecution artifacts: \d+ file\(s\), including \d+ image\(s\), were delivered to the app\. They are not retained in the attached project; write durable files to the project root when later commands must reuse them\. The app displays files\/images automatically; do not invent download links or wrap generated images in Markdown\.$/;
 function getFileExtension(name) {
 	const lastSlash = name.lastIndexOf("/");
 	const basename = lastSlash >= 0 ? name.slice(lastSlash + 1) : name;
@@ -35,7 +36,7 @@ function stripCodeSessionFileSummary(output) {
 	const beforeSummary = output.slice(0, summaryStart);
 	if (beforeSummary !== "" && !beforeSummary.endsWith("\n\n")) return output;
 	const maybeSummary = output.slice(summaryStart);
-	if (!CODE_SESSION_FILE_SUMMARY_PATTERN.test(maybeSummary)) return output;
+	if (!CODE_SESSION_FILE_SUMMARY_PATTERN.test(maybeSummary) && !EXECUTION_ARTIFACT_FILE_SUMMARY_PATTERN.test(maybeSummary)) return output;
 	return beforeSummary.trimEnd();
 }
 function appendCodeSessionFileSummary(output, files) {
@@ -46,7 +47,15 @@ function appendCodeSessionFileSummary(output, files) {
 	const summary = buildCodeSessionFileSummary(generatedFiles.length, imageCount);
 	return `${output.trimEnd()}\n\n${summary}`.trim();
 }
+function appendExecutionArtifactFileSummary(output, files) {
+	const generatedFiles = files?.filter(isGeneratedFile) ?? [];
+	if (generatedFiles.length === 0) return output.trim();
+	const imageCount = generatedFiles.filter(isImageFile).length;
+	const summary = `Generated files:
+Execution artifacts: ${generatedFiles.length} file(s), including ${imageCount} image(s), were delivered to the app. They are not retained in the attached project; write durable files to the project root when later commands must reuse them. The app displays files/images automatically; do not invent download links or wrap generated images in Markdown.`;
+	return `${output.trimEnd()}\n\n${summary}`.trim();
+}
 //#endregion
-export { appendCodeSessionFileSummary, stripCodeSessionFileSummary };
+export { appendCodeSessionFileSummary, appendExecutionArtifactFileSummary, stripCodeSessionFileSummary };
 
 //# sourceMappingURL=CodeSessionFileSummary.mjs.map

package/dist/esm/tools/CodeSessionFileSummary.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"CodeSessionFileSummary.mjs","names":[],"sources":["../../../src/tools/CodeSessionFileSummary.ts"],"mappings":";AAEA,MAAM,wBAAwB,IAAI,IAAI;CACpC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAM,oCACJ;AAEF,SAAS,iBAAiB,MAAsB;CAC9C,MAAM,YAAY,KAAK,YAAY,GAAG;CACtC,MAAM,WAAW,aAAa,IAAI,KAAK,MAAM,YAAY,CAAC,IAAI;CAC9D,MAAM,UAAU,SAAS,YAAY,GAAG;CACxC,OAAO,WAAW,IAAI,SAAS,MAAM,OAAO,CAAC,CAAC,YAAY,IAAI;AAChE;AAEA,SAAS,YAAY,MAAsD;CACzE,MAAM,OAAO,MAAM;CACnB,OACE,OAAO,SAAS,YAChB,sBAAsB,IAAI,iBAAiB,IAAI,CAAC;AAEpD;AAEA,SAAS,4BACP,WACA,YACQ;CACR,OACE;iBACkB,UAAU,2DAA2D,WAAW;AAItG;AAEA,SAAS,gBAAgB,MAAsD;CAC7E,OAAO,MAAM,cAAc;AAC7B;AAEA,SAAgB,4BAA4B,QAAwB;CAClE,MAAM,eAAe,OAAO,YAAY,kBAAkB;CAC1D,IAAI,eAAe,GAAG,OAAO;CAC7B,MAAM,gBAAgB,OAAO,MAAM,GAAG,YAAY;CAClD,IAAI,kBAAkB,MAAM,CAAC,cAAc,SAAS,MAAM,GAAG,OAAO;CACpE,MAAM,eAAe,OAAO,MAAM,YAAY;CAC9C,IAAI,CAAC,kCAAkC,KAAK,YAAY,GAAG,OAAO;CAClE,OAAO,cAAc,QAAQ;AAC/B;AAEA,SAAgB,6BACd,QACA,OACQ;CACR,IAAI,SAAS,QAAQ,MAAM,WAAW,GACpC,OAAO,OAAO,KAAK;CAGrB,MAAM,iBAAiB,MAAM,OAAO,eAAe;CACnD,IAAI,eAAe,WAAW,GAC5B,OAAO,OAAO,KAAK;CAGrB,MAAM,aAAa,eAAe,OAAO,WAAW,CAAC,CAAC;CACtD,MAAM,UAAU,4BACd,eAAe,QACf,UACF;CAEA,OAAO,GAAG,OAAO,QAAQ,EAAE,MAAM,UAAU,KAAK;AAClD"}
+{"version":3,"file":"CodeSessionFileSummary.mjs","names":[],"sources":["../../../src/tools/CodeSessionFileSummary.ts"],"mappings":";AAEA,MAAM,wBAAwB,IAAI,IAAI;CACpC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAM,oCACJ;AACF,MAAM,0CACJ;AAEF,SAAS,iBAAiB,MAAsB;CAC9C,MAAM,YAAY,KAAK,YAAY,GAAG;CACtC,MAAM,WAAW,aAAa,IAAI,KAAK,MAAM,YAAY,CAAC,IAAI;CAC9D,MAAM,UAAU,SAAS,YAAY,GAAG;CACxC,OAAO,WAAW,IAAI,SAAS,MAAM,OAAO,CAAC,CAAC,YAAY,IAAI;AAChE;AAEA,SAAS,YAAY,MAAsD;CACzE,MAAM,OAAO,MAAM;CACnB,OACE,OAAO,SAAS,YAChB,sBAAsB,IAAI,iBAAiB,IAAI,CAAC;AAEpD;AAEA,SAAS,4BACP,WACA,YACQ;CACR,OACE;iBACkB,UAAU,2DAA2D,WAAW;AAItG;AAEA,SAAS,gBAAgB,MAAsD;CAC7E,OAAO,MAAM,cAAc;AAC7B;AAEA,SAAgB,4BAA4B,QAAwB;CAClE,MAAM,eAAe,OAAO,YAAY,kBAAkB;CAC1D,IAAI,eAAe,GAAG,OAAO;CAC7B,MAAM,gBAAgB,OAAO,MAAM,GAAG,YAAY;CAClD,IAAI,kBAAkB,MAAM,CAAC,cAAc,SAAS,MAAM,GAAG,OAAO;CACpE,MAAM,eAAe,OAAO,MAAM,YAAY;CAC9C,IACE,CAAC,kCAAkC,KAAK,YAAY,KACpD,CAAC,wCAAwC,KAAK,YAAY,GAE1D,OAAO;CAET,OAAO,cAAc,QAAQ;AAC/B;AAEA,SAAgB,6BACd,QACA,OACQ;CACR,IAAI,SAAS,QAAQ,MAAM,WAAW,GACpC,OAAO,OAAO,KAAK;CAGrB,MAAM,iBAAiB,MAAM,OAAO,eAAe;CACnD,IAAI,eAAe,WAAW,GAC5B,OAAO,OAAO,KAAK;CAGrB,MAAM,aAAa,eAAe,OAAO,WAAW,CAAC,CAAC;CACtD,MAAM,UAAU,4BACd,eAAe,QACf,UACF;CAEA,OAAO,GAAG,OAAO,QAAQ,EAAE,MAAM,UAAU,KAAK;AAClD;AAIA,SAAgB,mCACd,QACA,OACQ;CACR,MAAM,iBAAiB,OAAO,OAAO,eAAe,KAAK,CAAC;CAC1D,IAAI,eAAe,WAAW,GAAG,OAAO,OAAO,KAAK;CACpD,MAAM,aAAa,eAAe,OAAO,WAAW,CAAC,CAAC;CACtD,MAAM,UACJ;uBACwB,eAAe,OAAO,sBAAsB,WAAW;CAGjF,OAAO,GAAG,OAAO,QAAQ,EAAE,MAAM,UAAU,KAAK;AAClD"}

package/dist/esm/tools/ProgrammaticToolCalling.mjs

@@ -4,10 +4,11 @@ import { resolveFetchProxyAgent } from "../utils/proxy.mjs";
 import { INTENT_PROPERTY } from "./intentArg.mjs";
 import { appendArtifactDeliveryWarning, normalizeArtifactDeliveryFailure } from "./ArtifactDelivery.mjs";
 import { describeCodeApiError, logCodeApiDiagnostic } from "./diagnostics.mjs";
-import { appendCodeSessionFileSummary } from "./CodeSessionFileSummary.mjs";
+import { appendCodeSessionFileSummary, appendExecutionArtifactFileSummary } from "./CodeSessionFileSummary.mjs";
 import { CODE_ARTIFACT_PATH_GUIDANCE, CodeApiRequestError, addCodeApiExecutionProfileHeader, appendFailedExecutionFileReminder, appendTmpScratchReminder, buildCodeApiEndpoint, buildCodeApiExecutionErrorMessage, buildCodeApiHttpErrorMessage, emptyOutputMessage, getCodeBaseURL, normalizeCodeApiRequestError, resolveCodeApiAuthHeaders, selectRuntimeSessionHint } from "./CodeExecutor.mjs";
 import { assertUnambiguousIdentifiers, projectProgrammaticToolMap, resolveProgrammaticToolDefinitions, selectProgrammaticTools } from "./ProgrammaticCallerPolicy.mjs";
 import { clampCodeApiRunTimeoutMs, createCodeApiRunTimeoutSchema, resolveCodeApiRunTimeoutMs } from "./ptcTimeout.mjs";
+import { randomUUID } from "node:crypto";
 import { tool } from "@langchain/core/tools";
 import { config } from "dotenv";
 import fetch from "node-fetch";
@@ -15,6 +16,8 @@ import fetch from "node-fetch";
 config();
 const DEFAULT_MAX_ROUND_TRIPS = 20;
 const DEFAULT_RUN_TIMEOUT_MS = resolveCodeApiRunTimeoutMs();
+const CODE_API_PROGRAMMATIC_REQUEST_HEADER = "X-LibreChat-Code-Request-ID";
+const CANCELLATION_REQUEST_TIMEOUT_MS = 2e3;
 const STATELESS_WARNING = `CRITICAL - STATELESS EXECUTION:
 Each call is a fresh Python interpreter. Variables, imports, and data do NOT persist between calls.
 You MUST complete your entire workflow in ONE code block: query → process → output.
@@ -247,20 +250,61 @@ async function fetchSessionFiles(baseUrl, sessionId, scopeOrProxy, proxyOrAuthHe
 		return [];
 	}
 }
-async function makeRequest(endpoint, body, proxy, authHeaders, executionProfile) {
+async function makeRequest(endpoint, body, proxy, authHeaders, executionProfile, signal) {
 	try {
+		const resolvedAuthHeaders = await resolveCodeApiAuthHeaders(authHeaders);
+		const requestId = signal != null ? randomUUID() : void 0;
 		const fetchOptions = {
 			method: "POST",
 			headers: {
 				"Content-Type": "application/json",
 				"User-Agent": "LibreChat/1.0",
-				...addCodeApiExecutionProfileHeader(await resolveCodeApiAuthHeaders(authHeaders), executionProfile)
+				...addCodeApiExecutionProfileHeader(resolvedAuthHeaders, executionProfile),
+				...requestId != null ? { [CODE_API_PROGRAMMATIC_REQUEST_HEADER]: requestId } : {}
 			},
-			body: JSON.stringify(body)
+			body: JSON.stringify(body),
+			signal
 		};
 		const proxyAgent = resolveFetchProxyAgent(endpoint, proxy);
 		if (proxyAgent != null) fetchOptions.agent = proxyAgent;
-		const response = await fetch(endpoint, fetchOptions);
+		let cancellationRequest;
+		const requestCancellation = () => {
+			if (requestId == null || cancellationRequest != null) return;
+			cancellationRequest = (async () => {
+				const cancellationController = new AbortController();
+				const timeout = setTimeout(() => cancellationController.abort(), CANCELLATION_REQUEST_TIMEOUT_MS);
+				try {
+					const cancelOptions = {
+						method: "POST",
+						headers: {
+							"Content-Type": "application/json",
+							"User-Agent": "LibreChat/1.0",
+							...addCodeApiExecutionProfileHeader(resolvedAuthHeaders, executionProfile)
+						},
+						body: JSON.stringify({ request_id: requestId }),
+						signal: cancellationController.signal
+					};
+					if (proxyAgent != null) cancelOptions.agent = proxyAgent;
+					await fetch(`${endpoint}/cancel`, cancelOptions);
+				} catch {} finally {
+					clearTimeout(timeout);
+				}
+			})();
+		};
+		signal?.addEventListener("abort", requestCancellation, { once: true });
+		if (signal?.aborted === true) requestCancellation();
+		let response;
+		try {
+			response = await fetch(endpoint, fetchOptions);
+		} catch (error) {
+			if (signal?.aborted === true) {
+				requestCancellation();
+				await cancellationRequest;
+			}
+			throw error;
+		} finally {
+			signal?.removeEventListener("abort", requestCancellation);
+		}
 		if (!response.ok) throw new CodeApiRequestError(await buildCodeApiHttpErrorMessage("POST", endpoint, response, { profile: executionProfile }));
 		return await response.json();
 	} catch (error) {
@@ -403,16 +447,18 @@ async function executeTools(toolCalls, toolMap, programmaticToolName = "run_tool
 	});
 	return await Promise.all(executions);
 }
-function formatCompletedResponse(response, sourceCode = "") {
+function formatCompletedResponse(response, sourceCode = "", filePersistence = "session") {
 	let formatted = "";
 	if (response.stdout != null && response.stdout !== "") formatted += `stdout:\n${response.stdout}\n`;
 	else formatted += emptyOutputMessage;
 	if (response.stderr != null && response.stderr !== "") formatted += `stderr:\n${response.stderr}\n`;
 	const outputWithReminder = appendTmpScratchReminder(formatted, sourceCode);
 	const artifactDelivery = normalizeArtifactDeliveryFailure(response.artifact_delivery);
-	return [appendCodeSessionFileSummary(appendArtifactDeliveryWarning(outputWithReminder, artifactDelivery), response.files), {
+	const outputWithDeliveryWarning = appendArtifactDeliveryWarning(outputWithReminder, artifactDelivery);
+	return [filePersistence === "execution" ? appendExecutionArtifactFileSummary(outputWithDeliveryWarning, response.files) : appendCodeSessionFileSummary(outputWithDeliveryWarning, response.files), {
 		session_id: response.session_id,
 		files: response.files,
+		...response.deleted_files != null ? { deleted_files: response.deleted_files } : {},
 		...artifactDelivery != null ? { artifact_delivery: artifactDelivery } : {},
 		...response.runtime_session_id != null ? {
 			runtime_session_id: response.runtime_session_id,
@@ -494,7 +540,7 @@ function createProgrammaticToolCallingTool(initParams = {}) {
 				timeout,
 				...files && files.length > 0 ? { files } : {},
 				...runtimeSessionHint != null ? { runtime_session_hint: runtimeSessionHint } : {}
-			}, proxy, initParams.authHeaders, initParams.executionProfile);
+			}, proxy, initParams.authHeaders, initParams.executionProfile, config.signal);
 			while (response.status === "tool_call_required") {
 				roundTrip++;
 				if (roundTrip > maxRoundTrips) throw new Error(`Exceeded maximum round trips (${maxRoundTrips}). This may indicate an infinite loop, excessive tool calls, or a logic error in your code.`);
@@ -503,7 +549,7 @@ function createProgrammaticToolCallingTool(initParams = {}) {
 				response = await makeRequest(EXEC_ENDPOINT, {
 					continuation_token: response.continuation_token,
 					tool_results: toolResults
-				}, proxy, initParams.authHeaders, initParams.executionProfile);
+				}, proxy, initParams.authHeaders, initParams.executionProfile, config.signal);
 			}
 			if (response.status === "completed") return formatCompletedResponse(response, code);
 			if (response.status === "error") throw new Error(buildCodeApiExecutionErrorMessage(response));