Factory

open class Factory

Factory methods for creating UnfoldingTool instances. This is an open class so that subinterface companions can extend it.

Constructors

constructor()

open fun byCategory(name: String, description: String, toolsByCategory: Map<String, List<Tool>>, categoryParameter: String = "category", removeOnInvoke: Boolean = true, childToolUsageNotes: String? = null): UnfoldingTool

Create an UnfoldingTool with category-based selection.

open fun fromInstance(instance: Any, objectMapper: <Error class: unknown class> = jacksonObjectMapper()): UnfoldingTool

Create an UnfoldingTool from an instance annotated with @MatryoshkaTools.

open fun fromToolObject(instance: Any, name: String, description: String, removeOnInvoke: Boolean = true, childToolUsageNotes: String? = null): UnfoldingTool

Create an UnfoldingTool from any object with @LlmTool methods, providing explicit name and description.

open fun of(name: String, description: String, innerTools: List<Tool>, removeOnInvoke: Boolean = true, childToolUsageNotes: String? = null): UnfoldingTool

Create an UnfoldingTool that exposes all inner tools when invoked.

open fun safelyFromInstance(instance: Any, objectMapper: <Error class: unknown class> = jacksonObjectMapper()): UnfoldingTool?

Safely create an UnfoldingTool from an instance. Returns null if the class is not annotated with @MatryoshkaTools or has no @LlmTool methods.

open fun selectable(name: String, description: String, innerTools: List<Tool>, inputSchema: Tool.InputSchema, removeOnInvoke: Boolean = true, childToolUsageNotes: String? = null, selector: (String) -> List<Tool>): UnfoldingTool

Create an UnfoldingTool with a custom tool selector.