outputoffload

package

v0.5.1-rc.1 Latest Latest Go to latest Published: Oct 1, 2026 License: Apache-2.0 Imports: 10 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/Agent-Field/codeaf

Links

Open Source Insights

Documentation ¶

Rendered for

Overview ¶

Package outputoffload keeps large tool outputs out of the context window: the full text is written to a file under .senior-dev/tool-output and the model sees a bounded extract (head, tail and diagnostic-looking lines) plus the path.

Index ¶

Constants
Variables
func ExtractRelevant(output string, opts *ExtractRelevantOptions) string
type DiskSink
- func (DiskSink) WriteOutput(path string, output string) (string, error)
type DistillHook
type ExtractRelevantOptions
type Offloader
- func (o Offloader) OffloadLargeOutput(input OutputOffloadInput, options any) OutputOffloadResult
type OutputOffloadInput
type OutputOffloadOptions
type OutputOffloadResult
- func OffloadLargeOutput(input OutputOffloadInput, options any) OutputOffloadResult
- func (r OutputOffloadResult) MarshalJSON() ([]byte, error)
type OutputSink

Constants ¶

View Source

const (
	HEAD_LINES              = 20
	TAIL_LINES              = 40
	EXTRACT_MAX_CHARS       = 6_000
	OFFLOAD_THRESHOLD_CHARS = 12_000
)

Variables ¶

View Source

var DefaultOffloader = Offloader{Sink: DiskSink{}}

Functions ¶

func ExtractRelevant ¶

func ExtractRelevant(output string, opts *ExtractRelevantOptions) string

ExtractRelevant keeps the head, tail, and diagnostic-looking lines.

Types ¶

type DiskSink ¶

type DiskSink struct{}

func (DiskSink) WriteOutput ¶

func (DiskSink) WriteOutput(path string, output string) (string, error)

type DistillHook ¶

type DistillHook func(fullOutput string) (string, error)

type ExtractRelevantOptions ¶

type ExtractRelevantOptions struct {
	FullOutputPath *string  `json:"fullOutputPath"`
	Path           *string  `json:"path"`
	MaxChars       *float64 `json:"maxChars"`
}

type Offloader ¶

type Offloader struct {
	Sink OutputSink
}

func (Offloader) OffloadLargeOutput ¶

func (o Offloader) OffloadLargeOutput(input OutputOffloadInput, options any) OutputOffloadResult

OffloadLargeOutput applies the offload policy with an injected sink.

type OutputOffloadInput ¶

type OutputOffloadInput struct {
	Output           string `json:"output"`
	Workspace        string `json:"workspace"`
	ToolName         string `json:"toolName"`
	CallID           string `json:"callId"`
	SessionID        string `json:"sessionId,omitempty"`
	EscalationWanted bool   `json:"escalationWanted"`
}

type OutputOffloadOptions ¶

type OutputOffloadOptions struct {
	Hook             DistillHook `json:"-"`
	EscalationWanted bool        `json:"escalationWanted"`
	Force            bool        `json:"-"`
}

type OutputOffloadResult ¶

type OutputOffloadResult struct {
	Inline           string
	OffloadPath      *string
	EscalationWanted bool
}

func OffloadLargeOutput ¶

func OffloadLargeOutput(input OutputOffloadInput, options any) OutputOffloadResult

OffloadLargeOutput uses the production filesystem sink. options accepts nil, OutputOffloadOptions (or a pointer), or a DistillHook.

func (OutputOffloadResult) MarshalJSON ¶

func (r OutputOffloadResult) MarshalJSON() ([]byte, error)

MarshalJSON emits inline first and the optional offloadPath and escalationWanted only when they are set.

type OutputSink ¶

type OutputSink interface {
	WriteOutput(path string, output string) (string, error)
}

OutputSink is the filesystem side effect behind offloadLargeOutput.

Source Files ¶

View all Source files

outputoffload.go

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