Embabel Agent Documentation/com.embabel.agent.api.common.reference/LocalDirectoryReference

LocalDirectoryReference

data class LocalDirectoryReference(val root: String, val description: String, val notes: String, val name: String = root.substringAfterLast('/')) : LlmReferenceProvider, LlmReference

Reference for a local directory on the filesystem. Provides readonly access via file read tools.

Parameters

root

the root directory path

notes

notes on how to use this reference

Constructors

LocalDirectoryReference

constructor(root: String, description: String, notes: String, name: String = root.substringAfterLast('/'))

Properties

open val description: String

open val name: String

open val namingStrategy: StringTransformer

val notes: String

val root: String

Functions

open fun contribution(): String

open override fun notes(): String

Notes about this reference, such as usage guidance. Does not need to consider prompt prefix, name or description as they will be added automatically.

open override fun reference(): LlmReference

open fun toolInstances(): List<Any>

Return the instances of tool object. Defaults to this

open fun toolObject(): ToolObject

Create a tool object for this reference.

open fun toolPrefix(): String

A safe prefix for LLM tools associated with this reference. Defaults to the name lowercased with spaces replaced by underscores. Subclasses can override it

open fun tools(): List<Tool>

Return framework-agnostic tools provided by this reference. These tools will be added to the PromptRunner when the reference is added. Defaults to empty list for backward compatibility.