@librechat/agents 4.0.3 → 4.0.4

package/dist/cjs/main.cjs

@@ -101,6 +101,7 @@ const require_run$1 = require("./run.cjs");
 require("./graphs/index.cjs");
 const require_projection = require("./agents/projection.cjs");
 const require_Calculator = require("./tools/Calculator.cjs");
+const require_GitHubCompare = require("./tools/GitHubCompare.cjs");
 const require_SkillTool = require("./tools/SkillTool.cjs");
 const require_ReadFile = require("./tools/ReadFile.cjs");
 const require_skillCatalog = require("./tools/skillCatalog.cjs");
@@ -256,6 +257,12 @@ exports.FADING_MIN_BUDGET_TOKENS = require_fading.FADING_MIN_BUDGET_TOKENS;
 exports.FADING_TIER_VERSION = require_fading.FADING_TIER_VERSION;
 exports.FAILED_EXECUTION_FILE_REMINDER = require_CodeExecutor.FAILED_EXECUTION_FILE_REMINDER;
 exports.FakeChatModel = require_fake.FakeChatModel;
+exports.GitHubCompareTool = require_GitHubCompare.GitHubCompareTool;
+exports.GitHubCompareToolDefinition = require_GitHubCompare.GitHubCompareToolDefinition;
+exports.GitHubCompareToolDescription = require_GitHubCompare.GitHubCompareToolDescription;
+exports.GitHubCompareToolName = require_GitHubCompare.GitHubCompareToolName;
+exports.GitHubCompareToolSchema = require_GitHubCompare.GitHubCompareToolSchema;
+exports.GitHubComparisonError = require_GitHubCompare.GitHubComparisonError;
 exports.Graph = require_Graph.Graph;
 exports.GraphEvents = require_enum.GraphEvents;
 exports.GraphNodeActions = require_enum.GraphNodeActions;
@@ -501,6 +508,7 @@ exports.cloneMessage = require_cache.cloneMessage;
 exports.coalesceAdjacentUserTurns = require_alternation.coalesceAdjacentUserTurns;
 exports.commandAvailabilityEnvCacheKey = require_LocalExecutionEngine.commandAvailabilityEnvCacheKey;
 exports.compactSyntheticProviderContextMessage = require_format.compactSyntheticProviderContextMessage;
+exports.compareGitHubCommits = require_GitHubCompare.compareGitHubCommits;
 exports.composeAbortSignals = require_misc.composeAbortSignals;
 exports.composeEventHandlers = require_events.composeEventHandlers;
 exports.computeAdaptivePieceSize = require_smoother.computeAdaptivePieceSize;

package/dist/cjs/tools/GitHubCompare.cjs

@@ -0,0 +1,181 @@
+const require_intentArg = require("./intentArg.cjs");
+let _langchain_core_tools = require("@langchain/core/tools");
+//#region src/tools/GitHubCompare.ts
+const GitHubCompareToolName = "github_compare";
+const GitHubCompareToolDescription = "Read-only GitHub comparison of two full commit SHAs in a public repository. Returns the merge-base, relation and commit counts without Git, a worktree, or worker admission. Does not fetch code or execute commands. Private repositories and arbitrary URLs are not supported.";
+const GitHubCompareToolSchema = {
+	type: "object",
+	properties: {
+		intent: { ...require_intentArg.INTENT_PROPERTY },
+		owner: {
+			type: "string",
+			description: "GitHub repository owner."
+		},
+		repo: {
+			type: "string",
+			description: "GitHub repository name."
+		},
+		base: {
+			type: "string",
+			description: "Full lowercase base commit SHA, not a moving branch."
+		},
+		head: {
+			type: "string",
+			description: "Full lowercase head commit SHA, not a moving branch."
+		}
+	},
+	required: [
+		"owner",
+		"repo",
+		"base",
+		"head"
+	]
+};
+const GitHubCompareToolDefinition = {
+	name: GitHubCompareToolName,
+	description: GitHubCompareToolDescription,
+	parameters: GitHubCompareToolSchema
+};
+var GitHubComparisonError = class extends Error {
+	code;
+	status;
+	constructor(code, message, status) {
+		super(message);
+		this.code = code;
+		this.status = status;
+		this.name = "GitHubComparisonError";
+	}
+};
+const SHA = /^[a-f0-9]{40}$/;
+const REPO = /^[A-Za-z0-9][A-Za-z0-9_.-]{0,99}$/;
+const MAX_RESPONSE_BYTES = 2 * 1024 * 1024;
+function awaitWithSignal(operation, signal) {
+	signal.throwIfAborted();
+	return new Promise((resolve, reject) => {
+		const onAbort = () => {
+			signal.removeEventListener("abort", onAbort);
+			reject(signal.reason);
+		};
+		signal.addEventListener("abort", onAbort, { once: true });
+		try {
+			operation().then((value) => {
+				signal.removeEventListener("abort", onAbort);
+				resolve(value);
+			}, (error) => {
+				signal.removeEventListener("abort", onAbort);
+				reject(error);
+			});
+		} catch (error) {
+			signal.removeEventListener("abort", onAbort);
+			reject(error);
+		}
+	});
+}
+function cancelBody(response) {
+	response.body?.cancel().catch(() => void 0);
+}
+async function readResponse(response, signal) {
+	const reader = response.body?.getReader();
+	if (reader == null) throw new GitHubComparisonError("INVALID_RESPONSE", "GitHub comparison returned an invalid response.");
+	const chunks = [];
+	let bytes = 0;
+	try {
+		for (;;) {
+			const item = await awaitWithSignal(() => reader.read(), signal);
+			if (item.done) break;
+			bytes += item.value.byteLength;
+			if (bytes > MAX_RESPONSE_BYTES) throw new GitHubComparisonError("RESPONSE_TOO_LARGE", "GitHub comparison response exceeded its bound.");
+			chunks.push(item.value);
+		}
+		return Buffer.concat(chunks, bytes).toString("utf8");
+	} finally {
+		reader.cancel().catch(() => void 0);
+		reader.releaseLock();
+	}
+}
+function parseComparison(text, input) {
+	let data;
+	try {
+		data = JSON.parse(text);
+	} catch {
+		throw new GitHubComparisonError("INVALID_RESPONSE", "GitHub comparison returned an invalid response.");
+	}
+	const mergeBase = data?.merge_base_commit?.sha;
+	const status = data?.status;
+	const aheadBy = data?.ahead_by;
+	const behindBy = data?.behind_by;
+	const totalCommits = data?.total_commits;
+	if (data?.base_commit?.sha !== input.base || typeof mergeBase !== "string" || !SHA.test(mergeBase) || status !== "ahead" && status !== "behind" && status !== "identical" && status !== "diverged" || typeof aheadBy !== "number" || !Number.isSafeInteger(aheadBy) || aheadBy < 0 || typeof behindBy !== "number" || !Number.isSafeInteger(behindBy) || behindBy < 0 || typeof totalCommits !== "number" || !Number.isSafeInteger(totalCommits) || totalCommits < 0) throw new GitHubComparisonError("INVALID_RESPONSE", "GitHub comparison returned an invalid response.");
+	return {
+		base: input.base,
+		head: input.head,
+		mergeBase,
+		status,
+		aheadBy,
+		behindBy,
+		totalCommits
+	};
+}
+async function compareGitHubCommits(input, options, signal) {
+	signal?.throwIfAborted();
+	if (typeof input.owner !== "string" || !REPO.test(input.owner) || typeof input.repo !== "string" || !REPO.test(input.repo) || typeof input.base !== "string" || !SHA.test(input.base) || typeof input.head !== "string" || !SHA.test(input.head)) throw new GitHubComparisonError("INVALID_INPUT", "Supply a repository and full lowercase commit SHAs.");
+	const timeoutMs = options.timeoutMs ?? 1e4;
+	if (typeof options.fetch !== "function" || !Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 3e4) throw new GitHubComparisonError("INVALID_CONFIGURATION", "Supply a GitHub transport and a timeout between 1 and 30000 ms.");
+	const timeout = new AbortController();
+	const timer = setTimeout(() => timeout.abort(new DOMException("GitHub comparison timed out.", "TimeoutError")), timeoutMs);
+	timer.unref();
+	let pendingResponse;
+	const requestSignal = signal == null ? timeout.signal : AbortSignal.any([signal, timeout.signal]);
+	try {
+		const response = await awaitWithSignal(() => options.fetch(`https://api.github.com/repos/${encodeURIComponent(input.owner)}/${encodeURIComponent(input.repo)}/compare/${input.base}...${input.head}?per_page=1&page=2`, {
+			method: "GET",
+			redirect: "error",
+			credentials: "omit",
+			signal: requestSignal,
+			headers: {
+				Accept: "application/vnd.github+json",
+				"X-GitHub-Api-Version": "2022-11-28"
+			}
+		}).then((response) => {
+			pendingResponse = response;
+			if (requestSignal.aborted) {
+				pendingResponse = void 0;
+				cancelBody(response);
+				requestSignal.throwIfAborted();
+			}
+			return response;
+		}), requestSignal);
+		if (!response.ok) throw new GitHubComparisonError("HTTP_ERROR", `GitHub comparison unavailable (HTTP ${response.status}).`, response.status);
+		pendingResponse = void 0;
+		const text = await readResponse(response, requestSignal);
+		requestSignal.throwIfAborted();
+		return parseComparison(text, input);
+	} catch (error) {
+		requestSignal.throwIfAborted();
+		if (error instanceof GitHubComparisonError) throw error;
+		throw new GitHubComparisonError("TRANSPORT_ERROR", "GitHub comparison transport failed.");
+	} finally {
+		if (pendingResponse != null) cancelBody(pendingResponse);
+		clearTimeout(timer);
+	}
+}
+var GitHubCompareTool = class extends _langchain_core_tools.DynamicStructuredTool {
+	constructor(options) {
+		super({
+			name: GitHubCompareToolName,
+			description: GitHubCompareToolDescription,
+			schema: structuredClone(GitHubCompareToolSchema),
+			func: async (input, _manager, config) => JSON.stringify(await compareGitHubCommits(input, options, config?.signal))
+		});
+	}
+};
+//#endregion
+exports.GitHubCompareTool = GitHubCompareTool;
+exports.GitHubCompareToolDefinition = GitHubCompareToolDefinition;
+exports.GitHubCompareToolDescription = GitHubCompareToolDescription;
+exports.GitHubCompareToolName = GitHubCompareToolName;
+exports.GitHubCompareToolSchema = GitHubCompareToolSchema;
+exports.GitHubComparisonError = GitHubComparisonError;
+exports.compareGitHubCommits = compareGitHubCommits;
+
+//# sourceMappingURL=GitHubCompare.cjs.map

package/dist/cjs/tools/GitHubCompare.cjs.map

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

package/dist/esm/main.mjs

@@ -100,6 +100,7 @@ import { Run, defaultOmitOptions } from "./run.mjs";
 import "./graphs/index.mjs";
 import { projectAgentContextUsage } from "./agents/projection.mjs";
 import { Calculator, CalculatorSchema, CalculatorToolDefinition, CalculatorToolDescription, CalculatorToolName } from "./tools/Calculator.mjs";
+import { GitHubCompareTool, GitHubCompareToolDefinition, GitHubCompareToolDescription, GitHubCompareToolName, GitHubCompareToolSchema, GitHubComparisonError, compareGitHubCommits } from "./tools/GitHubCompare.mjs";
 import { SkillToolDefinition, SkillToolDescription, SkillToolName, SkillToolSchema } from "./tools/SkillTool.mjs";
 import { ReadFileToolDefinition, ReadFileToolDescription, ReadFileToolName, ReadFileToolSchema } from "./tools/ReadFile.mjs";
 import { formatSkillCatalog } from "./tools/skillCatalog.mjs";
@@ -138,4 +139,4 @@ import { createSystemOneReranker } from "./rerank/systemone.mjs";
 import { createWebSearchReranker } from "./rerank/search.mjs";
 import "./rerank/index.mjs";
 import { BaseCheckpointSaver, Command, INTERRUPT, MemorySaver, interrupt, isInterrupted } from "@langchain/langgraph";
-export { ACTIVITY_LABEL_RUN_NAME, ACTIVITY_PHASE_LABEL_RUN_NAME, ACTIVITY_PHASE_RUN_NAME, AGENT_MODEL_CALL_RUN_NAME, AIMessage, AIMessageChunk, ANTHROPIC_TOOL_TOKEN_MULTIPLIER, ASK_USER_QUESTION_ID_PATTERN, AgentSession, BASH_SHELL_GUIDANCE, BaseCheckpointSaver, BaseMessage, BaseMessageChunk, BashExecutionToolDefinition, BashExecutionToolDescription, BashExecutionToolName, BashExecutionToolSchema, BashProgrammaticToolCallingDefinition, BashProgrammaticToolCallingDescription, BashProgrammaticToolCallingName, BashProgrammaticToolCallingSchema, BashToolOutputReferencesGuide, CALIBRATION_RATIO_MAX, CALIBRATION_RATIO_MIN, CLOUDFLARE_BASH_CODING_TOOL_NAMES, CLOUDFLARE_CODING_TOOL_NAMES, CODE_API_AUTHORIZATION_ERROR_MESSAGE, CODE_API_CAPABILITY_ERROR_MESSAGE, CODE_API_EXECUTION_FAILED_ERROR_MESSAGE, CODE_API_EXPECTED_PROFILE_HEADER, CODE_API_INVALID_REQUEST_ERROR_MESSAGE, CODE_API_RATE_LIMITED_ERROR_MESSAGE, CODE_API_UNAVAILABLE_ERROR_MESSAGE, CODE_ARTIFACT_PATH_GUIDANCE, CODE_EXECUTION_TOOLS, COMPACTION_SEMANTIC_INDEX_LIMITS, Calculator, CalculatorSchema, CalculatorToolDefinition, CalculatorToolDescription, CalculatorToolName, Callback, ChatModelStreamHandler, CloudflareBashExecutionToolDescription, CloudflareCodeExecutionToolDescription, CodeApiRequestError, CodeExecutionToolDefinition, CodeExecutionToolDescription, CodeExecutionToolName, CodeExecutionToolSchema, Command, CommonEvents, CompileCheckToolName, Constants, ContentTypes, DATE_RANGE, DECISION_PRESETS, DEFAULT_API_KEY_ENV, DEFAULT_CONTEXT_PRUNING_SETTINGS, DEFAULT_COUNTRY_DESCRIPTION, DEFAULT_HOOK_TIMEOUT_MS, DEFAULT_INTRA_TURN_RETAIN_RATIO, DEFAULT_MAX_SEALS, DEFAULT_MAX_STOP_CONTINUATIONS, DEFAULT_MAX_TOOL_CALL_ARG_BYTES, DEFAULT_PREEMPT_RESTART_GRACE_MS, DEFAULT_PROMPT_CACHE_TTL, DEFAULT_QUERY_DESCRIPTION, DEFAULT_RECURSION_LIMIT, DEFAULT_RESERVE_RATIO, DEFAULT_RETAIN_RECENT_TURNS, DEFAULT_STREAM_DELAY, DEFAULT_SUBAGENT_DESCRIPTION, DEFAULT_TOOL_TOKEN_MULTIPLIER, DecisionError, DynamicStructuredTool, EnvVar, EventActorExecutor, FADING_MIN_BUDGET_TOKENS, FADING_TIER_VERSION, FAILED_EXECUTION_FILE_REMINDER, FakeChatModel, Graph, GraphEvents, GraphNodeActions, GraphNodeKeys, HARD_MAX_TOOL_CALL_INPUT_CHARS, HARD_MAX_TOOL_RESULT_CHARS, HARD_MAX_TOTAL_TOOL_OUTPUT_SIZE, HOOK_EVENTS, HOOK_INJECTED_MESSAGES_CAPABLE, HOOK_PREEMPT_BOUNDARY_CAPABLE, HOOK_PREEMPT_RESTART_CAPABLE, HOOK_STOP_CONTINUATION_CAPABLE, HTTP_PROVIDER_ID, HandlerRegistry, HandoffLimitError, HookRegistry, HumanMessage, IMAGE_TOKEN_SAFETY_MARGIN, INSTRUCTIONLESS_HANDOFF_CUE, INTENT_ARG, INTENT_DESCRIPTION, INTENT_LABEL_MARKER, INTENT_PROPERTY, INTERRUPT, InMemorySubagentTaskStore, JsonlSessionStore, LANGFUSE_OBSERVATION_METADATA_ARTIFACT_KEY, LLMStreamHandler, LOCAL_CODING_BUNDLE_NAMES, LOCAL_CODING_TOOL_NAMES, LOCAL_SPAWN_TIMEOUT_MS, LocalBashExecutionToolDescription, LocalCodeExecutionToolDescription, LocalEditFileToolName, LocalEditFileToolSchema, LocalFileCheckpointerImpl, LocalGlobSearchToolName, LocalGlobSearchToolSchema, LocalGrepSearchToolName, LocalGrepSearchToolSchema, LocalListDirectoryToolName, LocalListDirectoryToolSchema, LocalReadFileToolSchema, LocalWriteFileToolName, LocalWriteFileToolSchema, MASKED_RESULT_MIN_CHARS, MAX_ASK_USER_QUESTIONS, MAX_CACHE_SIZE, MAX_PATTERN_LENGTH, MIN_JSON_VALUE_CHARS, MULTI_AGENT_GRAPH_RUN_NAME, ManualSummarizationSkippedError, MemorySaver, ModelEndHandler, MultiAgentGraph, OPENAI_RESPONSES_ACTIVE_REASONING_ID_KEY, OPENAI_RESPONSES_REPLAY_POSITIONS_KEY, ORIGINAL_CONTENT_MAX_CHARS, PREDECESSOR_HANDOFF_CUE, PREEMPT_BOUNDARY_HOOK_TIMEOUT_MS, PRESSURE_THRESHOLD_MASKING, PROVIDER_MESSAGE_PROVENANCE_LIMITS, PROVIDER_MESSAGE_PROVENANCE_VERSION, PROVIDER_TEXT_PROTECTION_VERSION, ProgrammaticToolCallingDefinition, ProgrammaticToolCallingDescription, ProgrammaticToolCallingName, ProgrammaticToolCallingSchema, PromptTemplate, ProviderMessageProjectionInvariantError, ProviderTextProtectionError, Providers, REASONING_LABEL_RUN_NAME, REMOVE_ALL_MESSAGES, REPLY_PRIMER_TOKENS, ReadFileToolDefinition, ReadFileToolDescription, ReadFileToolName, ReadFileToolSchema, Run, Runnable, RunnableCallable, RunnableLambda, RunnableSequence, SDK_STREAM_DISPATCH, STANDARD_GRAPH_RUN_NAME, STATEFUL_BASH_NOTE, STATEFUL_ENV_NOTE, SUBAGENT_CONTEXT_VERSION, SUBAGENT_HOST_ARG_LIMITS, SessionManager, SkillToolDefinition, SkillToolDescription, SkillToolName, SkillToolSchema, StandardGraph, StatefulBashExecutionToolDescription, StatefulCodeExecutionToolDescription, StepTypes, StreamLimitExceededError, StructuredTool, SubagentExecutor, SubagentHostArgumentError, SubagentResolutionError, SubagentToolDefinition, SubagentToolDescription, SubagentToolName, SubagentToolSchema, SystemMessage, TMP_SCRATCH_OUTPUT_REMINDER, TOOL_APPROVAL_EXECUTION_SCOPE_CAPABLE, TOOL_APPROVAL_EXECUTION_SCOPE_CONFIG_KEY, TOOL_INPUT_ELISION_NOTE, TestChatStreamHandler, TestLLMStreamHandler, TitleMethod, TokenEncoderManager, Tool, ToolCallTypes, ToolEndHandler, ToolMessage, ToolNode, ToolSearchToolDefinition, ToolSearchToolDescription, ToolSearchToolName, ToolSearchToolSchema, UnsafeTokenMeasurementError, WebSearchToolDefinition, WebSearchToolDescription, WebSearchToolName, WebSearchToolSchema, _createBashProgramForTests, _resetLocalEngineWarningsForTests, _resetRipgrepCacheForTests, _resetSyntaxCheckProbeCacheForTests, _resetUnrecognizedTriggerWarnings, addBedrockCacheControl, addBedrockTailCacheControl, addCacheControl, addCacheControlToStablePrefixMessages, addCodeApiExecutionProfileHeader, addTailCacheControl, appendCodeSessionFileSummary, appendFailedExecutionFileReminder, appendInstructionlessHandoffCue, appendPredecessorHandoffCue, appendProviderMessageProvenance, appendTmpScratchReminder, applyContextPruning, applyEdit, applyFadingCaps, applyOutcome, applyPreToolUseHooksForBridge, apportionTokenCounts, askUserQuestion, askUserQuestions, attemptInvoke, bashAstFindingsToErrors, booleanQuestion, buildAnthropicCacheControl, buildBashExecutionToolDescription, buildBashExecutionToolSchema, buildBedrockCachePoint, buildChildInputs, buildCodeApiEndpoint, buildCodeApiExecutionErrorMessage, buildCodeApiHttpErrorMessage, buildCodeExecutionToolDescription, buildCodeExecutionToolSchema, buildSandboxRuntimeConfig, buildSubagentHostArgProperties, buildSubagentToolParams, buildSummarizationInstruction, buildSummaryCarrierText, calculateMaxToolCallInputChars, calculateMaxToolResultChars, calculateMaxTotalToolOutputSize, calculateTotalTokens, canSealPreempt, canonicalizeServerName, checkValidNumber, choiceQuestion, clampCalibrationRatio, classifyAttachment, clientExecTimeoutMs, clientFsTimeoutMs, cloneMessage, coalesceAdjacentUserTurns, commandAvailabilityEnvCacheKey, compactSyntheticProviderContextMessage, composeAbortSignals, composeEventHandlers, computeAdaptivePieceSize, constructorChainHasLcName, convertInjectedMessages, convertMessagesToContent, countNestedGroups, countrySchema, createAgentSession, createBashExecutionTool, createBashProgrammaticToolCallingSchema, createBashProgrammaticToolCallingTool, createCloudflareBashExecutionTool, createCloudflareBashProgrammaticToolCallingTool, createCloudflareBridgeRuntime, createCloudflareCodeExecutionTool, createCloudflareCodingToolBundle, createCloudflareCodingTools, createCloudflareExecutionTool, createCloudflareExecutionWorld, createCloudflareLocalExecutionConfig, createCloudflareProgrammaticToolCallingTool, createCloudflareWorkspaceFS, createCodeExecutionTool, createCompileCheckTool, createCompileCheckToolDefinition, createContentAggregator, createDecisionModel, createEventActorExecutor, createFadingTier, createFakeStreamingLLM, createGraph, createHandlers, createHttpDecisionModel, createLocalBashExecutionTool, createLocalBashProgrammaticToolCallingTool, createLocalCodeExecutionTool, createLocalCodingToolBundle, createLocalCodingToolDefinitions, createLocalCodingToolRegistry, createLocalCodingTools, createLocalEditFileTool, createLocalFileCheckpointer, createLocalGlobSearchTool, createLocalGrepSearchTool, createLocalListDirectoryTool, createLocalProgrammaticToolCallingTool, createLocalReadFileTool, createLocalWriteFileTool, createMetadataAggregator, createProgrammaticToolCallingSchema, createProgrammaticToolCallingTool, createPruneMessages, createRemoveAllMessage, createRunHandlers, createSchemaOnlyTool, createSchemaOnlyTools, createSearchTool, createStructuredChatDecisionModel, createSubagentToolDefinition, createSystemOneReranker, createTokenCounter, createToolErrorOwnership, createToolPolicyHook, createToolSearch, createTransport, createWebSearchReranker, createWorkspacePolicyHook, dateSchema, decisionPreset, decisionProviderNames, decodeFile, defaultOmitOptions, deriveMessages, deserializeMessage, dispatchesChatModelStream, dropIncompleteToolStreamContent, emptyOutputMessage, encodeFile, encodingForModel, encodingOfTokenCounter, enforceOriginalContentCap, ensureThinkingBlockInMessages, escapeRegexSpecialChars, estimateAnthropicImageTokens, estimateDocumentBlockTokens, estimateImageBlockTokens, estimateOpenAIImageTokens, estimateTimedMediaBlockTokens, execWithClientTimeout, executeCloudflareBash, executeCloudflareCode, executeHooks, executeLocalBash, executeLocalBashWithArgs, executeLocalCode, executeParallelSearches, executeTools, extractErrorMessage, extractImageDimensions, extractMcpServerName, extractTextFromContent, extractToolDiscoveries, extractUsedBashToolNames, extractUsedToolNames, fadingBudgetTokens, fadingRungForBudget, fadingRungForExchangeChars, fadingRungForResultChars, fetchSessionFiles, filterBashToolsByUsage, filterGraphSubagentResult, filterSubagentResult, filterToolsByUsage, findLastIndex, flattenLegacyContent, foldToolBlocksForToollessAgent, formatAgentMessages, formatAnthropicArtifactContent, formatAnthropicMessage, formatArtifactPayload, formatCloudflareOutput, formatCompletedResponse, formatContentStrings, formatFromLangChain, formatLangChainMessages, formatMediaMessage, formatMessage, formatServerListing, formatSkillCatalog, getAssistantTextPhase, getAvailableMcpServers, getBaseToolName, getBufferString, getChatModelClass, getChunkContent, getCloudflareWorkspaceRoot, getCodeBaseURL, getContextOverflowInfo, getConverseOverrideMessage, getDeferredToolsListing, getExecutionWorld, getLocalCwd, getLocalSessionId, getMaxOutputTokensKey, getMessageCreationContentMetadata, getMessageId, getMessagesWithinTokenLimit, getProviderMessageProvenance, getProviderSourceMessageIds, getReadRoots, getSpawn, getSubagentHostArgumentFailureMessage, getSubagentResolutionFailureMessage, getTokenCountForMessage, getWorkspaceFS, getWorkspaceRoots, getWriteRoots, handleServerToolResult, handleToolCallChunks, handleToolCalls, hasBijectiveProviderContentPartMapping, hasNestedQuantifier, hasNestedQuantifiers, hasNonEmptyTextContent, hasToolSearchInCurrentTurn, hasUnsafeStructuredSerialization, imageAttachmentContent, imagesSchema, initializeModel, inspectProviderMessageProjection, inspectProviderMessageProvenance, inspectProviderSourceMessageIds, interrupt, isAIMessage, isAnthropicLike, isAskUserQuestionsInterrupt, isBaseMessage, isBooleanAnswer, isChoiceAnswer, isContextOverflowError, isDangerousPattern, isDecisionObject, isFadingTier, isFromAnyMcpServer, isFromMcpServer, isGoogleLike, isGraphSubagentConfig, isInformativeFadingTier, isIntentLabelProperty, isInterrupted, isLegacyConvertible, isLegacyFadingTier, isLibreChatOpenAIModel, isLikelyContextOverflowError, isOpenAILike, isPresent, isProgrammaticRunnerAutoBound, isProgrammaticRunnerResolvedDirectly, isReasoningContentBlock, isScoreAnswer, isSyntheticProviderContextMessage, isThinkingEnabled, isToolMessage, isZodSchema, joinKeys, labelContentByAgent, locateEdit, makeIsDeferred, makeRequest, mapChatMessagesToStoredMessages, mapStoredMessagesToChatMessages, markTokenCounterCacheCompatible, maskConsumedToolResults, matchesQuery, maxFadingRung, mergeAggregatedHookResults, mergeDecisionSettings, messagesStateReducer, modifyDeltaProperties, newsSchema, nodeExecutionWorld, normalizeBashToolResultsForReplay, normalizeCodeApiRequestError, normalizeSearchResultData, normalizeServerFilter, normalizeSubagentConfigEntries, normalizeSubagentConfigs, normalizeToBashIdentifier, normalizeToPythonIdentifier, outcomeFieldsFromResult, parseBooleanEnv, parseEnvelope, partitionAndMarkAnthropicToolCache, performLocalSearch, preFlightTruncateToolCallInputs, preFlightTruncateToolResults, prepareBashProgrammaticCode, prepareProviderRequest, probeLocalCommandAvailability, projectAgentContextUsage, projectAnthropicArtifactContent, projectArtifactPayload, projectCacheControlledToolOutputsToText, projectComputerCallOutputsToText, projectOpenAIChatToolMessageContent, projectOpenAIResponsesToolMessageContent, projectOpenAIToolMessageContent, projectOpenRouterToolMessageContent, projectSingleTextToolOutputsToText, projectStructuredToolOutputsToText, projectToolCallInputs, projectToolMessagesForProvider, projectToolStreamContentForProvider, querySchema, readAnswer, readDecisionUsage, readIntent, readOutcomeFields, readTokenMetadataProperty, registerProvider, removePredecessorHandoffCue, repairOrphanedToolMessages, resetIfNotEmpty, resolveBedrockPromptCacheTtl, resolveCloudflareSandbox, resolveCodeApiAuthHeaders, resolveContextPruningSettings, resolveFadingCaps, resolveFadingTier, resolveFetchProxyAgent, resolveIntraTurnRetainTokens, resolveLocalExecutionConfig, resolveLocalExecutionTools, resolveLocalImplementationNames, resolveLocalToolRegistry, resolveLocalToolsForBinding, resolvePromptCacheTtl, resolveProviderMessageProjectionInvariantMode, resolveSearchOutcome, resolveServerFilters, resolveStreamDelay, resolveStreamLimits, resolveSubagentConfigEntries, resolveSubagentConfigs, resolveSubagentHostArgs, resolveToolOutcome, resolveWorkspacePath, resolveWorkspacePathSafe, runBashAstChecks, runPlainExecution, runPostEditSyntaxCheck, sanitizeOrphanToolBlocks, sanitizeRegex, scoreQuestion, seedFadingTier, selectRuntimeSessionHint, separateSummarizationParameters, serializeMessage, serializeToolCallInput, setCommandAvailabilityCacheEntry, setFreshProviderMessageProvenance, setInvalidProviderMessageProvenance, setProviderMessageProvenance, shellQuote, shiftIndexTokenCountMap, shouldBypassProxy, shouldTriggerSummarization, sleep, sliceWithoutSplittingSurrogates, smoothStream, spawnLocalProcess, splitAssistantTextContentByPhase, splitAtRecencyBoundary, stampSyntheticProviderMessage, strictAlternationProviders, stripAnthropicCacheControl, stripBedrockCacheControl, stripCodeSessionFileSummary, stripIntent, summarizeEvent, supportsBedrockToolCache, syncBudgetDerivedFields, toJsonSchema, toWireQuestion, tool, toolResultTypes, toolsCondition, truncateLocalOutput, truncateToolInput, truncateToolResultContent, tryFallbackProviders, unescapeObject, unwrapToolResponse, validateBashCommand, validateCloudflareBashCommand, validateDecisionQuestions, videosSchema, withClientTimeout, withInstructionlessHandoffCue, withIntent, withMessageRole, withoutIntent, wrapPythonForPlainExecution };
+export { ACTIVITY_LABEL_RUN_NAME, ACTIVITY_PHASE_LABEL_RUN_NAME, ACTIVITY_PHASE_RUN_NAME, AGENT_MODEL_CALL_RUN_NAME, AIMessage, AIMessageChunk, ANTHROPIC_TOOL_TOKEN_MULTIPLIER, ASK_USER_QUESTION_ID_PATTERN, AgentSession, BASH_SHELL_GUIDANCE, BaseCheckpointSaver, BaseMessage, BaseMessageChunk, BashExecutionToolDefinition, BashExecutionToolDescription, BashExecutionToolName, BashExecutionToolSchema, BashProgrammaticToolCallingDefinition, BashProgrammaticToolCallingDescription, BashProgrammaticToolCallingName, BashProgrammaticToolCallingSchema, BashToolOutputReferencesGuide, CALIBRATION_RATIO_MAX, CALIBRATION_RATIO_MIN, CLOUDFLARE_BASH_CODING_TOOL_NAMES, CLOUDFLARE_CODING_TOOL_NAMES, CODE_API_AUTHORIZATION_ERROR_MESSAGE, CODE_API_CAPABILITY_ERROR_MESSAGE, CODE_API_EXECUTION_FAILED_ERROR_MESSAGE, CODE_API_EXPECTED_PROFILE_HEADER, CODE_API_INVALID_REQUEST_ERROR_MESSAGE, CODE_API_RATE_LIMITED_ERROR_MESSAGE, CODE_API_UNAVAILABLE_ERROR_MESSAGE, CODE_ARTIFACT_PATH_GUIDANCE, CODE_EXECUTION_TOOLS, COMPACTION_SEMANTIC_INDEX_LIMITS, Calculator, CalculatorSchema, CalculatorToolDefinition, CalculatorToolDescription, CalculatorToolName, Callback, ChatModelStreamHandler, CloudflareBashExecutionToolDescription, CloudflareCodeExecutionToolDescription, CodeApiRequestError, CodeExecutionToolDefinition, CodeExecutionToolDescription, CodeExecutionToolName, CodeExecutionToolSchema, Command, CommonEvents, CompileCheckToolName, Constants, ContentTypes, DATE_RANGE, DECISION_PRESETS, DEFAULT_API_KEY_ENV, DEFAULT_CONTEXT_PRUNING_SETTINGS, DEFAULT_COUNTRY_DESCRIPTION, DEFAULT_HOOK_TIMEOUT_MS, DEFAULT_INTRA_TURN_RETAIN_RATIO, DEFAULT_MAX_SEALS, DEFAULT_MAX_STOP_CONTINUATIONS, DEFAULT_MAX_TOOL_CALL_ARG_BYTES, DEFAULT_PREEMPT_RESTART_GRACE_MS, DEFAULT_PROMPT_CACHE_TTL, DEFAULT_QUERY_DESCRIPTION, DEFAULT_RECURSION_LIMIT, DEFAULT_RESERVE_RATIO, DEFAULT_RETAIN_RECENT_TURNS, DEFAULT_STREAM_DELAY, DEFAULT_SUBAGENT_DESCRIPTION, DEFAULT_TOOL_TOKEN_MULTIPLIER, DecisionError, DynamicStructuredTool, EnvVar, EventActorExecutor, FADING_MIN_BUDGET_TOKENS, FADING_TIER_VERSION, FAILED_EXECUTION_FILE_REMINDER, FakeChatModel, GitHubCompareTool, GitHubCompareToolDefinition, GitHubCompareToolDescription, GitHubCompareToolName, GitHubCompareToolSchema, GitHubComparisonError, Graph, GraphEvents, GraphNodeActions, GraphNodeKeys, HARD_MAX_TOOL_CALL_INPUT_CHARS, HARD_MAX_TOOL_RESULT_CHARS, HARD_MAX_TOTAL_TOOL_OUTPUT_SIZE, HOOK_EVENTS, HOOK_INJECTED_MESSAGES_CAPABLE, HOOK_PREEMPT_BOUNDARY_CAPABLE, HOOK_PREEMPT_RESTART_CAPABLE, HOOK_STOP_CONTINUATION_CAPABLE, HTTP_PROVIDER_ID, HandlerRegistry, HandoffLimitError, HookRegistry, HumanMessage, IMAGE_TOKEN_SAFETY_MARGIN, INSTRUCTIONLESS_HANDOFF_CUE, INTENT_ARG, INTENT_DESCRIPTION, INTENT_LABEL_MARKER, INTENT_PROPERTY, INTERRUPT, InMemorySubagentTaskStore, JsonlSessionStore, LANGFUSE_OBSERVATION_METADATA_ARTIFACT_KEY, LLMStreamHandler, LOCAL_CODING_BUNDLE_NAMES, LOCAL_CODING_TOOL_NAMES, LOCAL_SPAWN_TIMEOUT_MS, LocalBashExecutionToolDescription, LocalCodeExecutionToolDescription, LocalEditFileToolName, LocalEditFileToolSchema, LocalFileCheckpointerImpl, LocalGlobSearchToolName, LocalGlobSearchToolSchema, LocalGrepSearchToolName, LocalGrepSearchToolSchema, LocalListDirectoryToolName, LocalListDirectoryToolSchema, LocalReadFileToolSchema, LocalWriteFileToolName, LocalWriteFileToolSchema, MASKED_RESULT_MIN_CHARS, MAX_ASK_USER_QUESTIONS, MAX_CACHE_SIZE, MAX_PATTERN_LENGTH, MIN_JSON_VALUE_CHARS, MULTI_AGENT_GRAPH_RUN_NAME, ManualSummarizationSkippedError, MemorySaver, ModelEndHandler, MultiAgentGraph, OPENAI_RESPONSES_ACTIVE_REASONING_ID_KEY, OPENAI_RESPONSES_REPLAY_POSITIONS_KEY, ORIGINAL_CONTENT_MAX_CHARS, PREDECESSOR_HANDOFF_CUE, PREEMPT_BOUNDARY_HOOK_TIMEOUT_MS, PRESSURE_THRESHOLD_MASKING, PROVIDER_MESSAGE_PROVENANCE_LIMITS, PROVIDER_MESSAGE_PROVENANCE_VERSION, PROVIDER_TEXT_PROTECTION_VERSION, ProgrammaticToolCallingDefinition, ProgrammaticToolCallingDescription, ProgrammaticToolCallingName, ProgrammaticToolCallingSchema, PromptTemplate, ProviderMessageProjectionInvariantError, ProviderTextProtectionError, Providers, REASONING_LABEL_RUN_NAME, REMOVE_ALL_MESSAGES, REPLY_PRIMER_TOKENS, ReadFileToolDefinition, ReadFileToolDescription, ReadFileToolName, ReadFileToolSchema, Run, Runnable, RunnableCallable, RunnableLambda, RunnableSequence, SDK_STREAM_DISPATCH, STANDARD_GRAPH_RUN_NAME, STATEFUL_BASH_NOTE, STATEFUL_ENV_NOTE, SUBAGENT_CONTEXT_VERSION, SUBAGENT_HOST_ARG_LIMITS, SessionManager, SkillToolDefinition, SkillToolDescription, SkillToolName, SkillToolSchema, StandardGraph, StatefulBashExecutionToolDescription, StatefulCodeExecutionToolDescription, StepTypes, StreamLimitExceededError, StructuredTool, SubagentExecutor, SubagentHostArgumentError, SubagentResolutionError, SubagentToolDefinition, SubagentToolDescription, SubagentToolName, SubagentToolSchema, SystemMessage, TMP_SCRATCH_OUTPUT_REMINDER, TOOL_APPROVAL_EXECUTION_SCOPE_CAPABLE, TOOL_APPROVAL_EXECUTION_SCOPE_CONFIG_KEY, TOOL_INPUT_ELISION_NOTE, TestChatStreamHandler, TestLLMStreamHandler, TitleMethod, TokenEncoderManager, Tool, ToolCallTypes, ToolEndHandler, ToolMessage, ToolNode, ToolSearchToolDefinition, ToolSearchToolDescription, ToolSearchToolName, ToolSearchToolSchema, UnsafeTokenMeasurementError, WebSearchToolDefinition, WebSearchToolDescription, WebSearchToolName, WebSearchToolSchema, _createBashProgramForTests, _resetLocalEngineWarningsForTests, _resetRipgrepCacheForTests, _resetSyntaxCheckProbeCacheForTests, _resetUnrecognizedTriggerWarnings, addBedrockCacheControl, addBedrockTailCacheControl, addCacheControl, addCacheControlToStablePrefixMessages, addCodeApiExecutionProfileHeader, addTailCacheControl, appendCodeSessionFileSummary, appendFailedExecutionFileReminder, appendInstructionlessHandoffCue, appendPredecessorHandoffCue, appendProviderMessageProvenance, appendTmpScratchReminder, applyContextPruning, applyEdit, applyFadingCaps, applyOutcome, applyPreToolUseHooksForBridge, apportionTokenCounts, askUserQuestion, askUserQuestions, attemptInvoke, bashAstFindingsToErrors, booleanQuestion, buildAnthropicCacheControl, buildBashExecutionToolDescription, buildBashExecutionToolSchema, buildBedrockCachePoint, buildChildInputs, buildCodeApiEndpoint, buildCodeApiExecutionErrorMessage, buildCodeApiHttpErrorMessage, buildCodeExecutionToolDescription, buildCodeExecutionToolSchema, buildSandboxRuntimeConfig, buildSubagentHostArgProperties, buildSubagentToolParams, buildSummarizationInstruction, buildSummaryCarrierText, calculateMaxToolCallInputChars, calculateMaxToolResultChars, calculateMaxTotalToolOutputSize, calculateTotalTokens, canSealPreempt, canonicalizeServerName, checkValidNumber, choiceQuestion, clampCalibrationRatio, classifyAttachment, clientExecTimeoutMs, clientFsTimeoutMs, cloneMessage, coalesceAdjacentUserTurns, commandAvailabilityEnvCacheKey, compactSyntheticProviderContextMessage, compareGitHubCommits, composeAbortSignals, composeEventHandlers, computeAdaptivePieceSize, constructorChainHasLcName, convertInjectedMessages, convertMessagesToContent, countNestedGroups, countrySchema, createAgentSession, createBashExecutionTool, createBashProgrammaticToolCallingSchema, createBashProgrammaticToolCallingTool, createCloudflareBashExecutionTool, createCloudflareBashProgrammaticToolCallingTool, createCloudflareBridgeRuntime, createCloudflareCodeExecutionTool, createCloudflareCodingToolBundle, createCloudflareCodingTools, createCloudflareExecutionTool, createCloudflareExecutionWorld, createCloudflareLocalExecutionConfig, createCloudflareProgrammaticToolCallingTool, createCloudflareWorkspaceFS, createCodeExecutionTool, createCompileCheckTool, createCompileCheckToolDefinition, createContentAggregator, createDecisionModel, createEventActorExecutor, createFadingTier, createFakeStreamingLLM, createGraph, createHandlers, createHttpDecisionModel, createLocalBashExecutionTool, createLocalBashProgrammaticToolCallingTool, createLocalCodeExecutionTool, createLocalCodingToolBundle, createLocalCodingToolDefinitions, createLocalCodingToolRegistry, createLocalCodingTools, createLocalEditFileTool, createLocalFileCheckpointer, createLocalGlobSearchTool, createLocalGrepSearchTool, createLocalListDirectoryTool, createLocalProgrammaticToolCallingTool, createLocalReadFileTool, createLocalWriteFileTool, createMetadataAggregator, createProgrammaticToolCallingSchema, createProgrammaticToolCallingTool, createPruneMessages, createRemoveAllMessage, createRunHandlers, createSchemaOnlyTool, createSchemaOnlyTools, createSearchTool, createStructuredChatDecisionModel, createSubagentToolDefinition, createSystemOneReranker, createTokenCounter, createToolErrorOwnership, createToolPolicyHook, createToolSearch, createTransport, createWebSearchReranker, createWorkspacePolicyHook, dateSchema, decisionPreset, decisionProviderNames, decodeFile, defaultOmitOptions, deriveMessages, deserializeMessage, dispatchesChatModelStream, dropIncompleteToolStreamContent, emptyOutputMessage, encodeFile, encodingForModel, encodingOfTokenCounter, enforceOriginalContentCap, ensureThinkingBlockInMessages, escapeRegexSpecialChars, estimateAnthropicImageTokens, estimateDocumentBlockTokens, estimateImageBlockTokens, estimateOpenAIImageTokens, estimateTimedMediaBlockTokens, execWithClientTimeout, executeCloudflareBash, executeCloudflareCode, executeHooks, executeLocalBash, executeLocalBashWithArgs, executeLocalCode, executeParallelSearches, executeTools, extractErrorMessage, extractImageDimensions, extractMcpServerName, extractTextFromContent, extractToolDiscoveries, extractUsedBashToolNames, extractUsedToolNames, fadingBudgetTokens, fadingRungForBudget, fadingRungForExchangeChars, fadingRungForResultChars, fetchSessionFiles, filterBashToolsByUsage, filterGraphSubagentResult, filterSubagentResult, filterToolsByUsage, findLastIndex, flattenLegacyContent, foldToolBlocksForToollessAgent, formatAgentMessages, formatAnthropicArtifactContent, formatAnthropicMessage, formatArtifactPayload, formatCloudflareOutput, formatCompletedResponse, formatContentStrings, formatFromLangChain, formatLangChainMessages, formatMediaMessage, formatMessage, formatServerListing, formatSkillCatalog, getAssistantTextPhase, getAvailableMcpServers, getBaseToolName, getBufferString, getChatModelClass, getChunkContent, getCloudflareWorkspaceRoot, getCodeBaseURL, getContextOverflowInfo, getConverseOverrideMessage, getDeferredToolsListing, getExecutionWorld, getLocalCwd, getLocalSessionId, getMaxOutputTokensKey, getMessageCreationContentMetadata, getMessageId, getMessagesWithinTokenLimit, getProviderMessageProvenance, getProviderSourceMessageIds, getReadRoots, getSpawn, getSubagentHostArgumentFailureMessage, getSubagentResolutionFailureMessage, getTokenCountForMessage, getWorkspaceFS, getWorkspaceRoots, getWriteRoots, handleServerToolResult, handleToolCallChunks, handleToolCalls, hasBijectiveProviderContentPartMapping, hasNestedQuantifier, hasNestedQuantifiers, hasNonEmptyTextContent, hasToolSearchInCurrentTurn, hasUnsafeStructuredSerialization, imageAttachmentContent, imagesSchema, initializeModel, inspectProviderMessageProjection, inspectProviderMessageProvenance, inspectProviderSourceMessageIds, interrupt, isAIMessage, isAnthropicLike, isAskUserQuestionsInterrupt, isBaseMessage, isBooleanAnswer, isChoiceAnswer, isContextOverflowError, isDangerousPattern, isDecisionObject, isFadingTier, isFromAnyMcpServer, isFromMcpServer, isGoogleLike, isGraphSubagentConfig, isInformativeFadingTier, isIntentLabelProperty, isInterrupted, isLegacyConvertible, isLegacyFadingTier, isLibreChatOpenAIModel, isLikelyContextOverflowError, isOpenAILike, isPresent, isProgrammaticRunnerAutoBound, isProgrammaticRunnerResolvedDirectly, isReasoningContentBlock, isScoreAnswer, isSyntheticProviderContextMessage, isThinkingEnabled, isToolMessage, isZodSchema, joinKeys, labelContentByAgent, locateEdit, makeIsDeferred, makeRequest, mapChatMessagesToStoredMessages, mapStoredMessagesToChatMessages, markTokenCounterCacheCompatible, maskConsumedToolResults, matchesQuery, maxFadingRung, mergeAggregatedHookResults, mergeDecisionSettings, messagesStateReducer, modifyDeltaProperties, newsSchema, nodeExecutionWorld, normalizeBashToolResultsForReplay, normalizeCodeApiRequestError, normalizeSearchResultData, normalizeServerFilter, normalizeSubagentConfigEntries, normalizeSubagentConfigs, normalizeToBashIdentifier, normalizeToPythonIdentifier, outcomeFieldsFromResult, parseBooleanEnv, parseEnvelope, partitionAndMarkAnthropicToolCache, performLocalSearch, preFlightTruncateToolCallInputs, preFlightTruncateToolResults, prepareBashProgrammaticCode, prepareProviderRequest, probeLocalCommandAvailability, projectAgentContextUsage, projectAnthropicArtifactContent, projectArtifactPayload, projectCacheControlledToolOutputsToText, projectComputerCallOutputsToText, projectOpenAIChatToolMessageContent, projectOpenAIResponsesToolMessageContent, projectOpenAIToolMessageContent, projectOpenRouterToolMessageContent, projectSingleTextToolOutputsToText, projectStructuredToolOutputsToText, projectToolCallInputs, projectToolMessagesForProvider, projectToolStreamContentForProvider, querySchema, readAnswer, readDecisionUsage, readIntent, readOutcomeFields, readTokenMetadataProperty, registerProvider, removePredecessorHandoffCue, repairOrphanedToolMessages, resetIfNotEmpty, resolveBedrockPromptCacheTtl, resolveCloudflareSandbox, resolveCodeApiAuthHeaders, resolveContextPruningSettings, resolveFadingCaps, resolveFadingTier, resolveFetchProxyAgent, resolveIntraTurnRetainTokens, resolveLocalExecutionConfig, resolveLocalExecutionTools, resolveLocalImplementationNames, resolveLocalToolRegistry, resolveLocalToolsForBinding, resolvePromptCacheTtl, resolveProviderMessageProjectionInvariantMode, resolveSearchOutcome, resolveServerFilters, resolveStreamDelay, resolveStreamLimits, resolveSubagentConfigEntries, resolveSubagentConfigs, resolveSubagentHostArgs, resolveToolOutcome, resolveWorkspacePath, resolveWorkspacePathSafe, runBashAstChecks, runPlainExecution, runPostEditSyntaxCheck, sanitizeOrphanToolBlocks, sanitizeRegex, scoreQuestion, seedFadingTier, selectRuntimeSessionHint, separateSummarizationParameters, serializeMessage, serializeToolCallInput, setCommandAvailabilityCacheEntry, setFreshProviderMessageProvenance, setInvalidProviderMessageProvenance, setProviderMessageProvenance, shellQuote, shiftIndexTokenCountMap, shouldBypassProxy, shouldTriggerSummarization, sleep, sliceWithoutSplittingSurrogates, smoothStream, spawnLocalProcess, splitAssistantTextContentByPhase, splitAtRecencyBoundary, stampSyntheticProviderMessage, strictAlternationProviders, stripAnthropicCacheControl, stripBedrockCacheControl, stripCodeSessionFileSummary, stripIntent, summarizeEvent, supportsBedrockToolCache, syncBudgetDerivedFields, toJsonSchema, toWireQuestion, tool, toolResultTypes, toolsCondition, truncateLocalOutput, truncateToolInput, truncateToolResultContent, tryFallbackProviders, unescapeObject, unwrapToolResponse, validateBashCommand, validateCloudflareBashCommand, validateDecisionQuestions, videosSchema, withClientTimeout, withInstructionlessHandoffCue, withIntent, withMessageRole, withoutIntent, wrapPythonForPlainExecution };

package/dist/esm/tools/GitHubCompare.mjs

@@ -0,0 +1,175 @@
+import { INTENT_PROPERTY } from "./intentArg.mjs";
+import { DynamicStructuredTool } from "@langchain/core/tools";
+//#region src/tools/GitHubCompare.ts
+const GitHubCompareToolName = "github_compare";
+const GitHubCompareToolDescription = "Read-only GitHub comparison of two full commit SHAs in a public repository. Returns the merge-base, relation and commit counts without Git, a worktree, or worker admission. Does not fetch code or execute commands. Private repositories and arbitrary URLs are not supported.";
+const GitHubCompareToolSchema = {
+	type: "object",
+	properties: {
+		intent: { ...INTENT_PROPERTY },
+		owner: {
+			type: "string",
+			description: "GitHub repository owner."
+		},
+		repo: {
+			type: "string",
+			description: "GitHub repository name."
+		},
+		base: {
+			type: "string",
+			description: "Full lowercase base commit SHA, not a moving branch."
+		},
+		head: {
+			type: "string",
+			description: "Full lowercase head commit SHA, not a moving branch."
+		}
+	},
+	required: [
+		"owner",
+		"repo",
+		"base",
+		"head"
+	]
+};
+const GitHubCompareToolDefinition = {
+	name: GitHubCompareToolName,
+	description: GitHubCompareToolDescription,
+	parameters: GitHubCompareToolSchema
+};
+var GitHubComparisonError = class extends Error {
+	code;
+	status;
+	constructor(code, message, status) {
+		super(message);
+		this.code = code;
+		this.status = status;
+		this.name = "GitHubComparisonError";
+	}
+};
+const SHA = /^[a-f0-9]{40}$/;
+const REPO = /^[A-Za-z0-9][A-Za-z0-9_.-]{0,99}$/;
+const MAX_RESPONSE_BYTES = 2 * 1024 * 1024;
+function awaitWithSignal(operation, signal) {
+	signal.throwIfAborted();
+	return new Promise((resolve, reject) => {
+		const onAbort = () => {
+			signal.removeEventListener("abort", onAbort);
+			reject(signal.reason);
+		};
+		signal.addEventListener("abort", onAbort, { once: true });
+		try {
+			operation().then((value) => {
+				signal.removeEventListener("abort", onAbort);
+				resolve(value);
+			}, (error) => {
+				signal.removeEventListener("abort", onAbort);
+				reject(error);
+			});
+		} catch (error) {
+			signal.removeEventListener("abort", onAbort);
+			reject(error);
+		}
+	});
+}
+function cancelBody(response) {
+	response.body?.cancel().catch(() => void 0);
+}
+async function readResponse(response, signal) {
+	const reader = response.body?.getReader();
+	if (reader == null) throw new GitHubComparisonError("INVALID_RESPONSE", "GitHub comparison returned an invalid response.");
+	const chunks = [];
+	let bytes = 0;
+	try {
+		for (;;) {
+			const item = await awaitWithSignal(() => reader.read(), signal);
+			if (item.done) break;
+			bytes += item.value.byteLength;
+			if (bytes > MAX_RESPONSE_BYTES) throw new GitHubComparisonError("RESPONSE_TOO_LARGE", "GitHub comparison response exceeded its bound.");
+			chunks.push(item.value);
+		}
+		return Buffer.concat(chunks, bytes).toString("utf8");
+	} finally {
+		reader.cancel().catch(() => void 0);
+		reader.releaseLock();
+	}
+}
+function parseComparison(text, input) {
+	let data;
+	try {
+		data = JSON.parse(text);
+	} catch {
+		throw new GitHubComparisonError("INVALID_RESPONSE", "GitHub comparison returned an invalid response.");
+	}
+	const mergeBase = data?.merge_base_commit?.sha;
+	const status = data?.status;
+	const aheadBy = data?.ahead_by;
+	const behindBy = data?.behind_by;
+	const totalCommits = data?.total_commits;
+	if (data?.base_commit?.sha !== input.base || typeof mergeBase !== "string" || !SHA.test(mergeBase) || status !== "ahead" && status !== "behind" && status !== "identical" && status !== "diverged" || typeof aheadBy !== "number" || !Number.isSafeInteger(aheadBy) || aheadBy < 0 || typeof behindBy !== "number" || !Number.isSafeInteger(behindBy) || behindBy < 0 || typeof totalCommits !== "number" || !Number.isSafeInteger(totalCommits) || totalCommits < 0) throw new GitHubComparisonError("INVALID_RESPONSE", "GitHub comparison returned an invalid response.");
+	return {
+		base: input.base,
+		head: input.head,
+		mergeBase,
+		status,
+		aheadBy,
+		behindBy,
+		totalCommits
+	};
+}
+async function compareGitHubCommits(input, options, signal) {
+	signal?.throwIfAborted();
+	if (typeof input.owner !== "string" || !REPO.test(input.owner) || typeof input.repo !== "string" || !REPO.test(input.repo) || typeof input.base !== "string" || !SHA.test(input.base) || typeof input.head !== "string" || !SHA.test(input.head)) throw new GitHubComparisonError("INVALID_INPUT", "Supply a repository and full lowercase commit SHAs.");
+	const timeoutMs = options.timeoutMs ?? 1e4;
+	if (typeof options.fetch !== "function" || !Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 3e4) throw new GitHubComparisonError("INVALID_CONFIGURATION", "Supply a GitHub transport and a timeout between 1 and 30000 ms.");
+	const timeout = new AbortController();
+	const timer = setTimeout(() => timeout.abort(new DOMException("GitHub comparison timed out.", "TimeoutError")), timeoutMs);
+	timer.unref();
+	let pendingResponse;
+	const requestSignal = signal == null ? timeout.signal : AbortSignal.any([signal, timeout.signal]);
+	try {
+		const response = await awaitWithSignal(() => options.fetch(`https://api.github.com/repos/${encodeURIComponent(input.owner)}/${encodeURIComponent(input.repo)}/compare/${input.base}...${input.head}?per_page=1&page=2`, {
+			method: "GET",
+			redirect: "error",
+			credentials: "omit",
+			signal: requestSignal,
+			headers: {
+				Accept: "application/vnd.github+json",
+				"X-GitHub-Api-Version": "2022-11-28"
+			}
+		}).then((response) => {
+			pendingResponse = response;
+			if (requestSignal.aborted) {
+				pendingResponse = void 0;
+				cancelBody(response);
+				requestSignal.throwIfAborted();
+			}
+			return response;
+		}), requestSignal);
+		if (!response.ok) throw new GitHubComparisonError("HTTP_ERROR", `GitHub comparison unavailable (HTTP ${response.status}).`, response.status);
+		pendingResponse = void 0;
+		const text = await readResponse(response, requestSignal);
+		requestSignal.throwIfAborted();
+		return parseComparison(text, input);
+	} catch (error) {
+		requestSignal.throwIfAborted();
+		if (error instanceof GitHubComparisonError) throw error;
+		throw new GitHubComparisonError("TRANSPORT_ERROR", "GitHub comparison transport failed.");
+	} finally {
+		if (pendingResponse != null) cancelBody(pendingResponse);
+		clearTimeout(timer);
+	}
+}
+var GitHubCompareTool = class extends DynamicStructuredTool {
+	constructor(options) {
+		super({
+			name: GitHubCompareToolName,
+			description: GitHubCompareToolDescription,
+			schema: structuredClone(GitHubCompareToolSchema),
+			func: async (input, _manager, config) => JSON.stringify(await compareGitHubCommits(input, options, config?.signal))
+		});
+	}
+};
+//#endregion
+export { GitHubCompareTool, GitHubCompareToolDefinition, GitHubCompareToolDescription, GitHubCompareToolName, GitHubCompareToolSchema, GitHubComparisonError, compareGitHubCommits };
+
+//# sourceMappingURL=GitHubCompare.mjs.map

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

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

package/dist/types/index.d.ts

@@ -7,6 +7,7 @@ export * from './graphs';
 export * from './agents/projection';
 export * from './summarization';
 export * from './tools/Calculator';
+export * from './tools/GitHubCompare';
 export * from './tools/CodeExecutor';
 export * from './tools/BashExecutor';
 export * from './tools/ProgrammaticToolCalling';

package/dist/types/tools/GitHubCompare.d.ts

@@ -0,0 +1,104 @@
+import { DynamicStructuredTool } from '@langchain/core/tools';
+export declare const GitHubCompareToolName = "github_compare";
+export declare const GitHubCompareToolDescription = "Read-only GitHub comparison of two full commit SHAs in a public repository. Returns the merge-base, relation and commit counts without Git, a worktree, or worker admission. Does not fetch code or execute commands. Private repositories and arbitrary URLs are not supported.";
+export declare const GitHubCompareToolSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly intent: {
+            readonly type: "string" | "number" | "integer" | "float" | "boolean" | "array" | "object";
+            readonly enum?: string[];
+            readonly items?: import("..").JsonSchemaType;
+            readonly properties?: Record<string, import("..").JsonSchemaType>;
+            readonly required?: string[];
+            readonly description?: string;
+            readonly pattern?: string;
+            readonly maxLength?: number;
+            readonly additionalProperties?: boolean | import("..").JsonSchemaType;
+        };
+        readonly owner: {
+            readonly type: "string";
+            readonly description: "GitHub repository owner.";
+        };
+        readonly repo: {
+            readonly type: "string";
+            readonly description: "GitHub repository name.";
+        };
+        readonly base: {
+            readonly type: "string";
+            readonly description: "Full lowercase base commit SHA, not a moving branch.";
+        };
+        readonly head: {
+            readonly type: "string";
+            readonly description: "Full lowercase head commit SHA, not a moving branch.";
+        };
+    };
+    readonly required: readonly ["owner", "repo", "base", "head"];
+};
+export declare const GitHubCompareToolDefinition: {
+    readonly name: "github_compare";
+    readonly description: "Read-only GitHub comparison of two full commit SHAs in a public repository. Returns the merge-base, relation and commit counts without Git, a worktree, or worker admission. Does not fetch code or execute commands. Private repositories and arbitrary URLs are not supported.";
+    readonly parameters: {
+        readonly type: "object";
+        readonly properties: {
+            readonly intent: {
+                readonly type: "string" | "number" | "integer" | "float" | "boolean" | "array" | "object";
+                readonly enum?: string[];
+                readonly items?: import("..").JsonSchemaType;
+                readonly properties?: Record<string, import("..").JsonSchemaType>;
+                readonly required?: string[];
+                readonly description?: string;
+                readonly pattern?: string;
+                readonly maxLength?: number;
+                readonly additionalProperties?: boolean | import("..").JsonSchemaType;
+            };
+            readonly owner: {
+                readonly type: "string";
+                readonly description: "GitHub repository owner.";
+            };
+            readonly repo: {
+                readonly type: "string";
+                readonly description: "GitHub repository name.";
+            };
+            readonly base: {
+                readonly type: "string";
+                readonly description: "Full lowercase base commit SHA, not a moving branch.";
+            };
+            readonly head: {
+                readonly type: "string";
+                readonly description: "Full lowercase head commit SHA, not a moving branch.";
+            };
+        };
+        readonly required: readonly ["owner", "repo", "base", "head"];
+    };
+};
+export interface GitHubComparisonInput {
+    owner: string;
+    repo: string;
+    base: string;
+    head: string;
+}
+export interface GitHubComparison {
+    base: string;
+    head: string;
+    mergeBase: string;
+    status: 'ahead' | 'behind' | 'identical' | 'diverged';
+    aheadBy: number;
+    behindBy: number;
+    totalCommits: number;
+}
+export interface GitHubCompareOptions {
+    /** Caller-owned transport, including proxy and instrumentation policy. */
+    fetch: typeof fetch;
+    /** Entire request budget, including body reads. Defaults to 10 seconds; maximum 30 seconds. */
+    timeoutMs?: number;
+}
+export type GitHubComparisonErrorCode = 'INVALID_INPUT' | 'INVALID_CONFIGURATION' | 'HTTP_ERROR' | 'INVALID_RESPONSE' | 'RESPONSE_TOO_LARGE' | 'TRANSPORT_ERROR';
+export declare class GitHubComparisonError extends Error {
+    readonly code: GitHubComparisonErrorCode;
+    readonly status?: number | undefined;
+    constructor(code: GitHubComparisonErrorCode, message: string, status?: number | undefined);
+}
+export declare function compareGitHubCommits(input: GitHubComparisonInput, options: GitHubCompareOptions, signal?: AbortSignal): Promise<GitHubComparison>;
+export declare class GitHubCompareTool extends DynamicStructuredTool {
+    constructor(options: GitHubCompareOptions);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@librechat/agents",
-  "version": "4.0.3",
+  "version": "4.0.4",
   "reova": {
     "enabled": true,
     "endpoint": "https://telemetry.reo.dev/data"

package/src/index.ts

@@ -16,6 +16,7 @@ export * from './summarization';
 
 /* Tools */
 export * from './tools/Calculator';
+export * from './tools/GitHubCompare';
 export * from './tools/CodeExecutor';
 export * from './tools/BashExecutor';
 export * from './tools/ProgrammaticToolCalling';

package/src/tools/GitHubCompare.ts

@@ -0,0 +1,319 @@
+import { DynamicStructuredTool } from '@langchain/core/tools';
+import { INTENT_PROPERTY } from '@/tools/intentArg';
+
+export const GitHubCompareToolName = 'github_compare';
+export const GitHubCompareToolDescription =
+  'Read-only GitHub comparison of two full commit SHAs in a public repository. Returns the merge-base, relation and commit counts without Git, a worktree, or worker admission. Does not fetch code or execute commands. Private repositories and arbitrary URLs are not supported.';
+export const GitHubCompareToolSchema = {
+  type: 'object',
+  properties: {
+    intent: { ...INTENT_PROPERTY },
+    owner: { type: 'string', description: 'GitHub repository owner.' },
+    repo: { type: 'string', description: 'GitHub repository name.' },
+    base: {
+      type: 'string',
+      description: 'Full lowercase base commit SHA, not a moving branch.',
+    },
+    head: {
+      type: 'string',
+      description: 'Full lowercase head commit SHA, not a moving branch.',
+    },
+  },
+  required: ['owner', 'repo', 'base', 'head'],
+} as const;
+export const GitHubCompareToolDefinition = {
+  name: GitHubCompareToolName,
+  description: GitHubCompareToolDescription,
+  parameters: GitHubCompareToolSchema,
+} as const;
+
+export interface GitHubComparisonInput {
+  owner: string;
+  repo: string;
+  base: string;
+  head: string;
+}
+
+export interface GitHubComparison {
+  base: string;
+  head: string;
+  mergeBase: string;
+  status: 'ahead' | 'behind' | 'identical' | 'diverged';
+  aheadBy: number;
+  behindBy: number;
+  totalCommits: number;
+}
+
+export interface GitHubCompareOptions {
+  /** Caller-owned transport, including proxy and instrumentation policy. */
+  fetch: typeof fetch;
+  /** Entire request budget, including body reads. Defaults to 10 seconds; maximum 30 seconds. */
+  timeoutMs?: number;
+}
+
+export type GitHubComparisonErrorCode =
+  | 'INVALID_INPUT'
+  | 'INVALID_CONFIGURATION'
+  | 'HTTP_ERROR'
+  | 'INVALID_RESPONSE'
+  | 'RESPONSE_TOO_LARGE'
+  | 'TRANSPORT_ERROR';
+
+export class GitHubComparisonError extends Error {
+  constructor(
+    public readonly code: GitHubComparisonErrorCode,
+    message: string,
+    public readonly status?: number
+  ) {
+    super(message);
+    this.name = 'GitHubComparisonError';
+  }
+}
+
+interface GitHubComparisonResponse {
+  base_commit?: { sha?: string };
+  merge_base_commit?: { sha?: string };
+  status?: GitHubComparison['status'];
+  ahead_by?: number;
+  behind_by?: number;
+  total_commits?: number;
+}
+
+const SHA = /^[a-f0-9]{40}$/;
+const REPO = /^[A-Za-z0-9][A-Za-z0-9_.-]{0,99}$/;
+const MAX_RESPONSE_BYTES = 2 * 1024 * 1024;
+
+function awaitWithSignal<T>(
+  operation: () => Promise<T>,
+  signal: AbortSignal
+): Promise<T> {
+  signal.throwIfAborted();
+  return new Promise<T>((resolve, reject) => {
+    const onAbort = (): void => {
+      signal.removeEventListener('abort', onAbort);
+      reject(signal.reason);
+    };
+    signal.addEventListener('abort', onAbort, { once: true });
+    try {
+      operation().then(
+        (value) => {
+          signal.removeEventListener('abort', onAbort);
+          resolve(value);
+        },
+        (error) => {
+          signal.removeEventListener('abort', onAbort);
+          reject(error);
+        }
+      );
+    } catch (error) {
+      signal.removeEventListener('abort', onAbort);
+      reject(error);
+    }
+  });
+}
+
+function cancelBody(response: Response): void {
+  void response.body?.cancel().catch(() => undefined);
+}
+
+async function readResponse(
+  response: Response,
+  signal: AbortSignal
+): Promise<string> {
+  const reader = response.body?.getReader();
+  if (reader == null) {
+    throw new GitHubComparisonError(
+      'INVALID_RESPONSE',
+      'GitHub comparison returned an invalid response.'
+    );
+  }
+  const chunks: Uint8Array[] = [];
+  let bytes = 0;
+  try {
+    for (;;) {
+      const item = await awaitWithSignal(() => reader.read(), signal);
+      if (item.done) {
+        break;
+      }
+      bytes += item.value.byteLength;
+      if (bytes > MAX_RESPONSE_BYTES) {
+        throw new GitHubComparisonError(
+          'RESPONSE_TOO_LARGE',
+          'GitHub comparison response exceeded its bound.'
+        );
+      }
+      chunks.push(item.value);
+    }
+    return Buffer.concat(chunks, bytes).toString('utf8');
+  } finally {
+    void reader.cancel().catch(() => undefined);
+    reader.releaseLock();
+  }
+}
+
+function parseComparison(
+  text: string,
+  input: GitHubComparisonInput
+): GitHubComparison {
+  let data: GitHubComparisonResponse | null;
+  try {
+    data = JSON.parse(text) as GitHubComparisonResponse | null;
+  } catch {
+    throw new GitHubComparisonError(
+      'INVALID_RESPONSE',
+      'GitHub comparison returned an invalid response.'
+    );
+  }
+  const mergeBase = data?.merge_base_commit?.sha;
+  const status = data?.status;
+  const aheadBy = data?.ahead_by;
+  const behindBy = data?.behind_by;
+  const totalCommits = data?.total_commits;
+  if (
+    data?.base_commit?.sha !== input.base ||
+    typeof mergeBase !== 'string' ||
+    !SHA.test(mergeBase) ||
+    (status !== 'ahead' &&
+      status !== 'behind' &&
+      status !== 'identical' &&
+      status !== 'diverged') ||
+    typeof aheadBy !== 'number' ||
+    !Number.isSafeInteger(aheadBy) ||
+    aheadBy < 0 ||
+    typeof behindBy !== 'number' ||
+    !Number.isSafeInteger(behindBy) ||
+    behindBy < 0 ||
+    typeof totalCommits !== 'number' ||
+    !Number.isSafeInteger(totalCommits) ||
+    totalCommits < 0
+  ) {
+    throw new GitHubComparisonError(
+      'INVALID_RESPONSE',
+      'GitHub comparison returned an invalid response.'
+    );
+  }
+  return {
+    base: input.base,
+    head: input.head,
+    mergeBase,
+    status,
+    aheadBy,
+    behindBy,
+    totalCommits,
+  };
+}
+
+export async function compareGitHubCommits(
+  input: GitHubComparisonInput,
+  options: GitHubCompareOptions,
+  signal?: AbortSignal
+): Promise<GitHubComparison> {
+  signal?.throwIfAborted();
+  if (
+    typeof input.owner !== 'string' ||
+    !REPO.test(input.owner) ||
+    typeof input.repo !== 'string' ||
+    !REPO.test(input.repo) ||
+    typeof input.base !== 'string' ||
+    !SHA.test(input.base) ||
+    typeof input.head !== 'string' ||
+    !SHA.test(input.head)
+  ) {
+    throw new GitHubComparisonError(
+      'INVALID_INPUT',
+      'Supply a repository and full lowercase commit SHAs.'
+    );
+  }
+  const timeoutMs = options.timeoutMs ?? 10000;
+  if (
+    typeof options.fetch !== 'function' ||
+    !Number.isSafeInteger(timeoutMs) ||
+    timeoutMs < 1 ||
+    timeoutMs > 30000
+  ) {
+    throw new GitHubComparisonError(
+      'INVALID_CONFIGURATION',
+      'Supply a GitHub transport and a timeout between 1 and 30000 ms.'
+    );
+  }
+  const timeout = new AbortController();
+  const timer = setTimeout(
+    () =>
+      timeout.abort(
+        new DOMException('GitHub comparison timed out.', 'TimeoutError')
+      ),
+    timeoutMs
+  );
+  timer.unref();
+  let pendingResponse: Response | undefined;
+  const requestSignal =
+    signal == null ? timeout.signal : AbortSignal.any([signal, timeout.signal]);
+  try {
+    const response = await awaitWithSignal(
+      () =>
+        options
+          .fetch(
+            `https://api.github.com/repos/${encodeURIComponent(input.owner)}/${encodeURIComponent(input.repo)}/compare/${input.base}...${input.head}?per_page=1&page=2`,
+            {
+              method: 'GET',
+              redirect: 'error',
+              credentials: 'omit',
+              signal: requestSignal,
+              headers: {
+                Accept: 'application/vnd.github+json',
+                'X-GitHub-Api-Version': '2022-11-28',
+              },
+            }
+          )
+          .then((response) => {
+            pendingResponse = response;
+            if (requestSignal.aborted) {
+              pendingResponse = undefined;
+              cancelBody(response);
+              requestSignal.throwIfAborted();
+            }
+            return response;
+          }),
+      requestSignal
+    );
+    if (!response.ok) {
+      throw new GitHubComparisonError(
+        'HTTP_ERROR',
+        `GitHub comparison unavailable (HTTP ${response.status}).`,
+        response.status
+      );
+    }
+    pendingResponse = undefined;
+    const text = await readResponse(response, requestSignal);
+    requestSignal.throwIfAborted();
+    return parseComparison(text, input);
+  } catch (error) {
+    requestSignal.throwIfAborted();
+    if (error instanceof GitHubComparisonError) {
+      throw error;
+    }
+    throw new GitHubComparisonError(
+      'TRANSPORT_ERROR',
+      'GitHub comparison transport failed.'
+    );
+  } finally {
+    if (pendingResponse != null) {
+      cancelBody(pendingResponse);
+    }
+    clearTimeout(timer);
+  }
+}
+
+export class GitHubCompareTool extends DynamicStructuredTool {
+  constructor(options: GitHubCompareOptions) {
+    super({
+      name: GitHubCompareToolName,
+      description: GitHubCompareToolDescription,
+      schema: structuredClone(GitHubCompareToolSchema),
+      func: async (input: GitHubComparisonInput, _manager, config) =>
+        JSON.stringify(
+          await compareGitHubCommits(input, options, config?.signal)
+        ),
+    });
+  }
+}