001/*
002 *  Copyright (c) 2023-2026, Agents-Flex (fuhai999@gmail.com).
003 *  <p>
004 *  Licensed under the Apache License, Version 2.0 (the "License");
005 *  you may not use this file except in compliance with the License.
006 *  You may obtain a copy of the License at
007 *  <p>
008 *  http://www.apache.org/licenses/LICENSE-2.0
009 *  <p>
010 *  Unless required by applicable law or agreed to in writing, software
011 *  distributed under the License is distributed on an "AS IS" BASIS,
012 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013 *  See the License for the specific language governing permissions and
014 *  limitations under the License.
015 */
016package com.agentsflex.core.model.chat.tool;
017
018/**
019 * 函数调用拦截器，用于在函数执行前后插入横切逻辑（如日志、监控、权限等）。
020 * <p>
021 * 通过责任链模式组合多个拦截器，最终由链尾执行实际函数调用。
022 */
023public interface ToolInterceptor {
024
025    /**
026     * 拦截函数调用。
027     *
028     * @param context 函数调用上下文
029     * @param chain   责任链的下一个节点
030     * @return 函数调用结果
031     * @throws Exception 通常由实际函数或拦截器抛出
032     */
033    Object intercept(ToolContext context, ToolChain chain) throws Exception;
034}