2026-04-10 09:56:17 +00:00
package tools
import (
"context"
"encoding/json"
"fmt"
"strings"
"github.com/Tencent/WeKnora/internal/types"
"github.com/Tencent/WeKnora/internal/types/interfaces"
)
type wikiReplaceTextTool struct {
BaseTool
2026-04-10 13:04:55 +00:00
wikiPageService interfaces . WikiPageService
knowledgeService interfaces . KnowledgeService
kbIDs [ ] string
2026-07-26 16:59:38 +00:00
routes * WikiRouteResolver
searchTargets types . SearchTargets
2026-07-27 02:54:47 +00:00
scopeEnforced bool
2026-04-10 09:56:17 +00:00
}
// NewWikiReplaceTextTool creates a new wiki_replace_text tool
2026-07-26 16:59:38 +00:00
func NewWikiReplaceTextTool (
wikiPageService interfaces . WikiPageService ,
kbIDs [ ] string ,
knowledgeService interfaces . KnowledgeService ,
routes ... * WikiRouteResolver ,
) * wikiReplaceTextTool {
2026-04-10 09:56:17 +00:00
return & wikiReplaceTextTool {
BaseTool : NewBaseTool (
ToolWikiReplaceText ,
"Replace specific exact text in a Wiki page. Ideal for minor corrections." ,
json . RawMessage ( ` {
"type" : "object" ,
"properties" : {
"slug" : {
"type" : "string" ,
"description" : "The slug of the Wiki page"
} ,
"old_text" : {
"type" : "string" ,
"description" : "The exact text to find and replace"
} ,
"new_text" : {
"type" : "string" ,
"description" : "The new text to insert"
} ,
"source_refs" : {
"type" : "array" ,
"items" : { "type" : "string" } ,
2026-07-16 13:23:20 +00:00
"description" : "An optional list of short dN source document IDs that justify this change. If provided, these will COMPLETELY REPLACE the existing source_refs of the page."
2026-04-10 09:56:17 +00:00
}
} ,
"required" : [ "slug" , "old_text" , "new_text" ]
} ` ) ,
) ,
2026-04-10 13:04:55 +00:00
wikiPageService : wikiPageService ,
knowledgeService : knowledgeService ,
kbIDs : kbIDs ,
2026-07-26 16:59:38 +00:00
routes : firstWikiRoute ( routes ) ,
2026-04-10 09:56:17 +00:00
}
}
2026-07-27 02:54:47 +00:00
// WithSearchTargets enables the Agent authorization boundary for source_refs.
// An Agent turn with no search target must reject every source document.
2026-07-26 16:59:38 +00:00
func ( t * wikiReplaceTextTool ) WithSearchTargets ( searchTargets types . SearchTargets ) * wikiReplaceTextTool {
t . searchTargets = searchTargets
2026-07-27 02:54:47 +00:00
t . scopeEnforced = true
2026-07-26 16:59:38 +00:00
return t
}
2026-04-10 09:56:17 +00:00
func ( t * wikiReplaceTextTool ) Execute ( ctx context . Context , args json . RawMessage ) ( * types . ToolResult , error ) {
2026-07-27 07:01:43 +00:00
// Attribute every page write performed by this tool to the agent so
// revision history distinguishes agent edits from pipeline/user ones.
ctx = types . WithWikiEditSource ( ctx , types . WikiEditSourceAgent )
2026-04-10 09:56:17 +00:00
var params struct {
2026-07-26 16:59:38 +00:00
Slug string ` json:"slug" `
OldText string ` json:"old_text" `
NewText string ` json:"new_text" `
SourceRefs * [ ] string ` json:"source_refs" `
2026-04-10 09:56:17 +00:00
}
if err := json . Unmarshal ( args , & params ) ; err != nil {
return & types . ToolResult { Success : false , Error : "Failed to parse arguments: " + err . Error ( ) } , nil
}
if len ( t . kbIDs ) == 0 {
return & types . ToolResult { Success : false , Error : "No knowledge bases available for editing" } , nil
}
if params . OldText == "" {
return & types . ToolResult { Success : false , Error : "old_text is required" } , nil
}
2026-07-26 16:59:38 +00:00
normalizedSlug , slugErr := normalizeAndValidateWikiSlug ( params . Slug )
if slugErr != nil {
return & types . ToolResult { Success : false , Error : slugErr . Error ( ) } , nil
}
params . Slug = normalizedSlug
2026-04-10 09:56:17 +00:00
// Get the existing page
2026-07-26 16:59:38 +00:00
existingPage , _ , err := resolveUniqueWikiPage ( ctx , t . wikiPageService , params . Slug , t . kbIDs , t . routes )
2026-04-10 09:56:17 +00:00
if err != nil {
return & types . ToolResult { Success : false , Error : fmt . Sprintf ( "Failed to fetch page %s: %v" , params . Slug , err ) } , nil
}
if ! strings . Contains ( existingPage . Content , params . OldText ) {
return & types . ToolResult { Success : false , Error : "old_text not found in the current page content. Ensure you copy it exactly as it appears." } , nil
}
existingPage . Content = strings . Replace ( existingPage . Content , params . OldText , params . NewText , 1 )
2026-07-26 16:59:38 +00:00
if params . SourceRefs != nil {
2026-07-27 02:54:47 +00:00
if t . scopeEnforced {
2026-07-26 16:59:38 +00:00
resolvedRefs , scopeErr := resolveAuthorizedSourceRefs ( ctx , t . searchTargets , * params . SourceRefs , t . knowledgeService )
if scopeErr != nil {
return & types . ToolResult { Success : false , Error : "Invalid source_refs: " + scopeErr . Error ( ) } , nil
}
existingPage . SourceRefs = resolvedRefs
} else {
existingPage . SourceRefs = resolveSourceRefs ( ctx , t . knowledgeService , * params . SourceRefs )
}
2026-04-10 09:56:17 +00:00
}
_ , err = t . wikiPageService . UpdatePage ( ctx , existingPage )
if err != nil {
return & types . ToolResult { Success : false , Error : "Failed to update page: " + err . Error ( ) } , nil
}
2026-04-10 13:04:55 +00:00
2026-04-10 13:35:28 +00:00
oldPreview := truncateRunes ( params . OldText , 80 )
newPreview := truncateRunes ( params . NewText , 80 )
output := fmt . Sprintf ( "Successfully replaced text on page [[%s]].\n- Old: %s\n- New: %s" , params . Slug , oldPreview , newPreview )
return & types . ToolResult {
Success : true ,
Output : output ,
Data : map [ string ] interface { } {
"display_type" : "wiki_replace_text" ,
"slug" : params . Slug ,
"title" : existingPage . Title ,
"old_text" : oldPreview ,
"new_text" : newPreview ,
} ,
} , nil
2026-04-10 09:56:17 +00:00
}