run

Documentation

Overview

Package run implements the `kontext start` orchestrator.

Index

• func GenerateLocalSettings(sessionDir, kontextBinary, agentName, socketPath, mode string) (string, error)
• func GenerateSettings(sessionDir, kontextBinary, agentName string) (string, error)
• func Start(ctx context.Context, opts Options) error
• func StartLocal(ctx context.Context, opts Options) error
• func StartManaged(ctx context.Context, opts Options) error
• func VerifyBlockingHookSettings(settingsPath, kontextBinary, agentName string) error
• type AgentExitError
  • func (e *AgentExitError) Error() string
  • func (e *AgentExitError) ExitCode() int
  • func (e *AgentExitError) Unwrap() error
• type Options

Functions

func GenerateLocalSettings

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

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

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

Start preserves the historical managed-session entry point.

func StartLocal

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

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

func StartManaged

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

StartManaged launches an agent with a hosted managed Kontext session.

func VerifyBlockingHookSettings

func VerifyBlockingHookSettings(settingsPath, kontextBinary, agentName string) error

Types

type AgentExitError

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

AgentExitError reports an agent process that launched but exited unsuccessfully.

func (*AgentExitError) Error

func (e *AgentExitError) Error() string

func (*AgentExitError) ExitCode

func (e *AgentExitError) ExitCode() int

func (*AgentExitError) Unwrap

func (e *AgentExitError) Unwrap() error

type Options

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

Options configures a kontext start run.