Files
sam 658a4cb50e
Quality / check (pull_request) Canceled after 0s
ci/woodpecker/pr/quality Pipeline was canceled
chore(runtime): remove code left dead by the Kit removal (#1877)
Drops Client.TaskPrincipalForCredential and the principal_id field only
it read, Reporter.ReportToolCall, Pool.EnsureImage and Pool.Instance,
and the binding cipher's exported domain API. Clears the remaining
harness references from the audit target kinds, docs and comments.
2026-11-12 21:42:17 +11:00

90 lines
3.1 KiB
Go

package agentrun
import "context"
// Runner executes one autonomous stage against an already prepared workspace.
type Runner interface {
// report receives what the run does as it happens; its zero value
// discards everything.
Run(ctx context.Context, workspace string, req Request, report Reporter) (Result, error)
}
// ToolCallReport is one completed tool invocation, reported through a
// Reporter.
type ToolCallReport struct {
Tool string
// Detail is a clipped one-line summary: the tool's result, or
// "error: <message>" if it failed.
Detail string
Failed bool
}
// Reporter receives a run's activity. Either func may be nil.
type Reporter struct {
// ToolCall is notified once per completed tool call.
ToolCall func(ToolCallReport)
// Transcript is notified of each transcript entry, in order.
Transcript func(TranscriptEntry)
}
// ReportTranscript forwards entry to r.Transcript, if set.
func (r Reporter) ReportTranscript(entry TranscriptEntry) {
if r.Transcript != nil {
r.Transcript(entry)
}
}
// Transcript entry kinds.
const (
TranscriptSystem = "system" // Text: the system prompt
TranscriptUser = "user" // Text: the mission, or input the loop added later
TranscriptModel = "model" // Reasoning, Text and ToolCalls: one model response
TranscriptTool = "tool" // one tool call's arguments and result
TranscriptCompaction = "compaction" // Text: the summary that replaced the history
)
// TranscriptEntry is one ordered item of an agent run's conversation. Text
// fields are redacted and clipped; a *Bytes field holds the full size when its
// field was clipped.
type TranscriptEntry struct {
Seq int `json:"seq"`
Kind string `json:"kind"`
Text string `json:"text,omitempty"`
TextBytes int `json:"text_bytes,omitempty"`
ToolCalls []TranscriptToolCall `json:"tool_calls,omitempty"`
Reasoning string `json:"reasoning,omitempty"`
ReasoningBytes int `json:"reasoning_bytes,omitempty"`
CallID string `json:"call_id,omitempty"`
Tool string `json:"tool,omitempty"`
Args string `json:"args,omitempty"`
ArgsBytes int `json:"args_bytes,omitempty"`
Output string `json:"output,omitempty"`
OutputBytes int `json:"output_bytes,omitempty"`
Error string `json:"error,omitempty"`
FinishReason string `json:"finish_reason,omitempty"`
Usage *Usage `json:"usage,omitempty"`
LatencyMS int64 `json:"latency_ms,omitempty"`
}
// TranscriptToolCall is one tool call a model response requested.
type TranscriptToolCall struct {
ID string `json:"id,omitempty"`
Name string `json:"name"`
Args string `json:"args,omitempty"`
ArgsBytes int `json:"args_bytes,omitempty"`
}
// BlockedError is a run failure an operator fixes outside the run, such as a
// model provider refusing its credential. Blocker is the taskstate blocker
// that names the fix.
type BlockedError struct {
Blocker string
Err error
}
func (e *BlockedError) Error() string { return e.Err.Error() }
func (e *BlockedError) Unwrap() error { return e.Err }