convert

package
v0.0.21 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 12, 2026 License: MIT Imports: 10 Imported by: 0

Documentation

Index

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 AdaptFunctionFallbackEvents

func AdaptFunctionFallbackEvents(ctx context.Context, events <-chan ir.Event, tools map[string]FunctionFallbackTool) <-chan ir.Event

func AdaptNamespacedFunctionEvents

func AdaptNamespacedFunctionEvents(ctx context.Context, events <-chan ir.Event, bindings map[string]NamespacedFunctionBinding) <-chan ir.Event

func AssertStreamingToolCallInvariant

func AssertStreamingToolCallInvariant(events []ir.Event) error

func AssertToolsInvariant

func AssertToolsInvariant(tools []any) error

func BuildChatFunctionName

func BuildChatFunctionName(namespace, name string) string

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

func NormalizeAssistantToolCallSequence(messages []ir.Message) []ir.Message

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 PrepareNamespacedFunctionsForChat

func PrepareNamespacedFunctionsForChat(request *ir.Request) (*ir.Request, error)

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 FunctionFallbackTool struct {
	Name         string `json:"name"`
	ArgumentName string `json:"argument_name"`
}

type NamespacedFunctionBinding

type NamespacedFunctionBinding struct {
	ChatName  string `json:"chat_name"`
	Namespace string `json:"namespace"`
	Name      string `json:"name"`
}

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

type TargetEmitFuncs struct {
	Function func(ir.Tool) any
}

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL