Documentation
¶
Index ¶
- Constants
- Variables
- func AdaptFunctionFallbackEvents(ctx context.Context, events <-chan ir.Event, ...) <-chan ir.Event
- func AdaptNamespacedFunctionEvents(ctx context.Context, events <-chan ir.Event, ...) <-chan ir.Event
- func AssertStreamingToolCallInvariant(events []ir.Event) error
- func AssertToolsInvariant(tools []any) error
- func BuildChatFunctionName(namespace, name string) string
- func DropEmptyTextBlocks(blocks []ir.ContentBlock) []ir.ContentBlock
- func EncodeReasoningBlock(reasoning *ir.ReasoningContent, targetProtocol string) json.RawMessage
- func FilterOptionalRequestFields(request *ir.Request, permissions RequestFieldPermissions)
- func FunctionFallbackTools(request *ir.Request) map[string]FunctionFallbackTool
- func NamespacedFunctionBindings(request *ir.Request) map[string]NamespacedFunctionBinding
- func NormalizeAssistantToolCallSequence(messages []ir.Message) []ir.Message
- func PrepareNamespacedFunctionsForChat(request *ir.Request) (*ir.Request, error)
- func RecordDroppedTools(request *ir.Request, dropped []DroppedTool)
- func RecordFunctionFallbackTools(request *ir.Request, tools []FunctionFallbackTool)
- type BuiltinToolFallbackPolicy
- type DroppedTool
- type FunctionFallbackTool
- type NamespacedFunctionBinding
- type Options
- type RequestFieldPermissions
- type ResolvedTool
- type TargetEmitFuncs
Constants ¶
View Source
const ( ReasoningProtocolClaude = "claude" ReasoningProtocolResponses = "responses" ReasoningProtocolOpenAIChat = "openai_chat" )
View Source
const ( DroppedToolReasonCrossProtocolIncompatible = "cross_protocol_incompatible" DroppedToolReasonFunctionFallbackUnsupported = "function_fallback_unsupported" )
Variables ¶
View Source
var ( ErrNamespacedFunctionMissingNamespace = errors.New("codec: namespaced function has empty namespace") ErrNamespacedFunctionMissingName = errors.New("codec: namespaced function has empty name") ErrNamespacedFunctionNotFunction = errors.New("codec: namespaced tool is not a function") ErrNamespacedFunctionNameCollision = errors.New("codec: namespaced function Chat name collision") )
View Source
var ( ErrFunctionToolMissingName = errors.New("codec: function tool has empty name") ErrBuiltinToolUnsupported = errors.New("codec: built-in tool not supported by target protocol") )
Functions ¶
func AssertToolsInvariant ¶
func BuildChatFunctionName ¶
func DropEmptyTextBlocks ¶
func DropEmptyTextBlocks(blocks []ir.ContentBlock) []ir.ContentBlock
func EncodeReasoningBlock ¶ added in v0.0.19
func EncodeReasoningBlock(reasoning *ir.ReasoningContent, targetProtocol string) json.RawMessage
EncodeReasoningBlock projects protocol-neutral reasoning into a complete Claude thinking block, Responses reasoning item, or OpenAI Chat reasoning_content representation. Unknown source fields are preserved, while structured fields remain authoritative.
func FilterOptionalRequestFields ¶
func FilterOptionalRequestFields(request *ir.Request, permissions RequestFieldPermissions)
func FunctionFallbackTools ¶
func FunctionFallbackTools(request *ir.Request) map[string]FunctionFallbackTool
func NamespacedFunctionBindings ¶
func NamespacedFunctionBindings(request *ir.Request) map[string]NamespacedFunctionBinding
func NormalizeAssistantToolCallSequence ¶
NormalizeAssistantToolCallSequence moves matching tool responses next to their assistant tool calls and absorbs interleaved assistant preamble text. It returns a new slice and does not mutate the input messages.
func RecordDroppedTools ¶
func RecordDroppedTools(request *ir.Request, dropped []DroppedTool)
func RecordFunctionFallbackTools ¶
func RecordFunctionFallbackTools(request *ir.Request, tools []FunctionFallbackTool)
Types ¶
type BuiltinToolFallbackPolicy ¶
type BuiltinToolFallbackPolicy string
const ( BuiltinToolFallbackDrop BuiltinToolFallbackPolicy = "drop" BuiltinToolFallbackError BuiltinToolFallbackPolicy = "error" BuiltinToolFallbackPassthrough BuiltinToolFallbackPolicy = "passthrough" BuiltinToolFallbackFunction BuiltinToolFallbackPolicy = "function" )
func NormalizeBuiltinToolFallback ¶
func NormalizeBuiltinToolFallback(value string) BuiltinToolFallbackPolicy
type DroppedTool ¶
type DroppedTool struct {
Type string `json:"type"`
Name string `json:"name,omitempty"`
Reason string `json:"reason"`
}
func DroppedTools ¶
func DroppedTools(request *ir.Request) []DroppedTool
type FunctionFallbackTool ¶
type Options ¶
type Options struct {
BuiltinToolFallback BuiltinToolFallbackPolicy
RequestFields RequestFieldPermissions
}
type RequestFieldPermissions ¶
type RequestFieldPermissions struct {
AllowServiceTier bool `json:"allow_service_tier,omitempty"`
AllowInferenceGeo bool `json:"allow_inference_geo,omitempty"`
AllowStore bool `json:"allow_store"`
AllowSafetyIdentifier bool `json:"allow_safety_identifier,omitempty"`
AllowIncludeObfuscation bool `json:"allow_include_obfuscation,omitempty"`
}
func DefaultRequestFieldPermissions ¶
func DefaultRequestFieldPermissions() RequestFieldPermissions
type ResolvedTool ¶
type ResolvedTool struct {
Emit any
Dropped *DroppedTool
FunctionFallback *FunctionFallbackTool
}
func ResolveTool ¶
func ResolveTool(tool ir.Tool, source, target ir.Protocol, policy BuiltinToolFallbackPolicy, emit TargetEmitFuncs) (ResolvedTool, error)
type TargetEmitFuncs ¶
Click to show internal directories.
Click to hide internal directories.