Documentation
¶
Overview ¶
Package runner orchestrates a single end-to-end skill execution: load manifest + skill, call LLM, parse memory, publish, writeback.
Index ¶
Constants ¶
View Source
const ( DefaultMaxTurns = 20 DefaultMCPToolCallTimeoutS = 60 )
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Deps ¶
type Deps struct {
ProviderFactory func(name string) (llm.Provider, error)
Publishers map[string]publish.Publisher
MCPManagerFactory func(ctx context.Context) mcpManager
Now func() time.Time
// EventSink receives observability events during execution. May be nil.
EventSink func(RunEvent)
}
Deps inject the runner's collaborators.
type EventType ¶
type EventType string
EventType identifies a structured runner event.
const ( EventMCPServerStartOK EventType = "mcp.server.start.ok" EventMCPTurnStart EventType = "mcp.turn.start" EventMCPToolCallOK EventType = "mcp.tool.call.ok" EventMCPToolCallFail EventType = "mcp.tool.call.fail" EventMCPToolCallTimeout EventType = "mcp.tool.call.timeout" // EventPhaseEnter marks entry into a coarse lifecycle phase // (boot|secrets|exec|publish|fail). Payload: {"phase": "<name>"} on // the happy path; {"phase":"fail","prev":"<name>"} on terminal error. EventPhaseEnter EventType = "phase.enter" )
type RunInput ¶
type RunInput struct {
RepoRoot string
ManifestPath string // relative to RepoRoot
SkillPath string // from manifest
ScheduleName string
RunID string
Secrets *runnersecrets.Resolver
LLMAPIKey string
LLMEndpoint string // Azure AI Foundry only
LLMDeployment string // Azure AI Foundry only
DryRun bool // don't publish, don't writeback, don't push
SkipPush bool // writeback commit locally but don't push
GitHubUsername string
GitHubToken string
MCPServers []config.MCPServer
MCPEnv map[string]map[string]config.EnvValue
MaxTurns int
}
RunInput bundles all inputs to a single Run invocation.
type RunResult ¶
type RunResult struct {
Status Status
ErrorKind string
Usage llm.Usage
CostCents int
Output string
MemoryContent string
PublishResults []publish.Result
WritebackSHA string
StartedAt time.Time
FinishedAt time.Time
}
RunResult is the terminal state of a single run.
Click to show internal directories.
Click to hide internal directories.