backends

type BackendFactory func(runtime interface{}) BackendProtocol

type BackendProtocol interface {
	// Read reads file content with optional pagination
	// Returns formatted content (with line numbers in cat -n style)
	Read(ctx context.Context, path string, offset, limit int) (string, error)

	// Write creates or overwrites a file
	Write(ctx context.Context, path string, content string) (*WriteResult, error)

	// Edit performs string replacement in a file
	Edit(ctx context.Context, path string, oldStr, newStr string, replaceAll bool) (*EditResult, error)

	// List lists files in a directory
	List(ctx context.Context, path string) ([]FileInfo, error)

	// Glob finds files matching a pattern
	Glob(ctx context.Context, pattern string, basePath string) ([]string, error)

	// Grep searches for text in files
	Grep(ctx context.Context, pattern string, path string, globFilter string) ([]GrepMatch, error)
}

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

type EditResult struct {
	// Path is the file path that was edited
	Path string
	// Occurrences is the number of replacements made
	Occurrences int
	// FilesUpdate contains state updates for StateBackend
	// nil for other backends
	FilesUpdate map[string]*FileData
	// Error message if operation failed (empty string on success)
	Error string
}

type ExecuteResult struct {
	// Output is the combined stdout/stderr
	Output string
	// ExitCode is the command exit code
	ExitCode int
	// Truncated indicates if output was truncated
	Truncated bool
}

type FileData struct {
	// Content is the file content split into lines
	Content []string
	// CreatedAt is ISO 8601 timestamp
	CreatedAt string
	// ModifiedAt is ISO 8601 timestamp
	ModifiedAt string
}

type FileInfo struct {
	Path       string
	IsDir      bool
	Size       int64
	ModifiedAt time.Time
}

type GrepMatch struct {
	// Path is the file path
	Path string
	// LineNumber is the line number (1-indexed)
	LineNumber int
	// Line is the matching line content
	Line string
}

type SandboxBackendProtocol interface {
	BackendProtocol

	// Execute runs a shell command in a sandboxed environment
	Execute(ctx context.Context, command string) (*ExecuteResult, error)
}

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

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

type WriteResult struct {
	// Path is the file path that was written
	Path string
	// FilesUpdate contains state updates for StateBackend
	// nil for other backends
	FilesUpdate map[string]*FileData
	// Error message if operation failed (empty string on success)
	Error string
}