agents-ext/ai.koog.agents.ext.tool.file/WriteFileTool

WriteFileTool

class WriteFileTool<Path>(fs: FileSystemProvider.ReadWrite<Path>) : Tool<WriteFileTool.Args, WriteFileTool.Result> (source)

Provides functionality to write text content to files at absolute paths, creating parent directories and overwriting existing content as needed.

Parameters

Path

the filesystem path type used by the provider

Constructors

WriteFileTool

constructor(fs: FileSystemProvider.ReadWrite<Path>)

Types

Args

@Serializable

data class Args(val path: String, val content: String)

Specifies which file to write and what text content to put into it.

Result

@Serializable

data class Result(val file: FileSystemEntry.File) : ToolResult.TextSerializable

Contains the successfully written file with its metadata.

Properties

argsSerializer

open override val argsSerializer: KSerializer<WriteFileTool.Args>

description

open override val description: String

descriptor

open val descriptor: ToolDescriptor

name

open override val name: String

resultSerializer

open override val resultSerializer: KSerializer<WriteFileTool.Result>

Functions

decodeArgs

fun decodeArgs(rawArgs: JsonObject): WriteFileTool.Args

decodeResult

fun decodeResult(rawResult: JsonElement): WriteFileTool.Result

encodeArgs

fun encodeArgs(args: WriteFileTool.Args): JsonObject

encodeArgsToString

fun encodeArgsToString(args: WriteFileTool.Args): String

encodeArgsToStringUnsafe

fun encodeArgsToStringUnsafe(args: Any?): String

encodeArgsUnsafe

fun encodeArgsUnsafe(args: Any?): JsonObject

encodeResult

fun encodeResult(result: WriteFileTool.Result): JsonElement

encodeResultToString

open fun encodeResultToString(result: WriteFileTool.Result): String

encodeResultToStringUnsafe

fun encodeResultToStringUnsafe(result: Any?): String

encodeResultUnsafe

fun encodeResultUnsafe(result: Any?): JsonElement

execute

open suspend override fun execute(args: WriteFileTool.Args): WriteFileTool.Result

Writes text content to the filesystem at the specified absolute path.

executeUnsafe

suspend fun executeUnsafe(args: Any?): WriteFileTool.Result