wire

type Budget struct {
	// MaxCalls 总调用数上限。0 = 不限。
	MaxCalls int
	// MaxBytes 累计输出字节上限。0 = 不限。
	MaxBytes int
	// contains filtered or unexported fields
}

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

type Handler func(ctx context.Context, req Request) (Response, error)

type Request struct {
	// V 协议版本。
	V int `json:"v"`
	// ID 调用标识。响应按它关联（不变量 6），故**必须非空且在一次执行内唯一**。
	ID string `json:"id"`
	// Tool 工具名。
	Tool string `json:"tool"`
	// Args 工具参数原文（宿主侧按自己的工具面解析）。
	Args string `json:"args"`
	// DeadlineMS 本次调用的期限（毫秒）。0 = 不限期。
	//
	// 由**子进程**声明、**父侧**执行：父侧是记账与取消的权威（不变量 3/5），
	// 子进程说了不算，父侧必须自己兜住。
	DeadlineMS int64 `json:"deadline_ms,omitempty"`
}

type Response struct {
	// V 协议版本。
	V int `json:"v"`
	// ID 对应的请求标识（不变量 6）。
	ID string `json:"id"`
	// OK 本次调用是否成功。
	OK bool `json:"ok"`
	// Value 成功时的结果文本（编码由宿主工具面定）。
	Value string `json:"value,omitempty"`
	// Kind 失败时的分类（**toolfail.Class**，不变量 2）。
	//
	// 空串只允许在「不是工具失败」的场合（如协议层错误、父侧拒绝）——那类错误由
	// 父侧直接终止执行域，不走正常响应路径。
	Kind string `json:"kind,omitempty"`
	// Error 失败时的可读原因（给人看，不参与判定）。
	Error string `json:"error,omitempty"`
}

type Result struct {
	// V 协议版本。
	V int `json:"v"`
	// ResultID 对应 Start.ResultID。
	ResultID string `json:"result_id"`
	// OK 执行是否成功。
	OK bool `json:"ok"`
	// Value 成功时的结果文本（编码由后端定）。
	Value string `json:"value,omitempty"`
	// Kind 失败时的分类（**toolfail.Class**，不变量 2）。
	Kind string `json:"kind,omitempty"`
	// Error 失败时的可读原因（给人看，不参与判定）。
	Error string `json:"error,omitempty"`
	// Calls 本次执行实际发起的工具调用次数（父侧用于对账）。
	Calls int `json:"calls,omitempty"`
	// Bytes 本次执行实际产生的输出字节数（父侧用于对账）。
	Bytes int `json:"bytes,omitempty"`
}

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

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

type ServerOption func(*Server)

type Start struct {
	// V 协议版本。
	V int `json:"v"`
	// Program 被执行的程序体。
	//
	// **由后端自己解释**（不变量：内核不规定程序语言）——子侧知道这段程序
	// 对自己意味着什么（脚本？DSL？），父侧只负责把它送到。
	Program string `json:"program"`
	// Bindings 程序可用的绑定清单。
	//
	// 父侧把绑定**清单**（名字与调用形态）交给子侧，而不是把绑定**实现**交出去
	// ——实现留在父侧，子侧通过工具调用帧请求执行。这正是跨进程的意义：
	// 宿主工具只在宿主进程里存在。
	Bindings []StartBinding `json:"bindings"`
	// Budget 这次执行的要求（父侧对后端的要求）。
	//
	// 与父侧记账用的 Budget 不同：那是「实际记着多少」，这是「要求多少」。
	Budget StartBudget `json:"budget"`
	// ResultID 本次执行的结果标识（子侧回报结果时带回）。
	ResultID string `json:"result_id"`
}

type StartBinding struct {
	// Name 工具名（父侧的原始名）。
	Name string `json:"name"`
	// Signature JS 调用形态，如 "get_logs(host, count)"。
	//
	// 空 = 退化为 `host.<name>(argsJSON)`。
	Signature string `json:"signature,omitempty"`
}

type StartBudget struct {
	// WallClock 墙钟期限。
	WallClock time.Duration `json:"wall_clock,omitempty"`
	// MaxCalls 调用数上限。
	MaxCalls int `json:"max_calls,omitempty"`
	// MaxBytes 输出字节上限。
	MaxBytes int `json:"max_bytes,omitempty"`
	// MaxMemory 内存上限（字节）。0 = 不要求。
	//
	// 子侧**兜不住**这一项时应当拒绝（而不是假装兜住了）——这与
	// `sandbox.Capable` 的缺省语义同源：漏声明得到的是「兜不住」。
	MaxMemory int64 `json:"max_memory,omitempty"`
}

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