Package com.google.genkit.plugins.middleware

Class Artifacts

java.lang.Object

com.google.genkit.plugins.middleware.Artifacts

public final class Artifacts
extends Object

Factory for artifact tools that let a model read and write named artifacts on the active agent session.

Both tools operate on AgentSessionContext.currentArtifactStore(). When no agent session is bound to the current thread, the tools degrade gracefully: read_artifact reports found = false and write_artifact reports a "no active session" status without throwing.

Usage:

 AgentConfig.builder()
     .name("writer")
     .tools(Artifacts.tools(ArtifactsOptions.defaults()))
     .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	Artifacts.ReadInput	Input for read_artifact.
static final class	Artifacts.ReadOutput	Output for read_artifact.
static final class	Artifacts.WriteInput	Input for write_artifact.
static final class	Artifacts.WriteOutput	Output for write_artifact.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	READ_TOOL	Name of the read tool.
static final String	WRITE_TOOL	Name of the write tool.

Method Summary

Modifier and Type	Method	Description
static List<Tool<?,?>>	tools()	Builds the artifact tools using default options (read_artifact + write_artifact).
static List<Tool<?,?>>	tools(ArtifactsOptions options)	Builds the artifact tools.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

READ_TOOL

public static final String READ_TOOL

Name of the read tool.

See Also:

• Constant Field Values

WRITE_TOOL

public static final String WRITE_TOOL

Name of the write tool.

See Also:

• Constant Field Values

Method Details

tools

public static List<Tool<?,?>> tools()

Builds the artifact tools using default options (read_artifact + write_artifact).

Returns:

the artifact tools

tools

public static List<Tool<?,?>> tools(ArtifactsOptions options)

Builds the artifact tools.

Always includes read_artifact. Includes write_artifact unless options.isReadonly() is true.

Parameters:

options - the options (must not be null)

Returns:

the artifact tools