Class DesignStore

java.lang.Object

com.eqixiac.equinix.mcp.server.DesignStore

public final class DesignStore
extends Object

The design tools' single in-memory store: deployment plans keyed by their plan_id and optimization results keyed by the fingerprint of the spec they were run for, so the tools can be chained (design_optimize then design_plan_deployment, design_get_plan, design_plan_drift, design_export_terraform) without repeating work.

Scope: single-process only. Ids resolve only inside this server process; when the MCP host restarts the server they are gone. A plan id is a content hash (DeploymentPlan.planId()), so storing the same plan again refreshes its entry rather than creating a second one.

Bounds and honesty: each kind keeps at most capacity() entries for ttl() (default 60 minutes). Storing beyond capacity evicts the oldest entry of that kind and putPlan(DeploymentPlan)/putOptimization(OptimizationResult) return what was evicted so the tool result can say so, as the broker's ProposalStore does. Expired and evicted ids are remembered for one further TTL window, so a later lookup answers DesignStore.Status.EXPIRED or DesignStore.Status.EVICTED instead of a bare DesignStore.Status.UNKNOWN.

Thread-safe; every method synchronizes on the store. The clock is injectable for tests.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	DesignStore.Entry<T>	A stored entry.
static enum	DesignStore.Kind	What a store entry holds.
static final record	DesignStore.Lookup<T>	The outcome of a lookup.
static final record	DesignStore.Put	The outcome of a store.
static enum	DesignStore.Status	How a lookup resolved.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	DEFAULT_CAPACITY	Default maximum number of stored entries per kind.
static final Duration	DEFAULT_TTL	Default time-to-live of a stored plan or optimization result.

Constructor Summary

Constructors

Constructor	Description
DesignStore()	Creates a store with the default TTL (60 minutes) and capacity (20 per kind).
DesignStore(Clock clock, Duration ttl, int capacity)	Creates a store with an explicit clock, TTL and capacity.

Method Summary

Modifier and Type	Method	Description
int	capacity()
String	explainMissing(DesignStore.Kind kind, String id, DesignStore.Status status)	An instruction for the calling model when a lookup did not find a live entry.
DesignStore.Lookup<OptimizationResult>	optimization(String specFingerprint)
List<DesignStore.Entry<OptimizationResult>>	optimizations()
DesignStore.Lookup<DeploymentPlan>	plan(String planId)
List<DesignStore.Entry<DeploymentPlan>>	plans()
DesignStore.Put	putOptimization(OptimizationResult result)	Stores an optimization result under its spec fingerprint.
DesignStore.Put	putPlan(DeploymentPlan plan)	Stores a plan under its content-hash id.
int	size(DesignStore.Kind kind)
Duration	ttl()

Methods inherited from class Object

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

Field Details

DEFAULT_TTL

public static final Duration DEFAULT_TTL

Default time-to-live of a stored plan or optimization result.

DEFAULT_CAPACITY

public static final int DEFAULT_CAPACITY

Default maximum number of stored entries per kind.

See Also:

• Constant Field Values

Constructor Details

DesignStore

public DesignStore()

Creates a store with the default TTL (60 minutes) and capacity (20 per kind).

DesignStore

public DesignStore(Clock clock,
 Duration ttl,
 int capacity)

Creates a store with an explicit clock, TTL and capacity.

Parameters:

clock - the time source used for expiry

ttl - how long an entry stays resolvable

capacity - the maximum number of entries per kind

Method Details

putPlan

public DesignStore.Put putPlan(DeploymentPlan plan)

Stores a plan under its content-hash id.

Parameters:

plan - the plan

Returns:

the id and any plans evicted to make room

putOptimization

public DesignStore.Put putOptimization(OptimizationResult result)

Stores an optimization result under its spec fingerprint.

Parameters:

result - the result; its specFingerprint must be set

Returns:

the id and any results evicted to make room

plan

public DesignStore.Lookup<DeploymentPlan> plan(String planId)

Parameters:

planId - a plan id

Returns:

the lookup outcome; DesignStore.Lookup.entry() is set only when DesignStore.Status.FOUND

optimization

public DesignStore.Lookup<OptimizationResult> optimization(String specFingerprint)

Parameters:

specFingerprint - a spec fingerprint

Returns:

the lookup outcome; DesignStore.Lookup.entry() is set only when DesignStore.Status.FOUND

plans

public List<DesignStore.Entry<DeploymentPlan>> plans()

Returns:

the live plans, oldest first

optimizations

public List<DesignStore.Entry<OptimizationResult>> optimizations()

Returns:

the live optimization results, oldest first

size

public int size(DesignStore.Kind kind)

Parameters:

kind - the kind

Returns:

the number of live entries of that kind

ttl

public Duration ttl()

Returns:

the time-to-live of an entry

capacity

public int capacity()

Returns:

the maximum number of entries per kind

explainMissing

public String explainMissing(DesignStore.Kind kind,
 String id,
 DesignStore.Status status)

An instruction for the calling model when a lookup did not find a live entry.

Parameters:

kind - what was looked up

id - the id that was given

status - the lookup status

Returns:

a sentence saying what happened and how to recover