core

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

type CapsuleState string

type Command interface {
	StdinPipe() (io.WriteCloser, error)
	StdoutPipe() (io.ReadCloser, error)
	StderrPipe() (io.ReadCloser, error)
	SetStdin(io.Reader)
	SetEnv([]string)
	Start() error
	Wait() error
}

type CommandRunner interface {
	CommandContext(ctx context.Context, name string, arg ...string) Command
}

type HotLoadConfig struct {
	// Watch is a list of paths to watch for changes
	Watch []string `yaml:"watch,omitempty"`
	// Mode is the reload strategy. Currently only "restart" is supported
	Mode HotLoadMode `yaml:"mode,omitempty"`
	// DebounceMs is the minimum debounce interval for file change events in milliseconds
	DebounceMs int `yaml:"debounce_ms,omitempty"`
}

type HotLoadMode string

type JSONRPCError struct {
	Code    int         `json:"code"`
	Message string      `json:"message"`
	Data    interface{} `json:"data,omitempty"`
}

type JSONRPCRequest struct {
	JSONRPC string      `json:"jsonrpc"`
	ID      int64       `json:"id"`
	Method  string      `json:"method"`
	Params  interface{} `json:"params"`
}

type JSONRPCResponse struct {
	JSONRPC string        `json:"jsonrpc"`
	ID      int64         `json:"id"`
	Result  interface{}   `json:"result,omitempty"`
	Error   *JSONRPCError `json:"error,omitempty"`
}

type LLMBackend struct {
	// Endpoint is the URL of the LLM inference server
	Endpoint string `yaml:"endpoint,omitempty" mapstructure:"endpoint"`
	// Type is the type of the LLM inference API
	Type LLMInferenceAPIType `yaml:"type,omitempty" mapstructure:"type"`
	// APIKeyEnvVar is the *ENVIRONMENT VARIABLE*  storing the API key for the LLM inference API
	// Orla *does not* allow you to store the API key in the config file. You must use an environment variable.
	// This is to prevent the API key from being accidentally logged or leaked.
	APIKeyEnvVar string `yaml:"api_key_env_var,omitempty" mapstructure:"api_key_env_var"`
}

type LLMInferenceAPIType string

type MCPConfig struct {
	InputSchema  map[string]any `yaml:"input_schema,omitempty"`
	OutputSchema map[string]any `yaml:"output_schema,omitempty"`
}

type OrlaHelloNotification struct {
	JSONRPC string          `json:"jsonrpc"`
	Method  string          `json:"method"`
	Params  OrlaHelloParams `json:"params"`
}

type OrlaHelloParams struct {
	Name         string   `json:"name"`
	Version      string   `json:"version"`
	Capabilities []string `json:"capabilities"`
}

type OrlaToolExecutionResult struct {
	Stdout   string `json:"stdout"`
	Stderr   string `json:"stderr"`
	ExitCode int    `json:"exit_code"`
	Error    error  `json:"-"`
}

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

type RuntimeConfig struct {
	// Mode is the runtime mode. Currently only "simple" and "capsule" are supported
	Mode RuntimeMode `yaml:"mode,omitempty"`
	// StartupTimeoutMs is the maximum time Orla will wait for the startup handshake in milliseconds
	StartupTimeoutMs int `yaml:"startup_timeout_ms,omitempty"`
	// HotLoad is the hot-reload configuration as defined in RFC 3 section 5.3
	HotLoad *HotLoadConfig `yaml:"hot_load,omitempty"`
	// Env is a map of environment variables to inject into the tool process
	Env map[string]string `yaml:"env,omitempty"`
	// Args is a list of command-line arguments to append to the entrypoint
	Args []string `yaml:"args,omitempty"`
}

type RuntimeMode string

type ToolManifest struct {
	Name         string         `yaml:"name" validate:"required"`
	Version      string         `yaml:"version" validate:"required"`
	Description  string         `yaml:"description" validate:"required"`
	Entrypoint   string         `yaml:"entrypoint" validate:"required"`
	Author       string         `yaml:"author,omitempty"`
	License      string         `yaml:"license,omitempty"`
	Repository   string         `yaml:"repository,omitempty"`
	Homepage     string         `yaml:"homepage,omitempty"`
	Keywords     []string       `yaml:"keywords,omitempty"`
	Dependencies []string       `yaml:"dependencies,omitempty"`
	MCP          *MCPConfig     `yaml:"mcp,omitempty"`
	Runtime      *RuntimeConfig `yaml:"runtime,omitempty"`
	Path         string         `yaml:"path,omitempty"`        // Absolute path to entrypoint
	Interpreter  string         `yaml:"interpreter,omitempty"` // Interpreter parsed from shebang
}