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 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 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 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 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, 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 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 OpenNodesArgs struct {
	Names []string `json:"names" jsonschema:"names of nodes to open"`

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

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"`

	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 */
}