agentenv

type AgentInitDecision struct {
	SystemPrompt  string
	AllowedTools  []string
	ToolsModified bool
}

type CommandAction string

type CommandRequest struct {
	Message string
	RunSpec RunSpec
}

type CommandResult struct {
	Matched         bool
	Action          CommandAction
	CommandName     string
	Response        string
	Prompt          string
	Display         string
	DisplayOverride bool
	RecipeName      string
	AllowedTools    []string
	AllowedCommands []string
}

type Environment interface {
	Open(ctx context.Context, spec RunSpec) (Manifest, error)
	IsOpen() bool
	Manifest() Manifest
	ExecuteCommand(ctx context.Context, request CommandRequest) (CommandResult, error)
	ProcessUserMessage(ctx context.Context, message string) (string, error)
	DispatchAgentStart(ctx context.Context) error
	DispatchTurnStart(ctx context.Context, turnNumber int) error
	ProcessAgentInit(ctx context.Context, systemPrompt string, allowedTools []string) (AgentInitDecision, error)
	DispatchTurnEnd(ctx context.Context, finalOutput string, turnCount int) error
	DispatchAgentEnd(ctx context.Context, messages []llmtypes.Message) ([]string, error)
	DispatchToolCall(ctx context.Context, request ToolRequest) (ToolCallDecision, error)
	DispatchToolUpdate(ctx context.Context, request ToolOutputRequest) (ToolOutputDecision, error)
	DispatchToolResult(ctx context.Context, request ToolOutputRequest) (ToolOutputDecision, error)
	CanStreamToolUpdates() bool
	ExecuteTool(ctx context.Context, request ToolRequest, updates ToolUpdateSink) (ToolExecution, error)
	Close(ctx context.Context) error
}

type EnvironmentConfig struct {
	AllowedCommands     []string
	ToolMode            llmtypes.ToolMode
	EnableFSSearchTools bool
	SystemPromptPath    string
	SystemPromptContent string
	SystemPromptArgs    map[string]string
	SystemInformation   *llmtypes.SystemInformation
}

type ExtensionSetter interface {
	SetExtensions(runtime any)
}

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

type Manifest struct {
	WorkingDirectory string                  `json:"workingDirectory"`
	Contexts         map[string]string       `json:"contexts"`
	Tools            []ToolDefinition        `json:"tools"`
	Commands         []slashcommands.Command `json:"commands"`
	Config           *EnvironmentConfig      `json:"config,omitempty"`
}

type OutcomeCloser interface {
	CloseWithError(ctx context.Context, runErr error) error
}

type RemoteController interface {
	OpenRun(ctx context.Context, runnerID string, params protocol.RunOpenParams) (runnerpayload.Manifest, error)
	CallRun(ctx context.Context, runID, method string, params any, result any) error
	ExecuteTool(ctx context.Context, params runnerpayload.ToolExecuteParams, updates func(runnerpayload.ToolUpdateParams)) (runnerpayload.ToolExecuteResult, error)
	CancelRun(ctx context.Context, runID, reason string) error
	CloseRun(ctx context.Context, runID string, status protocol.RunStatus, runErr error) error
}

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

type RemoteEnvironmentOption func(*RemoteEnvironment)

type RunSpec struct {
	ConversationID     string
	EnvironmentProfile string
	Config             llmtypes.Config
	Metadata           map[string]any
	InvokedBy          string
}

type StateProvider interface {
	State() tooltypes.State
}

type ToolCallDecision struct {
	Blocked bool
	Reason  string
	Input   string
}

type ToolDefinition struct {
	Name        string         `json:"name"`
	Description string         `json:"description"`
	InputSchema map[string]any `json:"inputSchema"`
	Placement   ToolPlacement  `json:"placement"`
	Tool        tooltypes.Tool `json:"-"`
}

type ToolExecution struct {
	Input            string
	Result           tooltypes.ToolResult
	StructuredResult tooltypes.StructuredToolResult
	Modified         bool
}

type ToolOutputDecision struct {
	StructuredResult tooltypes.StructuredToolResult
	Modified         bool
	Accepted         bool
}

type ToolOutputRequest struct {
	Name             string
	Input            string
	ToolCallID       string
	StructuredResult tooltypes.StructuredToolResult
}

type ToolPlacement string

type ToolRequest struct {
	Name       string
	Input      string
	ToolCallID string
}

type ToolUpdate struct {
	Result           tooltypes.ToolResult
	StructuredResult tooltypes.StructuredToolResult
	Modified         bool
}

type ToolUpdateSink func(ToolUpdate)