4c57d201a4
The source headers, LICENSE files, and license metadata had drifted apart. Align the entire project to MIT: - Convert every source-file header to the MIT text across all comment styles (Go, TS, TSX, JS, MJS, SQL, CSS, GraphQL, shell), including SPDX-License-Identifier tags - Set the root and cookie-banner LICENSE files to the MIT text with a "MIT License" title line - Switch the package.json license fields, Docker image label, and cookie-banner README to MIT - Update docs and the genmodels header generator accordingly - Normalize copyright lines to a single format (Copyright (c) <year(s)> Probo Inc <hello@probo.com>.): unify the hello@getprobo.com and hello@probo.inc emails to hello@probo.com and the comma-separated years to a hyphenated range Genuine third-party references are intentionally left untouched: the Lucide icon attributions (Lucide is ISC) and the trivy dependency license allowlist. Signed-off-by: Sacha Al Himdani <sacha@probo.com>
83 lines
4.4 KiB
Go
83 lines
4.4 KiB
Go
// Copyright (c) 2026 Probo Inc <hello@probo.com>.
|
|
//
|
|
// Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
// of this software and associated documentation files (the "Software"), to deal
|
|
// in the Software without restriction, including without limitation the rights
|
|
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
// copies of the Software, and to permit persons to whom the Software is
|
|
// furnished to do so, subject to the following conditions:
|
|
//
|
|
// The above copyright notice and this permission notice shall be included in
|
|
// all copies or substantial portions of the Software.
|
|
//
|
|
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
// SOFTWARE.
|
|
|
|
package agent
|
|
|
|
import (
|
|
"context"
|
|
|
|
"go.probo.inc/probo/pkg/llm"
|
|
)
|
|
|
|
// RunHooks receives callbacks on lifecycle events for the entire agent run.
|
|
type RunHooks interface {
|
|
OnRunStart(ctx context.Context, agent *Agent, messages []llm.Message)
|
|
OnRunEnd(ctx context.Context, agent *Agent, result *Result, err error)
|
|
OnRunRestore(ctx context.Context, agent *Agent, checkpoint *Checkpoint)
|
|
OnRunSnapshot(ctx context.Context, agent *Agent, checkpoint *Checkpoint)
|
|
OnLLMStart(ctx context.Context, agent *Agent, messages []llm.Message)
|
|
OnLLMEnd(ctx context.Context, agent *Agent, response *llm.ChatCompletionResponse, err error)
|
|
OnToolStart(ctx context.Context, agent *Agent, tool Tool, arguments string)
|
|
OnToolEnd(ctx context.Context, agent *Agent, tool Tool, result ToolResult, err error)
|
|
OnHandoff(ctx context.Context, from *Agent, to *Agent)
|
|
OnGuardrailTripped(ctx context.Context, agent *Agent, name string, result *GuardrailResult)
|
|
}
|
|
|
|
// NoOpHooks is a RunHooks implementation that does nothing.
|
|
type NoOpHooks struct{}
|
|
|
|
var _ RunHooks = NoOpHooks{}
|
|
|
|
func (NoOpHooks) OnRunStart(context.Context, *Agent, []llm.Message) {}
|
|
func (NoOpHooks) OnRunEnd(context.Context, *Agent, *Result, error) {}
|
|
func (NoOpHooks) OnRunRestore(context.Context, *Agent, *Checkpoint) {}
|
|
func (NoOpHooks) OnRunSnapshot(context.Context, *Agent, *Checkpoint) {}
|
|
func (NoOpHooks) OnLLMStart(context.Context, *Agent, []llm.Message) {}
|
|
func (NoOpHooks) OnLLMEnd(context.Context, *Agent, *llm.ChatCompletionResponse, error) {}
|
|
func (NoOpHooks) OnToolStart(context.Context, *Agent, Tool, string) {}
|
|
func (NoOpHooks) OnToolEnd(context.Context, *Agent, Tool, ToolResult, error) {}
|
|
func (NoOpHooks) OnHandoff(context.Context, *Agent, *Agent) {}
|
|
func (NoOpHooks) OnGuardrailTripped(context.Context, *Agent, string, *GuardrailResult) {}
|
|
|
|
// AgentHooks receives callbacks on lifecycle events for a specific agent.
|
|
// Set via WithAgentHooks on an individual agent.
|
|
type AgentHooks interface {
|
|
OnStart(ctx context.Context, agent *Agent)
|
|
OnEnd(ctx context.Context, agent *Agent, output string)
|
|
OnHandoff(ctx context.Context, agent *Agent, source *Agent)
|
|
OnToolStart(ctx context.Context, agent *Agent, tool Tool)
|
|
OnToolEnd(ctx context.Context, agent *Agent, tool Tool, result ToolResult)
|
|
OnLLMStart(ctx context.Context, agent *Agent, messages []llm.Message)
|
|
OnLLMEnd(ctx context.Context, agent *Agent, response *llm.ChatCompletionResponse, err error)
|
|
}
|
|
|
|
// NoOpAgentHooks is an AgentHooks implementation that does nothing.
|
|
type NoOpAgentHooks struct{}
|
|
|
|
var _ AgentHooks = NoOpAgentHooks{}
|
|
|
|
func (NoOpAgentHooks) OnStart(context.Context, *Agent) {}
|
|
func (NoOpAgentHooks) OnEnd(context.Context, *Agent, string) {}
|
|
func (NoOpAgentHooks) OnHandoff(context.Context, *Agent, *Agent) {}
|
|
func (NoOpAgentHooks) OnToolStart(context.Context, *Agent, Tool) {}
|
|
func (NoOpAgentHooks) OnToolEnd(context.Context, *Agent, Tool, ToolResult) {}
|
|
func (NoOpAgentHooks) OnLLMStart(context.Context, *Agent, []llm.Message) {}
|
|
func (NoOpAgentHooks) OnLLMEnd(context.Context, *Agent, *llm.ChatCompletionResponse, error) {}
|