/** * Enum representing the various event types emitted during the execution of runnables. * These events provide real-time information about the progress and state of different components. * * @enum {string} */ export declare enum GraphEvents { /** [Custom] Agent update event in multi-agent graph/workflow */ ON_AGENT_UPDATE = "on_agent_update", /** [Custom] Subagent lifecycle event (start, run_step, message_delta, stop, error) */ ON_SUBAGENT_UPDATE = "on_subagent_update", /** [Custom] Delta event for run steps (message creation and tool calls) */ ON_RUN_STEP = "on_run_step", /** [Custom] Delta event for run steps (tool calls) */ ON_RUN_STEP_DELTA = "on_run_step_delta", /** [Custom] Completed event for run steps (tool calls) */ ON_RUN_STEP_COMPLETED = "on_run_step_completed", /** [Custom] Delta events for messages */ ON_MESSAGE_DELTA = "on_message_delta", /** [Custom] Reasoning Delta events for messages */ ON_REASONING_DELTA = "on_reasoning_delta", /** [Custom] Context analytics event for traces */ ON_CONTEXT_ANALYTICS = "on_context_analytics", /** [Custom] Structured output event - emitted when agent returns structured JSON */ ON_STRUCTURED_OUTPUT = "on_structured_output", /** [Custom] Request to execute tools - dispatched by ToolNode, handled by host */ ON_TOOL_EXECUTE = "on_tool_execute", /** [Custom] Context pressure event for monitoring compaction triggers */ ON_CONTEXT_PRESSURE = "on_context_pressure", /** [Custom] Tool requires human approval before execution - dispatched by ToolNode HITL */ ON_TOOL_APPROVAL_REQUIRED = "on_tool_approval_required", /** [Custom] Agent transition event — dispatched when control passes between agents */ ON_AGENT_TRANSITION = "on_agent_transition", /** [Custom] Approval gate interrupt — dispatched by ApprovalGateNode before interrupt() */ ON_APPROVAL_GATE = "on_approval_gate", /** Custom event, emitted by system */ ON_CUSTOM_EVENT = "on_custom_event", /** Emitted when a chat model starts processing. */ CHAT_MODEL_START = "on_chat_model_start", /** Emitted when a chat model streams a chunk of its response. */ CHAT_MODEL_STREAM = "on_chat_model_stream", /** Emitted when a chat model completes its processing. */ CHAT_MODEL_END = "on_chat_model_end", /** Emitted when a language model starts processing. */ LLM_START = "on_llm_start", /** Emitted when a language model streams a chunk of its response. */ LLM_STREAM = "on_llm_stream", /** Emitted when a language model completes its processing. */ LLM_END = "on_llm_end", /** Emitted when a chain starts processing. */ CHAIN_START = "on_chain_start", /** Emitted when a chain streams a chunk of its output. */ CHAIN_STREAM = "on_chain_stream", /** Emitted when a chain completes its processing. */ CHAIN_END = "on_chain_end", /** Emitted when a tool starts its operation. */ TOOL_START = "on_tool_start", /** Emitted when a tool completes its operation. */ TOOL_END = "on_tool_end", /** Emitted when a retriever starts its operation. */ RETRIEVER_START = "on_retriever_start", /** Emitted when a retriever completes its operation. */ RETRIEVER_END = "on_retriever_end", /** Emitted when a prompt starts processing. */ PROMPT_START = "on_prompt_start", /** Emitted when a prompt completes its processing. */ PROMPT_END = "on_prompt_end" } export declare enum Providers { OPENAI = "openAI", VERTEXAI = "vertexai", BEDROCK = "bedrock", ANTHROPIC = "anthropic", MISTRALAI = "mistralai", MISTRAL = "mistral", GOOGLE = "google", AZURE = "azureOpenAI", DEEPSEEK = "deepseek", OPENROUTER = "openrouter", XAI = "xai", MOONSHOT = "moonshot" } export declare enum EdgeType { /** * Upstream-aligned handoff: one-way routing where the parent agent exits * via a `lc_transfer_to_` tool call, the child takes over, * and the child responds directly to the user. Replaces what used to be * called "TRANSFER" in earlier Ranger versions; the parent-calls-child * supervisor pattern (formerly `EdgeType.HANDOFF`) is gone — use the * Subagent primitive (Tier 5) for deep delegation instead. */ HANDOFF = "handoff", /** * Fixed graph edges for automatic transitions. Naming matches upstream. * Ranger keeps its enriched wiring on top of this edge type: * fan-in with prompt + {results}, parallel groups, ApprovalGateNode * insertion, and the `excludeResults` agentMessages channel. */ DIRECT = "direct" } export declare enum GraphNodeKeys { TOOLS = "tools=", AGENT = "agent=", ROUTER = "router", PRE_TOOLS = "pre_tools", POST_TOOLS = "post_tools" } export declare enum GraphNodeActions { TOOL_NODE = "tool_node", CALL_MODEL = "call_model", ROUTE_MESSAGE = "route_message" } export declare enum CommonEvents { LANGGRAPH = "LangGraph" } export declare enum StepTypes { TOOL_CALLS = "tool_calls", MESSAGE_CREATION = "message_creation" } export declare enum ContentTypes { TEXT = "text", ERROR = "error", THINK = "think", TOOL_CALL = "tool_call", IMAGE_URL = "image_url", IMAGE_FILE = "image_file", /** Anthropic */ THINKING = "thinking", /** Vertex AI / Google Common */ REASONING = "reasoning", /** Multi-Agent Switch */ AGENT_UPDATE = "agent_update", /** Bedrock */ REASONING_CONTENT = "reasoning_content" } export declare enum ToolCallTypes { FUNCTION = "function", RETRIEVAL = "retrieval", FILE_SEARCH = "file_search", CODE_INTERPRETER = "code_interpreter", TOOL_CALL = "tool_call" } export declare enum Callback { TOOL_ERROR = "handleToolError", TOOL_START = "handleToolStart", TOOL_END = "handleToolEnd", CUSTOM_EVENT = "handleCustomEvent" } export declare enum Constants { OFFICIAL_CODE_BASEURL = "https://api.illuma.ai/v1", EXECUTE_CODE = "execute_code", /** Tool name for the bash execution primitive (upstream Tier 3). */ BASH_TOOL = "execute_bash", /** Tool name for the bash programmatic-tool-calling variant (upstream Tier 3). */ BASH_PROGRAMMATIC_TOOL_CALLING = "run_tools_with_bash", /** Tool name for the read-file primitive (upstream Tier 3). */ READ_FILE = "read_file", /** Tool name for the SkillTool primitive (upstream Tier 2). */ SKILL_TOOL = "skill", /** Tool name for the Subagent primitive (upstream Tier 5). */ SUBAGENT = "subagent", TOOL_SEARCH = "tool_search", PROGRAMMATIC_TOOL_CALLING = "run_tools_with_code", WEB_SEARCH = "web_search", CONTENT_AND_ARTIFACT = "content_and_artifact", /** Prefix for handoff tool names (parent-exits routing): lc_transfer_to_{agentId}. */ LC_TRANSFER_TO_ = "lc_transfer_to_", /** Tool name for the AskUser structured question tool */ ASK_USER = "ask_user", /** Delimiter for MCP tools: toolName_mcp_serverName */ MCP_DELIMITER = "_mcp_", /** Prefix for Anthropic-hosted server tool ids (web_search, code_execution). * These are issued by Anthropic, not by us, and should be ignored by * orphan-repair sweeps that don't have ground truth for them. */ ANTHROPIC_SERVER_TOOL_PREFIX = "srvtoolu_" } export declare enum TitleMethod { STRUCTURED = "structured", FUNCTIONS = "functions", COMPLETION = "completion" } export declare enum EnvVar { CODE_API_KEY = "CODE_EXECUTOR_API_KEY", CODE_BASEURL = "CODE_EXECUTOR_BASEURL" } /** * Normalized LLM finish/stop reasons across providers. * Used by toolCallContinuation to detect max_tokens truncation. */ export declare enum FinishReasons { /** Anthropic / Bedrock stop reason for token limit */ MAX_TOKENS = "max_tokens", /** OpenAI / Azure finish reason for token limit */ LENGTH = "length", /** Normal completion */ STOP = "stop", /** Anthropic / Bedrock stop reason for normal completion */ END_TURN = "end_turn", /** Model chose to call tools */ TOOL_USE = "tool_use", /** OpenAI finish reason for tool calls */ TOOL_CALLS = "tool_calls" } /** * Message type identifiers used by LangChain's BaseMessage.getType(). * Use these constants instead of instanceof checks to avoid module mismatch issues * when different copies of @langchain/core/messages are loaded. */ export declare enum MessageTypes { HUMAN = "human", AI = "ai", SYSTEM = "system", TOOL = "tool", FUNCTION = "function", GENERIC = "generic", DEVELOPER = "developer", REMOVE = "remove" } /** * Tool names that use the code execution environment (shared session, file * tracking). Used by ToolNode to inject session context + file refs into * `invokeParams` before tool execution. Upstream-aligned constant. */ export declare const CODE_EXECUTION_TOOLS: ReadonlySet;