tesseract

README

Tesseract

Tesseract is a local-first context, memory, knowledge, event, and workspace service for people, tools, and AI agents. Its revisioned domains keep append-only history; workspace holds one mutable current value with optimistic concurrency and identity tombstones. Tesseract applies namespace and capability policy and exposes the store through a Go library, CLI, HTTP API, embedded web UI, and MCP server.

Public preview, pre-1.0. Tesseract is in active daily internal use across Hollis Labs — it's the memory this very session type recalls from and writes back to. Tagged public previews are available; built in the open: contracts are documented and tested, but breaking changes can still land in any minor. Read CHANGELOG.md before upgrading.

What it is today

• revisioned context records with deterministic heads and history
• separate memory and pointer-backed knowledge domains
• mutable project workspace items with stable IDs and version tokens
• namespace ownership and scoped capability tokens
• authorized service credential rotation with bounded overlap and metadata-only retries
• explicit request, approval, and apply stages for cross-namespace promotion
• lexical recall plus optional OpenAI-backed embeddings and synthesis
• a local operator UI embedded in the Go binary
• integrity-checked, failure-atomic store backup and restore

Where it sits in the stack

   agents / apps       Nanite, Torque, Tangent, or any MCP/HTTP client
        │
   ┌───────────┐
   │ Tesseract │   context + memory + knowledge + event + workspace
   └───────────┘
        │
     storage           local, append-only log — no external database

Tesseract doesn't run agents and doesn't decide anything — it's not an agent runtime, task tracker, or orchestrator (that's Nanite's, Torque's, and Tangent's job). It only stores, revises, and retrieves; anything that speaks MCP, HTTP, or the Go library reads and writes the same way.

Examples

Daily use. This session, like every session across the portfolio, recalls prior context and decisions from Tesseract at the start of a task (tesseract_recall) and writes durable decisions, follow-ups, and handoffs back to it once the work is reviewed (the capture-decision / capture-handoff skills).

Composition. An agent picks up a task from Torque, recalls relevant history from Tesseract before starting, does the work in Nanite, and writes the outcome back to Tesseract — three MCP servers, none aware of the others' internals, composed only through the agent's own tool calls.

Shared or isolated memory. Any app in the portfolio can point at the same Tesseract instance to share one memory surface, or run against a private instance when isolation matters more than sharing — the namespace and capability-token model is what makes either safe.

Roadmap

• Public-preview hardening, sequenced deliberately: repository behavior, safety, and data/contract integrity first; install experience and the public-facing surface once the code is near final; CI, branch protection, and release gates last, as an audit pass rather than a 1.0 feature push.
• Portfolio MCP standardization: moving onto a shared MCP server/client library built on modelcontextprotocol/go-sdk, retiring the hand-rolled hollis-labs/go-mcp layer — a change that lands across every app in the portfolio, including this one.
• Deferred, post-preview: richer recall, graph/entity memory, procedural/playbook memory, provenance and descendant retraction, and write-time enrichment — scoped from real public-preview usage, not committed to yet.

Go library dependencies

From v0.11.0, Tesseract uses the published libs modules (core/util, llm/core, mcp/plugin-mcp, ui/ui-go). Embedded consumers supplying an embedder to WithEmbedder must import github.com/hollis-labs/libs/llm/core/embedcontracts; consumers supplying a queue to WithQueue must import github.com/hollis-labs/libs/core/util/queue. The old standalone paths define different Go types. Update these dependencies together when upgrading an embedded consumer.

Install from source

The current preview is distributed as source. There are no supported prebuilt binaries, package-manager formulae, container images, or desktop installers.

Requirements:

• Go 1.26.8 or newer
• Git
• Node.js 20.19–20.x or 22.12+ with npm only when changing and rebuilding frontend/

git clone https://github.com/hollis-labs/tesseract.git
cd tesseract
make build
./tesseract --version

make build compiles the committed web UI bundle and needs only Go. Use make install to install the binary into your Go bin directory. Frontend contributors use make build-all or regenerate the embedded bundle explicitly.

Quick start

Inspect the paths Tesseract will use before creating data:

./tesseract path

Start the daemon:

./tesseract serve

The default listener is http://127.0.0.1:8089: loopback-only, guarded by go-auth in permissive mode (nothing rejected, callers without a bearer are reported; flip to enforce in config.yaml, see docs/auth.md). The API is under /v1/, and the web UI is at /.

In another terminal, write and read a context record:

./tesseract context put \
  --client-id demo \
  --namespace app/demo/session \
  --key goal \
  --actor app:demo \
  --json '{"objective":"evaluate tesseract"}'

./tesseract context get \
  --namespace app/demo/session \
  --key goal

Provider credentials are optional. Core context, memory, knowledge, lexical recall, CLI, HTTP, UI, and MCP workflows work without them. To enable embeddings or synthesis, copy one of the sample configs to the config-file reported by tesseract path and store the keys with secrets set (see docs/secrets.md; environment variables are not read):

• examples/config.openai.yaml
• examples/config.anthropic-openai.yaml
• env.example

The type vocabularies Tesseract validates writes against are yours to revise, in the optional types-file reported by tesseract path. See examples/types.yaml and Type vocabularies.

Provider-backed features transmit selected content to the configured provider. Review the data egress table before enabling them.

The complete first-run flow is in docs/QUICKSTART.md.

Network and authentication boundary

Tesseract refuses a non-loopback bind without a token mode, and the go-auth guard defaults to enforce there (docs/auth.md). For remote access, choose managed authentication or a static token:

# Create a managed token before starting managed-auth mode.
./tesseract context token create \
  --name remote-client \
  --client-id app:remote-client \
  --scopes write,promote.request,packet \
  --namespaces 'app/remote-client/*' \
  --ttl 24h \
  --secret-file ./remote-client.token   # new 0600 file; the token is never printed

./tesseract serve --managed-auth --addr 0.0.0.0:8089

export TESSERACT_TOKEN='replace-with-a-long-random-token'
./tesseract serve --static-token "$TESSERACT_TOKEN" --addr 0.0.0.0:8089

When either token mode is active, every HTTP route requires Authorization: Bearer <token> except readiness and the optional metrics endpoint. A static token deliberately has no admin scope. Mutating the runtime settings or its config backups therefore requires managed auth and a managed token created with the explicit admin scope (that token requires --secret-file and explicit, literal-rooted --namespaces globs).

Authentication is not transport encryption. Tesseract has no built-in TLS; put any remotely reachable listener behind TLS, a VPN, an SSH tunnel, or a trusted TLS-terminating reverse proxy. See SECURITY.md.

MCP

Tesseract can run as an MCP stdio server; a separate HTTP daemon is not required:

./tesseract mcp --token-file /path/to/protected/token

The token is read once at startup: --token-file takes precedence over a nonblank TESSERACT_MCP_TOKEN, which takes precedence over the legacy --token flag. An unreadable or empty token file fails startup. Keep token files outside source control with mode 0600. Environment input removes the token from argv, but same-user processes can still read the process environment on Linux.

Use examples/mcp.json as a client configuration starting point. The token controls mutations, memory/knowledge read scopes, and some namespace filtering, but it is not a complete read-isolation boundary for the local stdio server. See docs/AGENT-SETUP.md and docs/MCP_TOOLS.md. The observation-only tesseract_runtime_get tool reports executable staleness; see its evidence and platform limits.

Backup before real use

A current backup is a directory containing a whole-database snapshot, record payloads, and a checksummed manifest. Configuration is included only when --config is supplied.

./tesseract context backup export \
  --out "$PWD/tesseract-backup" \
  --config /path/reported/by/tesseract-path/config.yaml

./tesseract context backup verify --in "$PWD/tesseract-backup"

Stop every daemon and MCP process that uses the store before restoring. Restore replaces the destination; it does not merge. Detailed recovery and upgrade guidance is in docs/OPERATIONS.md.

Documentation

• docs/README.md — documentation index
• docs/QUICKSTART.md — installation and first run
• docs/AGENT-SETUP.md — MCP client setup
• docs/OPERATIONS.md — support, auth, egress, backup, and upgrades
• docs/ARCHITECTURE.md — storage and service design
• docs/SPECS/API.md — HTTP contract
• docs/SPECS/CLI.md — CLI contract
• docs/MCP_TOOLS.md — MCP tool catalog
• SECURITY.md — security policy and deployment boundary
• CONTRIBUTING.md — contribution workflow

Develop

make test
make validate
go vet ./...

See CONTRIBUTING.md for the complete contributor checks.

License

Tesseract is released under the MIT License.

Documentation

Index

• Constants
• Variables
• func NewEmbedHandler(memStore *memory.Store, model string, logger func(string, ...any)) queue.Handler
• type CanonicalReference
• type Config
• type ItemMetadata
• type ItemReadResult
• type ItemRecallResult
• type ItemTouchResult
• type Option
  • func WithDedupThreshold(t float64) Option
  • func WithEmbedder(e embedcontracts.Embedder) Option
  • func WithEmbeddingModel(model string) Option
  • func WithLogger(fn func(string, ...any)) Option
  • func WithQueue(q queue.Queue) Option
• type PagedItemRecall
• type PromotionApply
• type PromotionApplyReceipt
• type PromotionApproval
• type PromotionApprovalReceipt
• type PromotionRequest
• type PromotionRequestReceipt
• type PromotionTarget
• type PromotionTargetReference
• type ReferenceKind
• type ReferenceResolution
• type ReferenceResolutionStatus
• type ReferenceSelector
• type SearchOptions
• type Tesseract
  • func Open(ctx context.Context, cfg Config, opts ...Option) (*Tesseract, error)
  • func (c *Tesseract) ApplyWorkspacePromotion(ctx context.Context, in WorkspacePromotionApply) (WorkspacePromotionApplyReceipt, error)
  • func (c *Tesseract) ApplyWorkspaceRetention(ctx context.Context, in workspace.RetentionApplyInput) (workspace.RetentionApplyReport, error)
  • func (c *Tesseract) ApproveWorkspacePromotion(ctx context.Context, in WorkspacePromotionApproval) (WorkspacePromotionApprovalReceipt, error)
  • func (c *Tesseract) Close() error
  • func (c *Tesseract) CreateWorkspaceItem(ctx context.Context, in workspace.CreateRequest) (workspace.MutationReceipt, error)
  • func (c *Tesseract) DeleteWorkspaceItem(ctx context.Context, in workspace.DeleteInput) (workspace.DeleteReceipt, error)
  • func (c *Tesseract) EditWorkspaceItem(ctx context.Context, in workspace.EditInput) (workspace.MutationReceipt, error)
  • func (c *Tesseract) Embed(ctx context.Context, recordID string) error
  • func (c *Tesseract) EmbedRevision(ctx context.Context, revisionID string) error
  • func (c *Tesseract) GetCurrentItem(ctx context.Context, itemID string) (memory.Revision, error)
  • func (c *Tesseract) GetCurrentRevision(ctx context.Context, namespace, key string) (memory.Revision, error)
  • func (c *Tesseract) GetItemHistory(ctx context.Context, itemID string) ([]memory.Revision, error)
  • func (c *Tesseract) GetRevisionHistory(ctx context.Context, namespace, key string) ([]memory.Revision, error)
  • func (c *Tesseract) MemoryStore() *memory.Store
  • func (c *Tesseract) ReadItem(ctx context.Context, itemID string) (ItemReadResult, error)
  • func (c *Tesseract) ReadWorkspaceCurrent(ctx context.Context, namespace, key string) (WorkspaceItem, error)
  • func (c *Tesseract) RecallItems(ctx context.Context, in memory.RecallInput, page memory.PageRequest) (PagedItemRecall, error)
  • func (c *Tesseract) RecallMemory(ctx context.Context, in memory.RecallInput) ([]memory.RecallResult, error)
  • func (c *Tesseract) ReportWorkspaceRetention(ctx context.Context, in workspace.RetentionReportInput) (workspace.RetentionReport, error)
  • func (c *Tesseract) RequestWorkspacePromotion(ctx context.Context, in WorkspacePromotionRequest) (WorkspacePromotionRequestReceipt, error)
  • func (c *Tesseract) ResolveReference(ctx context.Context, selector ReferenceSelector) (ReferenceResolution, error)
  • func (c *Tesseract) Search(ctx context.Context, query string, opts SearchOptions) ([]embedding.SearchResult, error)
  • func (c *Tesseract) Store() *contextstore.Store
  • func (c *Tesseract) TouchItems(ctx context.Context, itemIDs []string) (ItemTouchResult, error)
  • func (c *Tesseract) WorkspaceStore() *workspace.Store
  • func (c *Tesseract) WriteMemory(ctx context.Context, in memory.WriteInput) (memory.Revision, error)
• type WorkspaceItem
• type WorkspacePromotionApply
• type WorkspacePromotionApplyReceipt
• type WorkspacePromotionApproval
• type WorkspacePromotionApprovalReceipt
• type WorkspacePromotionRequest
• type WorkspacePromotionRequestReceipt
• type WorkspacePromotionTarget
• type WorkspacePromotionTargetReference

Constants

const (
	ReferenceResolved     = itemservice.ResolutionResolved
	ReferenceDeleted      = itemservice.ResolutionDeleted
	ReferenceNotFound     = itemservice.ResolutionNotFound
	ReferenceAmbiguous    = itemservice.ResolutionAmbiguous
	ReferenceUnsupported  = itemservice.ResolutionUnsupportedReference
	ReferenceKindItem     = itemservice.ReferenceKindItem
	ReferenceKindRevision = itemservice.ReferenceKindRevision
)

Variables

var (
	ErrWorkspacePromotionInvalidInput      = promotion.ErrInvalidInput
	ErrWorkspacePromotionNotFound          = promotion.ErrNotFound
	ErrWorkspacePromotionSourceNotFound    = promotion.ErrSourceNotFound
	ErrWorkspacePromotionSourceDeleted     = promotion.ErrSourceDeleted
	ErrWorkspacePromotionSourceStale       = promotion.ErrSourceStale
	ErrWorkspacePromotionTargetStale       = promotion.ErrTargetStale
	ErrWorkspacePromotionTargetKeyOccupied = promotion.ErrTargetKeyOccupied
	ErrWorkspacePromotionNotApproved       = promotion.ErrNotApproved
)

var ErrEmbedderUnavailable = memory.ErrEmbedderUnavailable

ErrEmbedderUnavailable is returned when an embedding operation is attempted but no embedder has been configured on the Tesseract instance. It is the same sentinel exposed by memory.ErrEmbedderUnavailable.

var ErrInvalidReference = itemservice.ErrInvalidReference

var ErrItemHistoryUnavailable = itemservice.ErrHistoryUnavailable

ErrItemHistoryUnavailable reports that a mutable item retains no revisions.

var ErrReferenceBackendUnavailable = itemservice.ErrBackendUnavailable

Functions

func NewEmbedHandler

func NewEmbedHandler(memStore *memory.Store, model string, logger func(string, ...any)) queue.Handler

NewEmbedHandler returns a queue.Handler that processes embed jobs. The handler decodes the revision ID from the job payload and calls EmbedRevision on the memory store to generate and persist the embedding.

Types

type CanonicalReference

type CanonicalReference = itemservice.CanonicalReference

type Config

type Config struct {
	// RootDir is the base directory of the tesseract data layout. When DBPath
	// and RecordsDir are empty, the main database and JSON record tree are
	// derived under RootDir/data/ — the layout embedded consumers (nanite,
	// tesseract lib v0.7.0) rely on. RootDir is always required.
	RootDir string

	// DBPath, when set, is the explicit path to the main context database,
	// overriding the RootDir/data/index/context.db derivation.
	//
	// RecordsDir, when set, is the explicit JSON record tree, overriding
	// RootDir/data/records.
	//
	// These let a go-apppaths-resolved caller (cmd/tesseract, cmd/smoke) point
	// the library at the XDG layout without changing default behavior for
	// RootDir-only consumers. Added for the go-apppaths migration
	// (CW-20260517-0066).
	DBPath     string
	RecordsDir string
}

Config holds the top-level configuration for a Tesseract instance.

type ItemMetadata

type ItemMetadata = itemservice.Metadata

ItemMetadata identifies an item's domain and authorization namespace without content.

type ItemReadResult

type ItemReadResult = itemservice.ReadResult

ItemReadResult contains exactly one current revision or workspace item.

type ItemRecallResult

type ItemRecallResult = itemservice.RecallResult

ItemRecallResult contains exactly one typed revision or workspace result.

type ItemTouchResult

type ItemTouchResult = itemservice.TouchResult

ItemTouchResult reports item identities that moved or could not be reinforced.

type Option

type Option func(*options)

Option is a functional option for Open.

func WithDedupThreshold

func WithDedupThreshold(t float64) Option

WithDedupThreshold sets the similarity threshold for semantic dedup.

func WithEmbedder

func WithEmbedder(e embedcontracts.Embedder) Option

WithEmbedder sets the embedding provider used for vector indexing.

func WithEmbeddingModel

func WithEmbeddingModel(model string) Option

WithEmbeddingModel sets the model name passed to the embedder.

func WithLogger

func WithLogger(fn func(string, ...any)) Option

WithLogger sets a custom log function (defaults to log.Printf).

func WithQueue

func WithQueue(q queue.Queue) Option

WithQueue sets the background job queue used for async embedding. When set, a worker is started automatically and a QueueAdapter is used instead of the default NoopQueue.

type PagedItemRecall

type PagedItemRecall = itemservice.PagedRecall

PagedItemRecall is a projected typed recall page and its manifest.

type PromotionApply

type PromotionApply = promotion.ApplyInput

type PromotionApplyReceipt

type PromotionApplyReceipt = promotion.ApplyReceipt

type PromotionApproval

type PromotionApproval = promotion.ApproveInput

type PromotionApprovalReceipt

type PromotionApprovalReceipt = promotion.ApprovalReceipt

type PromotionRequest

type PromotionRequest = promotion.RequestInput

type PromotionRequestReceipt

type PromotionRequestReceipt = promotion.RequestReceipt

type PromotionTarget

type PromotionTarget = promotion.Target

PromotionTarget aliases promotion.Target for cross-domain promotions.

type PromotionTargetReference

type PromotionTargetReference = promotion.TargetReference

type ReferenceKind

type ReferenceKind = itemservice.ReferenceKind

type ReferenceResolution

type ReferenceResolution = itemservice.ReferenceResolution

ReferenceResolution is the identity-only normalization result.

type ReferenceResolutionStatus

type ReferenceResolutionStatus = itemservice.ResolutionStatus

type ReferenceSelector

type ReferenceSelector = itemservice.ReferenceSelector

ReferenceSelector accepts one typed object ID, one complete legacy key, or one canonical Tesseract URI.

type SearchOptions

type SearchOptions struct {
	Limit      int
	Threshold  float64
	Namespaces []string
	Types      []string
}

SearchOptions controls the behavior of a Search call.

type Tesseract

type Tesseract struct {
	// contains filtered or unexported fields
}

Tesseract is the top-level library handle. Create one via Open().

func Open

func Open(ctx context.Context, cfg Config, opts ...Option) (*Tesseract, error)

Open creates a Tesseract instance rooted at cfg.RootDir, initializing the SQLite store, memory subsystem, and decay goroutine.

func (*Tesseract) ApplyWorkspacePromotion

func (c *Tesseract) ApplyWorkspacePromotion(ctx context.Context, in WorkspacePromotionApply) (WorkspacePromotionApplyReceipt, error)

func (*Tesseract) ApplyWorkspaceRetention

func (c *Tesseract) ApplyWorkspaceRetention(ctx context.Context, in workspace.RetentionApplyInput) (workspace.RetentionApplyReport, error)

ApplyWorkspaceRetention transactionally rechecks and purges named items.

func (*Tesseract) ApproveWorkspacePromotion

func (c *Tesseract) ApproveWorkspacePromotion(ctx context.Context, in WorkspacePromotionApproval) (WorkspacePromotionApprovalReceipt, error)

func (*Tesseract) Close

func (c *Tesseract) Close() error

Close stops the decay goroutine and closes the underlying store.

func (*Tesseract) CreateWorkspaceItem

func (c *Tesseract) CreateWorkspaceItem(ctx context.Context, in workspace.CreateRequest) (workspace.MutationReceipt, error)

func (*Tesseract) DeleteWorkspaceItem

func (c *Tesseract) DeleteWorkspaceItem(ctx context.Context, in workspace.DeleteInput) (workspace.DeleteReceipt, error)

func (*Tesseract) EditWorkspaceItem

func (c *Tesseract) EditWorkspaceItem(ctx context.Context, in workspace.EditInput) (workspace.MutationReceipt, error)

func (*Tesseract) Embed

func (c *Tesseract) Embed(ctx context.Context, recordID string) error

Embed generates and stores a vector embedding for the record identified by recordID. It fetches the record from the store, extracts embeddable text, calls the configured embedder, and upserts the resulting vector.

func (*Tesseract) EmbedRevision

func (c *Tesseract) EmbedRevision(ctx context.Context, revisionID string) error

EmbedRevision generates and stores an embedding for a memory revision.

func (*Tesseract) GetCurrentItem

func (c *Tesseract) GetCurrentItem(ctx context.Context, itemID string) (memory.Revision, error)

GetCurrentItem returns an item's current revision by stable item_id.

func (*Tesseract) GetCurrentRevision

func (c *Tesseract) GetCurrentRevision(ctx context.Context, namespace, key string) (memory.Revision, error)

GetCurrentRevision returns the current revision for a namespace/key pair.

func (*Tesseract) GetItemHistory

func (c *Tesseract) GetItemHistory(ctx context.Context, itemID string) ([]memory.Revision, error)

GetItemHistory returns an item's immutable revisions by stable item_id, newest first.

func (*Tesseract) GetRevisionHistory

func (c *Tesseract) GetRevisionHistory(ctx context.Context, namespace, key string) ([]memory.Revision, error)

GetRevisionHistory returns all revisions for a namespace/key pair, newest first.

func (*Tesseract) MemoryStore

func (c *Tesseract) MemoryStore() *memory.Store

MemoryStore returns the underlying memory.Store.

func (*Tesseract) ReadItem

func (c *Tesseract) ReadItem(ctx context.Context, itemID string) (ItemReadResult, error)

func (*Tesseract) ReadWorkspaceCurrent

func (c *Tesseract) ReadWorkspaceCurrent(ctx context.Context, namespace, key string) (WorkspaceItem, error)

func (*Tesseract) RecallItems

func (c *Tesseract) RecallItems(ctx context.Context, in memory.RecallInput, page memory.PageRequest) (PagedItemRecall, error)

func (*Tesseract) RecallMemory

func (c *Tesseract) RecallMemory(ctx context.Context, in memory.RecallInput) ([]memory.RecallResult, error)

RecallMemory retrieves memories by namespace, ranking, and filters.

func (*Tesseract) ReportWorkspaceRetention

func (c *Tesseract) ReportWorkspaceRetention(ctx context.Context, in workspace.RetentionReportInput) (workspace.RetentionReport, error)

ReportWorkspaceRetention evaluates a stable page without reading payloads or recording use.

func (*Tesseract) RequestWorkspacePromotion

func (c *Tesseract) RequestWorkspacePromotion(ctx context.Context, in WorkspacePromotionRequest) (WorkspacePromotionRequestReceipt, error)

func (*Tesseract) ResolveReference

func (c *Tesseract) ResolveReference(ctx context.Context, selector ReferenceSelector) (ReferenceResolution, error)

ResolveReference normalizes a supported reference without reading content, reinforcing access, or changing stored state.

func (*Tesseract) Search

func (c *Tesseract) Search(ctx context.Context, query string, opts SearchOptions) ([]embedding.SearchResult, error)

Search embeds the query string and returns the top matching records ranked by cosine similarity against all stored embeddings for the configured model.

func (*Tesseract) Store

func (c *Tesseract) Store() *contextstore.Store

Store returns the underlying contextstore.Store.

func (*Tesseract) TouchItems

func (c *Tesseract) TouchItems(ctx context.Context, itemIDs []string) (ItemTouchResult, error)

func (*Tesseract) WorkspaceStore

func (c *Tesseract) WorkspaceStore() *workspace.Store

WorkspaceStore returns the mutable workspace store.

func (*Tesseract) WriteMemory

func (c *Tesseract) WriteMemory(ctx context.Context, in memory.WriteInput) (memory.Revision, error)

WriteMemory writes a new memory revision.

type WorkspaceItem

type WorkspaceItem = itemservice.WorkspaceItem

WorkspaceItem is the public current workspace response shape.

type WorkspacePromotionApply

type WorkspacePromotionApply = promotion.ApplyInput

type WorkspacePromotionApplyReceipt

type WorkspacePromotionApplyReceipt = promotion.ApplyReceipt

type WorkspacePromotionApproval

type WorkspacePromotionApproval = promotion.ApproveInput

type WorkspacePromotionApprovalReceipt

type WorkspacePromotionApprovalReceipt = promotion.ApprovalReceipt

type WorkspacePromotionRequest

type WorkspacePromotionRequest = promotion.RequestInput

type WorkspacePromotionRequestReceipt

type WorkspacePromotionRequestReceipt = promotion.RequestReceipt

type WorkspacePromotionTarget

type WorkspacePromotionTarget = promotion.Target

type WorkspacePromotionTargetReference

type WorkspacePromotionTargetReference = promotion.TargetReference