offload

Documentation

Overview

Package offload 是 ToolEndHook：超大工具结果卸载到文件系统， 上下文里只保留头部摘要与文件路径，防止大输出（日志、转储、目录遍历） 撑爆上下文。写入失败时降级透传原文，绝不阻断工具执行。 结果后处理不耦合工具节点本身，故为 hook 而非 warp。

Index

• Constants
• func WithSkip(names ...string) func(*Options)
• type Hook
  • func New(fsys fs.FileSystem, opts ...func(*Options)) *Hook
  • func (h *Hook) Name() string
  • func (h *Hook) OnToolEnd(ctx context.Context, _ *types.LoopState, result *types.ToolResult) error
• type Options

Constants

const DefaultThreshold = 4096

DefaultThreshold 超过此字节数的结果触发卸载。

Functions

func WithSkip

func WithSkip(names ...string) func(*Options)

WithSkip 设置免卸载名单：名单内工具的结果不做大卸载。

Types

type Hook

type Hook struct {
	// contains filtered or unexported fields
}

func New

func New(fsys fs.FileSystem, opts ...func(*Options)) *Hook

New 创建卸载 hook，挂载后自动处理所有工具的大结果。

func (*Hook) Name

func (h *Hook) Name() string

func (*Hook) OnToolEnd

func (h *Hook) OnToolEnd(ctx context.Context, _ *types.LoopState, result *types.ToolResult) error

type Options

type Options struct {
	// Threshold 触发阈值，默认 4096 字节。
	Threshold int
	// Dir 卸载目标目录（FS 内路径），默认 ".ezloop/offload"。
	Dir string
	// Head 保留在消息里的原文头部长度，默认 512。
	Head int
	// Skip 免卸载名单：这些工具的结果原样保留（如分身最终答案——
	// 截断成摘要会伤主循环决策）。
	Skip []string
}