tools

type AddObservationsArgs struct {
	Observations []memory.Observation `json:"observations" jsonschema:"observations to add"`
}

type AddObservationsResult struct {
	Observations []memory.Observation `json:"observations"`

	Skipped []SkippedObservation `json:"skipped,omitempty"`
}

type AuditReader interface {
	Query(ctx context.Context, filter memory.AuditFilter) ([]memory.AuditEvent, int64, error)

	Summary(ctx context.Context, window time.Duration) (memory.AuditSummary, error)
}

type ContentSearcher interface {
	Search(query, repo, fileType string) ([]memory.ContentMatch, error)

	Count() (int64, error)

	SearchMode() string
}

type CreateEntitiesArgs struct {
	Entities []memory.Entity `json:"entities" jsonschema:"entities to create"`
}

type CreateEntitiesResult struct {
	Entities []memory.Entity `json:"entities"`

	Skipped []SkippedObservation `json:"skipped,omitempty"`
}

type CreateRelationsArgs struct {
	Relations []memory.Relation `json:"relations" jsonschema:"relations to create"`
}

type CreateRelationsResult struct {
	Relations []memory.Relation `json:"relations"`
}

type DeleteEntitiesArgs struct {
	EntityNames []string `json:"entityNames" jsonschema:"Entities to delete."`

	Confirm bool `` /* 163-byte string literal not displayed */
}

type DeleteObservationsArgs struct {
	Deletions []memory.Observation `json:"deletions" jsonschema:"observations to delete"`
}

type DeleteRelationsArgs struct {
	Relations []memory.Relation `json:"relations" jsonschema:"relations to delete"`
}

type DiscoverMCPServersArgs struct {
	Repo string `json:"repo,omitzero"      jsonschema:"Filter results to a specific repository name."`

	ToolName string `` /* 181-byte string literal not displayed */

	Transport string `json:"transport,omitzero" jsonschema:"Filter by transport type: stdio, http, or sse."`

	Limit int `json:"limit,omitzero"     jsonschema:"Maximum number of servers to return (default 20, max 100)."`
}

type DiscoverMCPServersResult struct {
	Servers []MCPServerResult `json:"servers"`

	Total int `json:"total"`
}

type DocAccess struct {
	Repo string `json:"repo"`

	Path string `json:"path"`

	Count int64 `json:"count"`
}

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

type DocumentScanner interface {
	ListRepos() []scanner.RepoInfo

	SearchDocs(query string) []scanner.FileEntry

	GetFileContent(ctx context.Context, repo string, path string) (string, error)

	Status() (scanning bool, lastScan time.Time, repoCount int)

	TriggerScan() bool
}

type ExportGraphArgs struct {
	Format string `` /* 143-byte string literal not displayed */

	Title string `` /* 126-byte string literal not displayed */

	OutputPath string `` /* 153-byte string literal not displayed */
}

type ExportGraphResult struct {
	Format string `json:"format"`

	EntityCount int `json:"entity_count"`

	EdgeCount int `json:"edge_count"`

	OutputPath string `json:"output_path,omitempty"`

	Content string `json:"content,omitempty"`
}

type FindPathArgs struct {
	From string `json:"from"               jsonschema:"Name of the starting entity."`

	To string `json:"to"                 jsonschema:"Name of the destination entity."`

	MaxDepth int `json:"max_depth,omitempty" jsonschema:"Maximum number of hops to search (1–10). Defaults to 6 when omitted."`
}

type FindPathResult struct {
	Path []memory.PathEdge `json:"path"`

	Found bool `json:"found"`

	Hops int `json:"hops"`
}

type GetAuditSummaryArgs struct {
	WindowHours int `` /* 135-byte string literal not displayed */
}

type GetAuditSummaryResult struct {
	WindowHours int `json:"window_hours"`

	Summary memory.AuditSummary `json:"summary"`
}

type GetFileContentArgs struct {
	Repo string `` /* 134-byte string literal not displayed */

	Path string `json:"path" jsonschema:"The file path within the repository (e.g. 'docs/guide.md' or 'README.md')."`
}

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

type GraphStore interface {
	CreateEntities(entities []memory.Entity) ([]memory.Entity, error)

	CreateRelations(relations []memory.Relation) ([]memory.Relation, error)

	AddObservations(observations []memory.Observation) ([]memory.Observation, error)

	DeleteEntities(entityNames []string) error

	DeleteObservations(deletions []memory.Observation) error

	DeleteRelations(relations []memory.Relation) error

	ReadGraph() (memory.KnowledgeGraph, error)

	SearchNodes(query string) (memory.KnowledgeGraph, error)

	SearchNodesFiltered(query string, includeArchived bool) (memory.KnowledgeGraph, error)

	OpenNodes(names []string) (memory.KnowledgeGraph, error)

	OpenNodesFiltered(names []string, includeArchived bool) (memory.KnowledgeGraph, error)

	EntityCount() (int64, error)

	EntityTypeCounts() (map[string]int64, error)

	TraverseGraph(entity, relationType, direction string, maxDepth int) ([]memory.TraverseNode, []memory.TraverseEdge, error)

	GetIntegrationMap(ctx context.Context, service string, depth int) (memory.IntegrationMap, error)

	ListEntities(entityType string) (memory.KnowledgeGraph, error)

	ListRelations(relationType, fromEntity string) ([]memory.Relation, error)

	FindPath(from, to string, maxDepth int) ([]memory.PathEdge, error)

	UpdateEntity(oldName, newName, newType string) error
}

type IngestURLArgs struct {
	URL string `json:"url"                   jsonschema:"required,The full URL to fetch and ingest (must start with http:// or https://)."`

	EntityName string `json:"entity_name,omitempty" jsonschema:"Optional name for the graph entity. Defaults to the page title if omitted."`

	EntityType string `json:"entity_type,omitempty" jsonschema:"Entity type to assign (e.g. 'api', 'service', 'doc'). Defaults to 'doc'."`
}

type IngestURLResult struct {
	EntityName string `json:"entity_name"`

	URL string `json:"url"`

	ObservationCount int `json:"observation_count"`

	Cached bool `json:"cached"`

	Observations []string `json:"observations"`
}

type IntegrationEdgeJSON struct {
	Target string `json:"target"`

	Schema string `json:"schema,omitempty"`

	Version string `json:"version,omitempty"`

	Paths int `json:"paths,omitempty"`

	Confidence string `json:"confidence"`

	SourceRepo string `json:"source_repo,omitempty"`
}

type IntegrationMapArgs struct {
	Service string `json:"service"         jsonschema:"required,Entity name of the service in the knowledge graph (e.g. 'checkout-service')."`

	Depth int `` /* 133-byte string literal not displayed */
}

type IntegrationMapResult struct {
	Service string `json:"service"`

	Publishes []IntegrationEdgeJSON `json:"publishes"`

	Subscribes []IntegrationEdgeJSON `json:"subscribes"`

	ExposesAPI []IntegrationEdgeJSON `json:"exposes_api"`

	ProvidesGRPC []IntegrationEdgeJSON `json:"provides_grpc"`

	GRPCDeps []IntegrationEdgeJSON `json:"grpc_deps"`

	Calls []IntegrationEdgeJSON `json:"calls"`

	Coverage string `` /* 138-byte string literal not displayed */
}

type ListEntitiesArgs struct {
	EntityType string `` /* 202-byte string literal not displayed */
}

type ListRelationsArgs struct {
	RelationType string `` /* 265-byte string literal not displayed */

	FromEntity string `` /* 166-byte string literal not displayed */
}

type ListRelationsResult struct {
	Relations []memory.Relation `json:"relations"`

	Count int `json:"count"`
}

type ListReposArgs struct {
	FileType string `` /* 221-byte string literal not displayed */
}

type ListReposResult struct {
	Repos []repoSummary `json:"repos" jsonschema:"List of repositories with documentation"`
}

type MCPServerResult struct {
	Name string `json:"name"`

	Repo string `json:"repo"`

	Transport string `json:"transport,omitzero"`

	Command string `json:"command,omitzero"`

	URL string `json:"url,omitzero"`

	Tools []string `json:"tools"`

	ConfigFile string `json:"config_file,omitzero"`
}

type OpenNodesArgs struct {
	Names []string `json:"names" jsonschema:"names of nodes to open"`

	IncludeArchived bool `` /* 175-byte string literal not displayed */
}

type QueryAuditLogArgs struct {
	Agent string `json:"agent,omitempty"     jsonschema:"Filter events by agent name (e.g. claude-desktop, indexer-bot)."`

	Tool string `json:"tool,omitempty"      jsonschema:"Filter events by MCP tool name (e.g. create_entities, delete_entities)."`

	Operation string `json:"operation,omitempty" jsonschema:"Filter by operation type: create, delete, update, or add."`

	Outcome string `json:"outcome,omitempty"   jsonschema:"Filter by outcome: ok or error."`

	Since string `json:"since,omitempty"     jsonschema:"Return only events after this RFC3339 timestamp (e.g. 2026-04-21T00:00:00Z)."`

	Limit int `json:"limit,omitempty"     jsonschema:"Maximum events to return (default 50, max 500)."`
}

type QueryAuditLogResult struct {
	Events []memory.AuditEvent `json:"events"`

	Total int64 `json:"total"`
}

type RawContentResult struct {
	Content string `json:"content" jsonschema:"The raw text content of the file."`
}

type ScanStatusArgs struct{}

type ScanStatusResult struct {
	Scanning bool `json:"scanning"`

	LastScanAt time.Time `json:"last_scan_at"`

	RepoCount int `json:"repo_count"`

	ContentIndexed int64 `json:"content_indexed"`

	GraphEntities int64 `json:"graph_entities"`

	ContentEnabled bool `json:"content_enabled"`

	EntityBreakdown map[string]int64 `json:"entity_breakdown,omitempty"`

	SearchMode string `json:"search_mode,omitempty"`

	ReadOnly bool `json:"read_only"`
}

type SearchContentArgs struct {
	Query string `` /* 157-byte string literal not displayed */

	Repo string `json:"repo,omitempty" jsonschema:"Optional: filter results to a single repository name (e.g. 'org/payment-service')."`

	FileType string `` /* 227-byte string literal not displayed */
}

type SearchContentResult struct {
	Matches []memory.ContentMatch `json:"matches" jsonschema:"List of files containing the query term, with a snippet showing the matched context."`
}

type SearchDocsArgs struct {
	Query string `json:"query" jsonschema:"The search term to match against file paths and repo names."`

	FileType string `` /* 194-byte string literal not displayed */
}

type SearchDocsResult struct {
	Files []scanner.FileEntry `json:"files" jsonschema:"List of files matching the query"`
}

type SearchNodesArgs struct {
	Query string `json:"query" jsonschema:"query string"`

	IncludeArchived bool `` /* 175-byte string literal not displayed */
}

type SemanticSearch interface {
	Enabled() bool

	SearchDocs(ctx context.Context, query, repo string, topK int) ([]embeddings.DocResult, int, error)

	SearchEntities(ctx context.Context, query string, topK int) ([]embeddings.EntityResult, int, error)

	ScheduleIndexEntities(names []string)

	IndexDocs(ctx context.Context, repo string)
}

type SemanticSearchArgs struct {
	Query string `json:"query"            jsonschema:"Natural-language search query. Required."`

	Target string `` /* 139-byte string literal not displayed */

	TopK int `json:"top_k,omitempty"  jsonschema:"Maximum number of results per target (default 5, max 20)."`

	Repo string `` /* 130-byte string literal not displayed */
}

type SemanticSearchResult struct {
	ContentResults []embeddings.DocResult `json:"content_results,omitempty"`

	EntityResults []embeddings.EntityResult `json:"entity_results,omitempty"`

	StaleDocs int `json:"stale_docs"`

	StaleEntities int `json:"stale_entities"`
}

type SkippedObservation struct {
	EntityName string `json:"entity_name"`

	Observation string `json:"observation"`

	Reason string `json:"reason"`
}

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

type TraverseGraphArgs struct {
	Entity string `` /* 126-byte string literal not displayed */

	RelationType string `` /* 147-byte string literal not displayed */

	Direction string `` /* 182-byte string literal not displayed */

	Depth int `` /* 175-byte string literal not displayed */
}

type TraverseGraphResult struct {
	StartEntity string `json:"start_entity"`

	Nodes []memory.TraverseNode `json:"nodes"`

	Edges []memory.TraverseEdge `json:"edges"`

	TotalFound int `json:"total_found"`
}

type TriggerScanArgs struct{}

type TriggerScanResult struct {
	Triggered bool `json:"triggered"`

	AlreadyQueued bool `json:"already_queued"`
}

type UpdateEntityArgs struct {
	Name string `json:"name"               jsonschema:"Current name of the entity to update. Must match exactly."`

	NewName string `` /* 157-byte string literal not displayed */

	NewType string `json:"new_type,omitempty" jsonschema:"New entity type (e.g. 'service', 'team', 'api'). Omit to keep the current type."`
}

type UpdateEntityResult struct {
	Updated bool `json:"updated"`

	Name string `json:"name"` // effective name after update

}

type UsageStatsArgs struct{}

type UsageStatsResult struct {
	ToolCalls map[string]int64 `` /* 126-byte string literal not displayed */

	TopDocuments []DocAccess `` /* 198-byte string literal not displayed */
}