@nhtio/adk/forge
Schema-first tool construction, invocation records, artifact tools, and registries.
Remarks
The forge — where tools are made. Schema-first primitives consumers compose into a working tool surface: @nhtio/adk!Tool (the standard tool definition), @nhtio/adk!ArtifactTool (the artifact-bound variant for custom spooled-artifact query tools), @nhtio/adk!ToolCall (the persisted record of an invocation), and @nhtio/adk!ToolRegistry (the collection of tools available within a turn). These are almost always used together — a runner registers tools, the model emits tool calls, the executor invokes them via the registry, and the resulting record is persisted as a ToolCall.
Pairs with @nhtio/adk/batteries/tools, which ships ready-made tool instances built with this forge. The forge defines what a tool is; the batteries provide tools already made.
Classes
| Class | Description |
|---|---|
| ArtifactTool | A @nhtio/adk!Tool subclass whose handler return value is wrapped directly in a @nhtio/adk!Tokenizable (not a @nhtio/adk!SpooledArtifact) when it lands on ToolCall.results. |
| Tool | A tool definition that serves as the single source of truth for a callable tool: its name, description, input schema, execution handler, and the @nhtio/adk!SpooledArtifact subclass that wraps its serialised output. |
| ToolCall | An immutable, validated tool call record associated with a turn. |
| ToolRegistry | A mutable, turn-scoped collection of @nhtio/adk!Tool instances. |
Interfaces
| Interface | Description |
|---|---|
| RawArtifactTool | Plain input object supplied to ArtifactTool at construction time. |
| RawTool | Plain input object supplied to Tool at construction time. |
| RawToolCall | Plain input object supplied to ToolCall at construction time. |
Type Aliases
| Type Alias | Description |
|---|---|
| ArtifactConstructorResolver | A zero-arg function that returns the @nhtio/adk!SpooledArtifactConstructor the consumer should use when wrapping this tool's serialised output into a ToolCall.results field. |
| ArtifactToolHandler | The execution function for an ArtifactTool. |
| SpooledArtifactConstructor | Constructor signature for SpooledArtifact and any subclass. |
| ToolHandler | The execution function for a Tool. |