run

package

v0.7.0 Latest Latest Go to latest Published: May 18, 2026 License: MIT Imports: 29 Imported by: 0

Details

Package run implements the `kontext start` orchestrator.

This section is empty.

This section is empty.

func GenerateLocalSettings(sessionDir, kontextBinary, agentName, socketPath, mode string) (string, error)

GenerateLocalSettings creates a Claude Code settings.json that connects hooks to the wrapper-owned local runtime socket.

func GenerateSettings(sessionDir, kontextBinary, agentName string) (string, error)

GenerateSettings creates a Claude Code settings.json with Kontext hooks and returns the path to the generated file.

func Start(ctx context.Context, opts Options) error

Start preserves the historical managed-session entry point.

func StartLocal(ctx context.Context, opts Options) error

StartLocal launches an agent with a wrapper-owned local runtime.

func StartManaged(ctx context.Context, opts Options) error

StartManaged launches an agent with a hosted managed Kontext session.

func VerifyBlockingHookSettings(settingsPath, kontextBinary, agentName string) error

type AgentExitError struct {
	Agent string
	Err   *exec.ExitError
}

AgentExitError reports an agent process that launched but exited unsuccessfully.

func (e *AgentExitError) Error() string

func (e *AgentExitError) ExitCode() int

func (e *AgentExitError) Unwrap() error

type Options struct {
	Agent        string
	TemplateFile string
	IssuerURL    string
	ClientID     string
	Verbose      bool
	Args         []string
}

Options configures a kontext start run.