RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.
Go agent-harnessagent-native-databaseagentic-aiagentic-retrievalagentic-searchaiai-agentscontext-enginecontext-engineeringcontext-managementharness-engineeringknowledge-compilationragretrieval-augmented-generationretrieval-harnesssearch-harness
//
// Copyright 2026 The InfiniFlow Authors. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
package filesystem
import "time"
// NodeType represents the type of a node in the virtual filesystem
type NodeType string
const (
NodeTypeDirectory NodeType = "directory"
NodeTypeFile NodeType = "file"
NodeTypeDataset NodeType = "dataset"
NodeTypeDocument NodeType = "document"
NodeTypeChat NodeType = "chat"
NodeTypeAgent NodeType = "agent"
NodeTypeUnknown NodeType = "unknown"
)
// Node represents a node in the context filesystem
// This is the unified output format for all providers
type Node struct {
Name string `json:"name"`
Path string `json:"path"`
Type NodeType `json:"type"`
Size int64 `json:"size,omitempty"`
CreatedAt time.Time `json:"created_at,omitempty"`
UpdatedAt time.Time `json:"updated_at,omitempty"`
Metadata map[string]interface{} `json:"metadata,omitempty"`
}
// CommandType represents the type of command
type CommandType string
const (
CommandList CommandType = "ls"
CommandSearch CommandType = "search"
CommandCat CommandType = "cat"
)
// Command represents a filesystem command
type Command struct {
Type CommandType `json:"type"`
Path string `json:"path"`
Params map[string]interface{} `json:"params,omitempty"`
}
// ListOptions represents options for list operations
type ListOptions struct {
Recursive bool `json:"recursive,omitempty"`
Limit int `json:"limit,omitempty"`
Offset int `json:"offset,omitempty"`
SortBy string `json:"sort_by,omitempty"`
SortOrder string `json:"sort_order,omitempty"` // "asc" or "desc"
}
// SearchOptions represents options for search operations
type SearchOptions struct {
Query string `json:"query"`
Limit int `json:"limit,omitempty"`
Offset int `json:"offset,omitempty"`
Recursive bool `json:"recursive,omitempty"`
TopK int `json:"top_k,omitempty"` // Number of top results to return (default: 10)
Threshold float64 `json:"threshold,omitempty"` // Similarity threshold (default: 0.2)
Dirs []string `json:"dirs,omitempty"` // List of directories to search in
}
// Result represents the result of a command execution
type Result struct {
Nodes []*Node `json:"nodes"`
Total int `json:"total"`
HasMore bool `json:"has_more"`
NextOffset int `json:"next_offset,omitempty"`
Error error `json:"-"`
}
// PathInfo represents parsed path information
type PathInfo struct {
Provider string // The provider name (e.g., "datasets", "chats")
Path string // The full path
Components []string // Path components
IsRoot bool // Whether this is the root path for the provider
ResourceID string // Resource ID if applicable
ResourceName string // Resource name if applicable
}
// ProviderInfo holds metadata about a provider
type ProviderInfo struct {
Name string `json:"name"`
Description string `json:"description"`
RootPath string `json:"root_path"`
}
// Common error messages
const (
ErrInvalidPath = "invalid path"
ErrProviderNotFound = "provider not found for path"
ErrNotSupported = "operation not supported"
ErrNotFound = "resource not found"
ErrUnauthorized = "unauthorized"
ErrInternal = "internal error"
)