Forge Pool

Appearance

KV ​

Forge Pool KV is the lightweight platform surface for execution-adjacent state.

It is designed for fast operational storage close to the compute fabric, not as a general-purpose database.

Typical Uses ​

KV is suitable for:

  • job metadata
  • small coordination state
  • replay pointers
  • adapter-side state references
  • artifact indexes
  • external-to-internal identifier mapping

Position in the System ​

KV is not a primitive family. It is a platform surface that supports the broader execution system.

The mental model is:

  • primitive families execute compute
  • platform surfaces support persistence, state, and traceability around compute

Endpoint Overview ​

http
PUT    /v1/kv/key/{key}
GET    /v1/kv/key/{key}
DELETE /v1/kv/key/{key}
POST   /v1/kv/mget
POST   /v1/kv/mset

Example Set Value ​

json
{
  "value": { "state": "ready", "job_id": "01K..." },
  "ttl_seconds": 3600
}

Why KV Exists ​

Distributed execution requires more than raw compute. It requires fast, simple, execution-adjacent truth surfaces for references, coordination, and traceable small-state operations.

That is the role of KV.