@librechat/agents 4.0.1 → 4.0.3

package/dist/esm/llm/providerTextBoundary.mjs

@@ -0,0 +1,355 @@
+import "../common/enum.mjs";
+import "../common/index.mjs";
+import { getChatModelClass } from "./providers.mjs";
+import { getStreamedToolCallAdapter, getStreamedToolCallSeal } from "../tools/streamedToolCallSeals.mjs";
+import { ProviderTextAttempt, ProviderTextProtectionError } from "../protection/providerText.mjs";
+import { GEMINI_SIGNATURES, ResponsesTextProjection, keys, replayPositions, safetyRatings, stringMap } from "./providerTextControls.mjs";
+import { isProviderTextInput } from "../protection/providerTextInput.mjs";
+import { createProviderTextChunk } from "./providerTextChunk.mjs";
+import { RunnableBinding, RunnableSequence } from "@langchain/core/runnables";
+import { AIMessage, AIMessageChunk, mergeContent } from "@langchain/core/messages";
+import { ChatGenerationChunk } from "@langchain/core/outputs";
+import { BaseChatModel } from "@langchain/core/language_models/chat_models";
+//#region src/llm/providerTextBoundary.ts
+const additionalKeys = new Set([
+	"tool_calls",
+	"function_call",
+	"reasoning",
+	"reasoning_content",
+	"reasoning_details",
+	"thinking",
+	"signature"
+]);
+const metadataKeys = new Set([
+	"finish_reason",
+	"stop_reason",
+	"stop_sequence",
+	"model_name",
+	"model",
+	"model_provider",
+	"system_fingerprint",
+	"service_tier",
+	"usage",
+	"tokenUsage",
+	"input_tokens",
+	"output_tokens",
+	"total_tokens",
+	"index",
+	"prompt",
+	"completion",
+	"output_version"
+]);
+const additionalControls = {
+	id: (value) => typeof value === "string",
+	type: (value) => value === "message",
+	role: (value) => value === "assistant",
+	model: (value) => typeof value === "string",
+	stop_reason: (value) => value == null || typeof value === "string",
+	stop_sequence: (value) => value == null || typeof value === "string",
+	usage: (value) => numericMetadata(value)
+};
+const geminiControls = {
+	[GEMINI_SIGNATURES]: stringMap,
+	finishReason: (value) => [
+		"STOP",
+		"MAX_TOKENS",
+		"SAFETY",
+		"RECITATION",
+		"OTHER",
+		"MALFORMED_FUNCTION_CALL",
+		"FINISH_REASON_UNSPECIFIED"
+	].includes(String(value)),
+	safetyRatings,
+	avgLogprobs: (value) => typeof value === "number" && Number.isFinite(value),
+	index: (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0
+};
+const controlBlocks = new Set([
+	"thinking",
+	"redacted_thinking",
+	"reasoning",
+	"reasoning_content",
+	"tool_use"
+]);
+function copyMessage(message, content) {
+	const copied = createProviderTextChunk(message, {
+		content,
+		id: message.id,
+		name: message.name,
+		additional_kwargs: message.additional_kwargs,
+		response_metadata: message.response_metadata,
+		tool_calls: message.tool_calls,
+		tool_call_chunks: message instanceof AIMessageChunk ? message.tool_call_chunks : void 0,
+		invalid_tool_calls: message.invalid_tool_calls,
+		usage_metadata: message.usage_metadata
+	});
+	copied.invalid_tool_calls = message.invalid_tool_calls ?? [];
+	copied.lc_kwargs.invalid_tool_calls = copied.invalid_tool_calls;
+	return copied;
+}
+function numericMetadata(value, depth = 4) {
+	if (value == null) return true;
+	if (typeof value === "number") return Number.isFinite(value);
+	if (typeof value !== "object" || Array.isArray(value) || depth === 0) return false;
+	const values = Object.values(value);
+	return values.length <= 64 && values.every((entry) => numericMetadata(entry, depth - 1));
+}
+function hasKeys(value, keys) {
+	return value != null && typeof value === "object" && !Array.isArray(value) && Object.keys(value).every((key) => keys.includes(key));
+}
+function validateMetadata(metadata, google = false) {
+	for (const key of Object.keys(metadata)) {
+		const value = metadata[key];
+		let valid;
+		if (google && geminiControls[key] != null) valid = geminiControls[key](value);
+		else if (additionalControls[key] != null) valid = additionalControls[key](value);
+		else if (key === "contentBlockIndex") valid = typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+		else if (key === "lc_streamed_tool_call_adapter") valid = getStreamedToolCallAdapter(metadata) != null;
+		else if (key === "lc_streamed_tool_call_seal") valid = hasKeys(value, [
+			"kind",
+			"id",
+			"index"
+		]) && getStreamedToolCallSeal(metadata) != null;
+		else if (key === "messageStart") valid = hasKeys(value, ["role"]) && value.role === "assistant";
+		else if (key === "messageStop") valid = hasKeys(value, ["stopReason"]) && typeof value.stopReason === "string";
+		else if (key === "metadata") valid = hasKeys(value, ["usage", "metrics"]) && numericMetadata(value);
+		else if (key === "usage" || key === "tokenUsage" || key === "estimatedTokenUsage") valid = numericMetadata(value);
+		else valid = metadataKeys.has(key) && (value == null || typeof value === "string" || typeof value === "number" && Number.isFinite(value));
+		if (!valid) throw new ProviderTextProtectionError("unsupported");
+	}
+}
+var Candidate = class {
+	attempt;
+	provider;
+	block;
+	stringContent = false;
+	toolInputIndices = /* @__PURE__ */ new Set();
+	responses;
+	constructor(attempt, provider) {
+		this.attempt = attempt;
+		this.provider = provider;
+		this.responses = new ResponsesTextProjection(attempt);
+	}
+	strip(generation) {
+		const message = generation.message;
+		if (!(message instanceof AIMessageChunk)) throw new ProviderTextProtectionError("unsupported");
+		this.attempt.observeChunk();
+		for (const key of Object.keys(message.additional_kwargs)) {
+			if (additionalKeys.has(key)) continue;
+			const validate = (this.provider === "google" ? geminiControls[key] : void 0) ?? (key === "__openai_responses_replay_positions__" ? replayPositions : void 0) ?? (key === "__openai_function_call_ids__" ? stringMap : void 0) ?? additionalControls[key];
+			if (validate == null || !validate(message.additional_kwargs[key])) throw new ProviderTextProtectionError("unsupported");
+		}
+		let content;
+		if (typeof message.content === "string") {
+			if (message.content && this.block != null) throw new ProviderTextProtectionError("unsupported");
+			this.stringContent ||= message.content.length > 0;
+			const details = message.additional_kwargs.reasoning_details;
+			this.attempt.append(message.content, this.provider === "openrouter" && Array.isArray(details) && details.length > 0);
+			content = "";
+		} else {
+			content = [];
+			for (const block of message.content) {
+				if (typeof block === "string") throw new ProviderTextProtectionError("unsupported");
+				if (block.type !== "text") {
+					this.admitControl(block, message);
+					content.push(block);
+					continue;
+				}
+				if (typeof block.text !== "string" || this.stringContent || Object.keys(block).some((key) => ![
+					"type",
+					"text",
+					"index",
+					"annotations",
+					"phase"
+				].includes(key)) || "annotations" in block && (!Array.isArray(block.annotations) || block.annotations.length > 0) || "phase" in block && block.phase != null && !["commentary", "final_answer"].includes(String(block.phase))) throw new ProviderTextProtectionError("unsupported");
+				if (this.block != null && this.block.index !== block.index) throw new ProviderTextProtectionError("unsupported");
+				this.block ??= {
+					...block,
+					text: ""
+				};
+				this.attempt.append(block.text);
+			}
+		}
+		const metadata = this.responses.strip(message.response_metadata);
+		if (!Object.hasOwn(message.response_metadata, "output")) validateMetadata(metadata, this.provider === "google");
+		validateMetadata(generation.generationInfo ?? {}, this.provider === "google");
+		const stripped = copyMessage(message, content);
+		stripped.response_metadata = metadata;
+		stripped.lc_kwargs.response_metadata = metadata;
+		return new ChatGenerationChunk({
+			text: "",
+			message: stripped,
+			generationInfo: generation.generationInfo
+		});
+	}
+	admitControl(block, message) {
+		const { type, index, input, id, name } = block;
+		const part = block;
+		if (this.provider === "google" && keys(part, ["functionCall", "thoughtSignature"]) && keys(part.functionCall, [
+			"name",
+			"args",
+			"id"
+		])) {
+			const call = part.functionCall;
+			if (typeof call.name !== "string" || part.thoughtSignature != null && typeof part.thoughtSignature !== "string" || message.tool_calls?.some((tool) => tool.name === call.name && JSON.stringify(tool.args) === JSON.stringify(call.args)) !== true) throw new ProviderTextProtectionError("unsupported");
+			return;
+		}
+		if (!Object.hasOwn(block, "type")) {
+			if (!hasKeys(block, ["index", "input"]) || typeof index !== "number" || !Number.isSafeInteger(index) || index < 0 || typeof input !== "string" || !this.toolInputIndices.has(index) || message.tool_call_chunks?.some((call) => call.index === index && call.args === input) !== true) throw new ProviderTextProtectionError("unsupported");
+			return;
+		}
+		if (type == null || !controlBlocks.has(type)) throw new ProviderTextProtectionError("unsupported");
+		if (type === "tool_use" && index != null) {
+			if (typeof index !== "number" || !Number.isSafeInteger(index) || index < 0 || message.tool_call_chunks?.some((call) => call.index === index && call.id === id && call.name === name) !== true) throw new ProviderTextProtectionError("unsupported");
+			if (!this.toolInputIndices.has(index)) {
+				this.attempt.observeChunk();
+				this.toolInputIndices.add(index);
+			}
+		}
+	}
+	async canonical() {
+		const content = await this.attempt.release();
+		const metadata = this.responses.canonical(content);
+		if (!content && metadata == null) return void 0;
+		return new ChatGenerationChunk({
+			text: content,
+			message: new AIMessageChunk({
+				content: this.block == null ? content : [{
+					...this.block,
+					text: content
+				}],
+				response_metadata: metadata
+			})
+		});
+	}
+};
+function clone(value) {
+	return Object.create(Object.getPrototypeOf(value), Object.getOwnPropertyDescriptors(value));
+}
+function assertBindingShell(model) {
+	if (model.constructor !== RunnableBinding || (model.configFactories?.length ?? 0) > 0 || model.invoke !== RunnableBinding.prototype.invoke || model.batch !== RunnableBinding.prototype.batch || model.stream !== RunnableBinding.prototype.stream || model.transform !== RunnableBinding.prototype.transform || model._streamIterator !== RunnableBinding.prototype._streamIterator) throw new ProviderTextProtectionError("unsupported");
+}
+function assertInputStep(input) {
+	if (isProviderTextInput(input)) return;
+	if (input instanceof RunnableBinding) {
+		assertBindingShell(input);
+		assertInputStep(input.bound);
+		return;
+	}
+	throw new ProviderTextProtectionError("unsupported");
+}
+function hasStreamingInvocation(model, options) {
+	if ("streaming" in model && model.streaming === true) return true;
+	const params = model.invocationParams(options);
+	if (params == null || typeof params !== "object" || Array.isArray(params)) throw new ProviderTextProtectionError("unsupported");
+	return "stream" in params && params.stream != null && params.stream !== false;
+}
+function usesInternalStreaming(model, options) {
+	if (hasStreamingInvocation(model, options)) return true;
+	for (const key of ["completions", "responses"]) {
+		const delegate = Reflect.get(model, key);
+		if (delegate instanceof BaseChatModel && hasStreamingInvocation(delegate, options)) return true;
+	}
+	return false;
+}
+function withProviderTextBoundary(model, policy, provider) {
+	const protectedModel = clone(model);
+	if (model instanceof RunnableBinding) {
+		assertBindingShell(model);
+		Object.defineProperty(protectedModel, "bound", { value: withProviderTextBoundary(model.bound, policy, provider) });
+		return protectedModel;
+	}
+	if (model instanceof RunnableSequence) {
+		if (model.constructor !== RunnableSequence || model.invoke !== RunnableSequence.prototype.invoke || model.batch !== RunnableSequence.prototype.batch || model.stream !== RunnableSequence.prototype.stream || model.transform !== RunnableSequence.prototype.transform || model._streamIterator !== RunnableSequence.prototype._streamIterator) throw new ProviderTextProtectionError("unsupported");
+		const steps = model.steps;
+		for (let index = 0; index < steps.length - 1; index++) assertInputStep(steps[index]);
+		Object.defineProperty(protectedModel, "last", { value: withProviderTextBoundary(steps[steps.length - 1], policy, provider) });
+		return protectedModel;
+	}
+	if (!(model instanceof BaseChatModel) || model.cache != null) throw new ProviderTextProtectionError("unsupported");
+	if (model.transform !== BaseChatModel.prototype.transform || model._streamIterator !== BaseChatModel.prototype._streamIterator || model.generate !== BaseChatModel.prototype.generate || model.generatePrompt !== BaseChatModel.prototype.generatePrompt || model._generateUncached !== BaseChatModel.prototype._generateUncached) throw new ProviderTextProtectionError("unsupported");
+	if (model.stream !== BaseChatModel.prototype.stream || model.invoke !== BaseChatModel.prototype.invoke) {
+		const openAI = getChatModelClass("openAI");
+		if (model.stream !== openAI.prototype.stream || model.invoke !== openAI.prototype.invoke) throw new ProviderTextProtectionError("unsupported");
+	}
+	if (model.disableStreaming && usesInternalStreaming(model)) throw new ProviderTextProtectionError("unsupported");
+	const protectedChat = clone(model);
+	protectedChat._streamResponseChunks = async function* (messages, options, runManager) {
+		const attempt = new ProviderTextAttempt(policy, options.signal);
+		const candidate = new Candidate(attempt, provider);
+		let source;
+		try {
+			source = model._streamResponseChunks(messages, {
+				...options,
+				signal: attempt.signal
+			}, void 0);
+			for (;;) {
+				const next = await attempt.wait(source.next());
+				attempt.check();
+				if (next.done === true) break;
+				const chunk = candidate.strip(next.value);
+				yield chunk;
+				await runManager?.handleLLMNewToken("", void 0, void 0, void 0, void 0, { chunk });
+			}
+			const canonical = await candidate.canonical();
+			attempt.check();
+			if (canonical != null) {
+				yield canonical;
+				attempt.check();
+				await runManager?.handleLLMNewToken(canonical.text, void 0, void 0, void 0, void 0, { chunk: canonical });
+			}
+		} finally {
+			try {
+				if (source != null) attempt.wait(source.return(void 0)).catch(() => {});
+			} finally {
+				attempt.finish();
+			}
+		}
+	};
+	protectedChat._streamChatModelEvents = BaseChatModel.prototype._streamChatModelEvents;
+	protectedChat._generate = async function(messages, options) {
+		if (usesInternalStreaming(model, options)) throw new ProviderTextProtectionError("unsupported");
+		const attempt = new ProviderTextAttempt(policy, options.signal);
+		try {
+			const result = await attempt.wait(model._generate(messages, {
+				...options,
+				signal: attempt.signal
+			}, void 0));
+			attempt.check();
+			if (result.llmOutput != null) validateMetadata(result.llmOutput, provider === "google");
+			if (result.generations.length !== 1) throw new ProviderTextProtectionError("unsupported");
+			const generation = result.generations[0];
+			if (!(generation.message instanceof AIMessage)) throw new ProviderTextProtectionError("unsupported");
+			const message = generation.message instanceof AIMessageChunk ? generation.message : copyMessage(generation.message, generation.message.content);
+			const candidate = new Candidate(attempt, provider);
+			const stripped = candidate.strip(new ChatGenerationChunk({
+				...generation,
+				message
+			}));
+			const canonical = await candidate.canonical();
+			attempt.check();
+			const released = canonical == null ? stripped : new ChatGenerationChunk({
+				text: canonical.text,
+				message: copyMessage(stripped.message, mergeContent(stripped.message.content, canonical.message.content)),
+				generationInfo: stripped.generationInfo
+			});
+			if (canonical != null) {
+				released.message.response_metadata = {
+					...released.message.response_metadata,
+					...canonical.message.response_metadata
+				};
+				released.message.lc_kwargs.response_metadata = released.message.response_metadata;
+			}
+			return {
+				...result,
+				generations: [released]
+			};
+		} finally {
+			attempt.finish();
+		}
+	};
+	return protectedChat;
+}
+//#endregion
+export { withProviderTextBoundary };
+
+//# sourceMappingURL=providerTextBoundary.mjs.map

package/dist/esm/llm/providerTextBoundary.mjs.map

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

package/dist/esm/llm/providerTextChunk.mjs

@@ -0,0 +1,13 @@
+import { AIMessageChunk } from "@langchain/core/messages";
+//#region src/llm/providerTextChunk.ts
+const constructors = /* @__PURE__ */ new WeakMap();
+function registerProviderTextChunkConstructor(constructor) {
+	constructors.set(constructor.prototype, constructor);
+}
+function createProviderTextChunk(source, fields) {
+	return new ((constructors.get(Object.getPrototypeOf(source))) ?? AIMessageChunk)(fields);
+}
+//#endregion
+export { createProviderTextChunk, registerProviderTextChunkConstructor };
+
+//# sourceMappingURL=providerTextChunk.mjs.map

package/dist/esm/llm/providerTextChunk.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerTextChunk.mjs","names":[],"sources":["../../../src/llm/providerTextChunk.ts"],"mappings":";;AAIA,MAAM,+BAAe,IAAI,QAAkC;AAG3D,SAAgB,qCAAqC,aAAqC;CACxF,aAAa,IAAI,YAAY,WAAW,WAAW;AACrD;AAEA,SAAgB,wBAAwB,QAAgB,QAA8C;CAEpG,OAAO,MADa,aAAa,IAAI,OAAO,eAAe,MAAM,CAAC,MAAK,gBAChD,MAAM;AAC/B"}

package/dist/esm/llm/providerTextControls.mjs

@@ -0,0 +1,230 @@
+import { ProviderTextProtectionError } from "../protection/providerText.mjs";
+//#region src/llm/providerTextControls.ts
+const GEMINI_SIGNATURES = "__gemini_function_call_thought_signatures__";
+const RESPONSES_POSITIONS = "__openai_responses_replay_positions__";
+function keys(value, allowed) {
+	return value != null && typeof value === "object" && !Array.isArray(value) && Object.keys(value).every((key) => allowed.includes(key));
+}
+function stringMap(value) {
+	return value != null && typeof value === "object" && !Array.isArray(value) && Object.entries(value).length <= 128 && Object.values(value).every((entry) => typeof entry === "string");
+}
+function safetyRatings(value) {
+	return Array.isArray(value) && value.length <= 16 && value.every((entry) => keys(entry, [
+		"category",
+		"probability",
+		"blocked"
+	]) && typeof entry.category === "string" && /^HARM_CATEGORY_[A-Z_]+$/.test(entry.category) && [
+		"NEGLIGIBLE",
+		"LOW",
+		"MEDIUM",
+		"HIGH",
+		"HARM_PROBABILITY_UNSPECIFIED"
+	].includes(String(entry.probability)) && (entry.blocked == null || typeof entry.blocked === "boolean"));
+}
+function replayPositions(value) {
+	return Array.isArray(value) && value.length <= 128 && value.every((entry) => keys(entry, [
+		"itemId",
+		"kind",
+		"outputIndex",
+		"contentIndex"
+	]) && typeof entry.itemId === "string" && [
+		"message",
+		"text",
+		"reasoning",
+		"output"
+	].includes(String(entry.kind)) && typeof entry.outputIndex === "number" && Number.isSafeInteger(entry.outputIndex) && entry.outputIndex >= 0 && (entry.contentIndex == null || typeof entry.contentIndex === "number" && Number.isSafeInteger(entry.contentIndex) && entry.contentIndex >= 0));
+}
+const scalarKeys = new Set([
+	"id",
+	"model",
+	"model_name",
+	"model_provider",
+	"created_at",
+	"object",
+	"status",
+	"user",
+	"service_tier",
+	"max_output_tokens",
+	"max_tool_calls",
+	"parallel_tool_calls",
+	"temperature",
+	"top_p",
+	"truncation",
+	"store",
+	"background",
+	"previous_response_id",
+	"prompt_cache_key",
+	"prompt_cache_retention",
+	"safety_identifier",
+	"completed_at"
+]);
+function messageOutput(value) {
+	if (!keys(value, [
+		"id",
+		"type",
+		"role",
+		"status",
+		"phase",
+		"content"
+	]) || value.type !== "message" || typeof value.id !== "string" || value.role !== "assistant" || !["completed", "incomplete"].includes(String(value.status)) || value.phase != null && !["commentary", "final_answer"].includes(String(value.phase)) || !Array.isArray(value.content) || value.content.length !== 1) return false;
+	const part = value.content[0];
+	return keys(part, [
+		"type",
+		"text",
+		"annotations",
+		"logprobs"
+	]) && part.type === "output_text" && typeof part.text === "string" && Array.isArray(part.annotations) && part.annotations.length === 0 && (part.logprobs === void 0 || Array.isArray(part.logprobs) && part.logprobs.length === 0);
+}
+var ResponsesTextProjection = class {
+	attempt;
+	metadata;
+	hasOutputAlias = false;
+	output;
+	constructor(attempt) {
+		this.attempt = attempt;
+	}
+	strip(metadata) {
+		if (!Object.hasOwn(metadata, "output")) return metadata;
+		if (this.metadata != null || metadata.model_provider !== "openai" || metadata.object !== "response" || !Array.isArray(metadata.output) || metadata.output.length > 32) throw new ProviderTextProtectionError("unsupported");
+		let messageCount = 0;
+		const output = metadata.output.map((item) => {
+			if (messageOutput(item)) {
+				if (++messageCount > 1 || !this.attempt.matchesText(item.content[0].text)) throw new ProviderTextProtectionError("unsupported");
+				return {
+					...item,
+					content: [{
+						...item.content[0],
+						text: ""
+					}]
+				};
+			}
+			if (!responseOutputControl(item)) throw new ProviderTextProtectionError("unsupported");
+			return item;
+		});
+		if (messageCount === 0 && !this.attempt.matchesText("") || metadata.output_text != null && (typeof metadata.output_text !== "string" || !this.attempt.matchesText(metadata.output_text))) throw new ProviderTextProtectionError("unsupported");
+		for (const [key, value] of Object.entries(metadata)) {
+			let valid;
+			if (key === "output" || key === "output_text") continue;
+			if (key === "top_logprobs") valid = value == null || value === 0;
+			else if (key === "usage") valid = numericTree(value);
+			else if (key === "text") valid = keys(value, ["format", "verbosity"]) && keys(value.format, ["type"]) && value.format.type === "text" && (value.verbosity == null || [
+				"low",
+				"medium",
+				"high"
+			].includes(String(value.verbosity)));
+			else if (key === "tools") valid = Array.isArray(value) && value.length <= 32 && value.every(responseTool);
+			else if (key === "tool_choice") valid = value === "auto" || value === "none" || value === "required" || keys(value, ["type", "name"]) && value.type === "function" && typeof value.name === "string";
+			else if (key === "reasoning") valid = value == null || keys(value, ["effort", "summary"]) && (value.effort == null || [
+				"none",
+				"minimal",
+				"low",
+				"medium",
+				"high",
+				"xhigh"
+			].includes(String(value.effort))) && (value.summary == null || [
+				"auto",
+				"concise",
+				"detailed"
+			].includes(String(value.summary)));
+			else if (key === "metadata") valid = keys(value, []) || value == null;
+			else if (key === "instructions" || key === "error") valid = value == null;
+			else if (key === "incomplete_details") valid = value == null || keys(value, ["reason"]) && ["max_output_tokens", "content_filter"].includes(String(value.reason));
+			else valid = scalarKeys.has(key) && (value == null || typeof value === "string" || typeof value === "boolean" || typeof value === "number" && Number.isFinite(value));
+			if (!valid) throw new ProviderTextProtectionError("unsupported");
+		}
+		retainTree(metadata, this.attempt);
+		this.output = output;
+		this.hasOutputAlias = Object.hasOwn(metadata, "output_text");
+		const { output: _output, output_text: _alias, ...controls } = metadata;
+		this.metadata = controls;
+		return controls;
+	}
+	canonical(content) {
+		if (this.metadata == null || this.output == null) return void 0;
+		return {
+			output: this.output.map((item) => messageOutput(item) ? {
+				...item,
+				content: [{
+					...item.content[0],
+					text: content
+				}]
+			} : item),
+			...this.hasOutputAlias ? { output_text: content } : {}
+		};
+	}
+};
+function numericTree(value, depth = 4) {
+	if (value == null) return true;
+	if (typeof value === "number") return Number.isFinite(value);
+	if (typeof value !== "object" || Array.isArray(value) || depth === 0) return false;
+	const entries = Object.values(value);
+	return entries.length <= 64 && entries.every((entry) => numericTree(entry, depth - 1));
+}
+function responseOutputControl(value) {
+	if (!keys(value, [
+		"id",
+		"type",
+		"status",
+		"call_id",
+		"name",
+		"arguments",
+		"summary",
+		"encrypted_content"
+	])) return false;
+	if (typeof value.id !== "string" || value.status != null && ![
+		"completed",
+		"incomplete",
+		"in_progress"
+	].includes(String(value.status))) return false;
+	if (value.type === "function_call") return keys(value, [
+		"id",
+		"type",
+		"status",
+		"call_id",
+		"name",
+		"arguments"
+	]) && typeof value.call_id === "string" && typeof value.name === "string" && typeof value.arguments === "string";
+	if (value.type !== "reasoning" || !keys(value, [
+		"id",
+		"type",
+		"status",
+		"summary",
+		"encrypted_content"
+	])) return false;
+	return (value.encrypted_content == null || typeof value.encrypted_content === "string") && Array.isArray(value.summary) && value.summary.length <= 32 && value.summary.every((entry) => keys(entry, ["type", "text"]) && entry.type === "summary_text" && typeof entry.text === "string");
+}
+function responseTool(value) {
+	return keys(value, [
+		"type",
+		"name",
+		"description",
+		"strict",
+		"parameters"
+	]) && value.type === "function" && typeof value.name === "string" && (value.description == null || typeof value.description === "string") && (value.strict == null || typeof value.strict === "boolean") && jsonControl(value.parameters);
+}
+function jsonControl(value, depth = 6) {
+	if (value == null || typeof value === "string" || typeof value === "boolean") return true;
+	if (typeof value === "number") return Number.isFinite(value);
+	if (typeof value !== "object" || depth === 0) return false;
+	const entries = Object.values(value);
+	return entries.length <= 64 && entries.every((entry) => jsonControl(entry, depth - 1));
+}
+function retainTree(value, attempt, depth = 8) {
+	if (typeof value === "string") {
+		attempt.retain(value.length * 2 + 32);
+		return;
+	}
+	attempt.retain(64);
+	if (value == null || typeof value !== "object") return;
+	if (depth === 0) throw new ProviderTextProtectionError("unsupported");
+	const entries = Object.entries(value);
+	if (entries.length > 128) throw new ProviderTextProtectionError("unsupported");
+	for (const [key, entry] of entries) {
+		attempt.retain(key.length * 2 + 32);
+		retainTree(entry, attempt, depth - 1);
+	}
+}
+//#endregion
+export { GEMINI_SIGNATURES, RESPONSES_POSITIONS, ResponsesTextProjection, keys, replayPositions, safetyRatings, stringMap };
+
+//# sourceMappingURL=providerTextControls.mjs.map

package/dist/esm/llm/providerTextControls.mjs.map

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

package/dist/esm/llm/stream/smoother.mjs

@@ -1,3 +1,4 @@
+import { isProtectedProviderTextSignal } from "../../protection/providerText.mjs";
 //#region src/llm/stream/smoother.ts
 const DEFAULT_STREAM_DELAY = 25;
 const MAX_SMOOTH_ITEM_SEGMENT_CHARS = 4096;
@@ -52,7 +53,7 @@ async function waitForStreamDelay(delay, signal) {
 	});
 }
 async function* smoothStream({ source, delayMs, signal, abortUpstream }) {
-	if (!(delayMs > 0)) {
+	if (!(delayMs > 0) || isProtectedProviderTextSignal(signal)) {
 		for await (const item of source) {
 			if (isSignalAborted(signal)) {
 				abortUpstream?.();