Domain Entity Catalog

Domain Entity Catalog

This document is auto-generated from crates/domain/src/. Run ./tools/generate/entity-catalog.sh to refresh it.

The domain crate contains pure business entities with no external dependencies. Each struct and enum listed here represents a named concept in the Inklings problem domain. Module attribution folds submodule directories into their top-level module name (so everything under crates/domain/src/page/ is listed as module page).

Total: 135 types (94 structs, 41 enums).

Structs

Name	Module	Description
AnalyticsEvent	analytics	A single analytics event queued for eventual upload.
Attachment	attachment	An attachment represents a file (image, PDF, etc.) stored alongside page content.
AttachmentParts	attachment	All fields needed to reconstruct an Attachment from storage.
AttachmentReference	attachment	A reference linking an attachment to a page (and optionally a block).
AttachmentSummary	attachment	An attachment with its reference count, for the management view.
StorageBreakdownEntry	attachment	A single entry in the storage usage breakdown.
StorageQuota	attachment	Storage quota limits for a workspace.
StorageUsage	attachment	Aggregated storage usage for a workspace.
UnknownSyncStatus	attachment	Error returned when parsing an unknown sync status string.
AuthUser	auth	An authenticated user account.
Device	auth	A registered device linked to a user account.
BacklinkInfo	backlink	Information about a page that links TO the current page (a backlink).
OutgoingLinkInfo	backlink	Information about a page that the current page links TO (an outgoing link).
Block	block	A block represents a positioned content section within a page.
ImageBlockMetadata	block_content_type	Typed metadata for an Image block variant.
Bookmark	bookmark	A named anchor in the event log timeline.
Channel	channel	A named conversation grouping within a workspace.
ChildPageSummary	child_page_summary	A lightweight summary of a child page for display in folder index pages.
FixedClock	clock	Fixed clock that always returns the same instant.
SystemClock	clock	Default clock backed by the system clock (Utc::now()).
CollectionView	collection_view	Persisted view preferences for one type’s collection.
CollectionViewRow	collection_view	A single page row returned by a collection query.
ColumnConfig	collection_view	Configuration for a single column in a table view.
ContainerRule	container_rule	A rule that auto-assigns a type to children of a folder.
UnknownDepth	container_rule	Error returned when parsing an unknown depth string.
Conversation	conversation	A single agent interaction session within a channel.
DeletedPageInfo	deleted_page	Information about a soft-deleted page for display in the trash view.
EmbeddingStats	embedding	Statistics about the embedding index for a workspace.
SimilarPage	embedding	A page matched by vector similarity search.
EventLogEntry	event_log	A single immutable event in the workspace event log.
PageTimelineEntry	event_log	A unified timeline entry for a page, merging structural events and content
FilteredTreeNode	filtered_tree	A page tree node with a match flag for filtered views.
IconConfig	icon_config	Value object representing an icon configuration.
BlockId	identifiers	Validated block identifier.
DeviceId	identifiers	Validated device identifier.
RefCode	identifiers	A short, stable, URL-safe external reference code for a domain entity.
AnyTypeMetadata	import	Metadata extracted from an AnyType native markdown export.
AnyTypeTypeSummary	import	A summary entry for an AnyType object type discovered during analysis.
ExcludedFolder	import	A folder that was excluded from import with the reason why.
FolderPreview	import	Preview of a folder structure for the import dialog.
FolderPreviewItem	import	An item in the folder preview tree.
ImportAnalysis	import	The result of analyzing an import source before execution.
ImportIssue	import	An issue detected during import analysis.
ImportMode	import	Mode for import operation.
ImportParams	import	Parameters for executing an import.
ImportProgress	import	Progress information during an import operation.
ImportResult	import	Result of executing an import.
ImportedAttachmentFile	import	A non-markdown file discovered during import, to be uploaded as an attachment.
ImportedPageData	import	Data for an imported page, ready to be persisted.
NotionDatabaseSummary	import	A summary of a Notion database discovered during analysis.
NotionMetadata	import	Metadata extracted from a Notion markdown & CSV export.
ObsidianMetadata	import	Metadata extracted from Obsidian vault configuration.
TypeMapping	import	A mapping from a discovered source type to a workspace type.
Layout	layout	A CSS Grid-based page layout definition.
LayoutDefinition	layout_definition	A named layout definition stored in the workspace.
ConversationScratchpad	memory	A conversation scratchpad — ephemeral key-value store for a single conversation.
DecayConfig	memory	Per-tier decay configuration.
MemoryEntry	memory	A single memory entry in the agent memory system.
MemoryQuery	memory	Query parameters for searching the memory store.
ScratchpadEntry	memory	A single entry in a conversation scratchpad.
OllamaModelInfo	ollama	Information about an installed Ollama model.
OllamaStatus	ollama	Status of the local Ollama server.
PullProgress	ollama	Progress update during model pull.
RecommendedModel	ollama	A recommended model for a given hardware tier.
SystemCapabilities	ollama	System hardware capabilities for model selection.
Page	page	A page represents a single markdown file in the vault.
PageParts	page	All fields needed to reconstruct a [Page] from storage.
PageDetail	page_detail	Composite page information for the context panel.
PagePropertyView	page_property	A property and its current value as seen by the UI for a specific page.
PageTreeNode	page_tree	A node in the page tree hierarchy for navigation purposes.
Participant	participant	A participant in a workspace, representing either a human or an agent.
PropertyConfig	property_definition	Configuration for a property definition.
PropertyDefinition	property_definition	A workspace-scoped property definition.
SelectOption	property_definition	A single option for Select or MultiSelect property types.
RecentWorkspace	recent_workspace	A recently accessed workspace entry.
Reference	reference	A reference represents a wiki-style link between pages.
LinkUpdateInfo	rename	Information about a link that will be updated during rename.
RenamePlan	rename	Preview information for a page rename operation.
RenamedPageInfo	rename	Result of a successful page rename operation.
SearchResult	search	A search result representing a matching page.
AgentSettings	settings	Agent-specific settings stored alongside application settings.
NotificationSettings	settings	Notification preferences for agent events.
Settings	settings	Application settings stored in JSON.
Tag	tag	A tag that can be applied to pages for categorization and filtering.
TagGroup	tag	A group of related tags.
TagGroupParts	tag	All fields needed to reconstruct a TagGroup from storage.
TagParts	tag	All fields needed to reconstruct a Tag from storage.
TagSummary	tag	Lightweight tag representation for page display.
TypeAssignment	type_definition	A record that a page has been assigned a specific type.
TypeDefinition	type_definition	A workspace-scoped type definition (e.g. “Page”, “Folder”, or user-defined types).
TemplateProperty	type_template	A property definition within a template.
TypeTemplate	type_template	A read-only type template that can be installed into a workspace.
Workspace	workspace	A workspace represents a vault — a directory containing all of a user’s pages.
WorkspaceName	workspace_name	A validated workspace name that is safe for use as a folder name.

Enums

Name	Module	Description
AttachmentSyncStatus	attachment	Sync status of an attachment relative to cloud storage.
ContentType	attachment	The content type of an attachment, derived from its file extension.
ImageVariant	attachment	Image variant sizes for on-device optimization.
BlockContentType	block_content_type	Content type for a block, determining rendering and behavior.
ImageAlignment	block_content_type	Alignment options for image block display.
ImageScale	block_content_type	Scale options for image block display.
Capability	capability	A medium-grained capability that can be granted to a participant.
ChannelValidationError	channel	Validation errors for channel creation.
ViewMode	collection_view	The display mode for a collection view.
ContainerRuleDepth	container_rule	The depth at which a container rule applies.
ConversationStatus	conversation	Lifecycle status of a conversation.
ConversationTransitionError	conversation	Errors from invalid conversation state transitions.
DomainError	error	Errors that can occur in the domain layer.
EntityType	event_log	The workspace entity that an event applies to.
EventType	event_log	The kind of mutation that occurred.
TimelineEntryType	event_log	Discriminates between structural events (from the event log) and content
ConflictStrategy	import	Strategy for handling conflicts with existing pages.
ExclusionReason	import	Why a folder was excluded from import.
FlattenStrategy	import	Strategy for handling files nested deeper than the target supports.
ImportIssueType	import	Types of issues that can be detected during import analysis.
ImportPhase	import	Phases of an import operation.
ImportSourceType	import	The type of import source detected.
GridType	layout	Grid layout type — currently only CSS Grid is supported.
LayoutCompatibility	layout	Compatibility result when applying a new layout to a page.
MemoryLifetime	memory	The lifetime tier of a memory entry.
MemoryScope	memory	The scope of a memory entry — where it applies.
MemorySource	memory	What produced a memory entry (provenance, not access control).
MemoryValidationError	memory	Validation errors for memory entry creation.
HardwareTier	ollama	Hardware tier classification based on system RAM.
ModelCategory	ollama	Category of model recommendation.
PageType	page_type	The type/category of a page in the workspace.
ParticipantKind	participant	The kind of participant: human user or AI agent.
ParticipantValidationError	participant	Validation error for participant creation.
PropertyValueType	property_definition	The value type of a property definition.
AgentProvider	settings	Agent LLM provider selection.
EditorMode	settings	The user’s preferred editor mode for viewing and editing page content.
SignInMethod	settings	User’s preferred sign-in method.
ThemePreference	settings	User’s preferred theme mode.
UserPersona	settings	User persona representing their primary use case.
AssignmentScope	type_definition	The scope (origin) of a page type assignment.
WorkspaceNameError	workspace_name	Error returned when workspace name validation fails.

---

By Module

analytics

Source: crates/domain/src/analytics

Kind	Name	Description
struct	AnalyticsEvent	A single analytics event queued for eventual upload.

attachment

Source: crates/domain/src/attachment

Kind	Name	Description
enum	AttachmentSyncStatus	Sync status of an attachment relative to cloud storage.
enum	ContentType	The content type of an attachment, derived from its file extension.
enum	ImageVariant	Image variant sizes for on-device optimization.
struct	Attachment	An attachment represents a file (image, PDF, etc.) stored alongside page content.
struct	AttachmentParts	All fields needed to reconstruct an Attachment from storage.
struct	AttachmentReference	A reference linking an attachment to a page (and optionally a block).
struct	AttachmentSummary	An attachment with its reference count, for the management view.
struct	StorageBreakdownEntry	A single entry in the storage usage breakdown.
struct	StorageQuota	Storage quota limits for a workspace.
struct	StorageUsage	Aggregated storage usage for a workspace.
struct	UnknownSyncStatus	Error returned when parsing an unknown sync status string.

auth

Source: crates/domain/src/auth

Kind	Name	Description
struct	AuthUser	An authenticated user account.
struct	Device	A registered device linked to a user account.

backlink

Source: crates/domain/src/backlink

Kind	Name	Description
struct	BacklinkInfo	Information about a page that links TO the current page (a backlink).
struct	OutgoingLinkInfo	Information about a page that the current page links TO (an outgoing link).

block

Source: crates/domain/src/block

Kind	Name	Description
struct	Block	A block represents a positioned content section within a page.

block_content_type

Source: crates/domain/src/block_content_type

Kind	Name	Description
enum	BlockContentType	Content type for a block, determining rendering and behavior.
enum	ImageAlignment	Alignment options for image block display.
enum	ImageScale	Scale options for image block display.
struct	ImageBlockMetadata	Typed metadata for an Image block variant.

bookmark

Source: crates/domain/src/bookmark

Kind	Name	Description
struct	Bookmark	A named anchor in the event log timeline.

capability

Source: crates/domain/src/capability

Kind	Name	Description
enum	Capability	A medium-grained capability that can be granted to a participant.

channel

Source: crates/domain/src/channel

Kind	Name	Description
enum	ChannelValidationError	Validation errors for channel creation.
struct	Channel	A named conversation grouping within a workspace.

child_page_summary

Source: crates/domain/src/child_page_summary

Kind	Name	Description
struct	ChildPageSummary	A lightweight summary of a child page for display in folder index pages.

clock

Source: crates/domain/src/clock

Kind	Name	Description
struct	FixedClock	Fixed clock that always returns the same instant.
struct	SystemClock	Default clock backed by the system clock (Utc::now()).

collection_view

Source: crates/domain/src/collection_view

Kind	Name	Description
enum	ViewMode	The display mode for a collection view.
struct	CollectionView	Persisted view preferences for one type’s collection.
struct	CollectionViewRow	A single page row returned by a collection query.
struct	ColumnConfig	Configuration for a single column in a table view.

container_rule

Source: crates/domain/src/container_rule

Kind	Name	Description
enum	ContainerRuleDepth	The depth at which a container rule applies.
struct	ContainerRule	A rule that auto-assigns a type to children of a folder.
struct	UnknownDepth	Error returned when parsing an unknown depth string.

conversation

Source: crates/domain/src/conversation

Kind	Name	Description
enum	ConversationStatus	Lifecycle status of a conversation.
enum	ConversationTransitionError	Errors from invalid conversation state transitions.
struct	Conversation	A single agent interaction session within a channel.

deleted_page

Source: crates/domain/src/deleted_page

Kind	Name	Description
struct	DeletedPageInfo	Information about a soft-deleted page for display in the trash view.

embedding

Source: crates/domain/src/embedding

Kind	Name	Description
struct	EmbeddingStats	Statistics about the embedding index for a workspace.
struct	SimilarPage	A page matched by vector similarity search.

error

Source: crates/domain/src/error

Kind	Name	Description
enum	DomainError	Errors that can occur in the domain layer.

event_log

Source: crates/domain/src/event_log

Kind	Name	Description
enum	EntityType	The workspace entity that an event applies to.
enum	EventType	The kind of mutation that occurred.
enum	TimelineEntryType	Discriminates between structural events (from the event log) and content
struct	EventLogEntry	A single immutable event in the workspace event log.
struct	PageTimelineEntry	A unified timeline entry for a page, merging structural events and content

filtered_tree

Source: crates/domain/src/filtered_tree

Kind	Name	Description
struct	FilteredTreeNode	A page tree node with a match flag for filtered views.

icon_config

Source: crates/domain/src/icon_config

Kind	Name	Description
struct	IconConfig	Value object representing an icon configuration.

identifiers

Source: crates/domain/src/identifiers

Kind	Name	Description
struct	BlockId	Validated block identifier.
struct	DeviceId	Validated device identifier.
struct	RefCode	A short, stable, URL-safe external reference code for a domain entity.

import

Source: crates/domain/src/import

Kind	Name	Description
enum	ConflictStrategy	Strategy for handling conflicts with existing pages.
enum	ExclusionReason	Why a folder was excluded from import.
enum	FlattenStrategy	Strategy for handling files nested deeper than the target supports.
enum	ImportIssueType	Types of issues that can be detected during import analysis.
enum	ImportPhase	Phases of an import operation.
enum	ImportSourceType	The type of import source detected.
struct	AnyTypeMetadata	Metadata extracted from an AnyType native markdown export.
struct	AnyTypeTypeSummary	A summary entry for an AnyType object type discovered during analysis.
struct	ExcludedFolder	A folder that was excluded from import with the reason why.
struct	FolderPreview	Preview of a folder structure for the import dialog.
struct	FolderPreviewItem	An item in the folder preview tree.
struct	ImportAnalysis	The result of analyzing an import source before execution.
struct	ImportIssue	An issue detected during import analysis.
struct	ImportMode	Mode for import operation.
struct	ImportParams	Parameters for executing an import.
struct	ImportProgress	Progress information during an import operation.
struct	ImportResult	Result of executing an import.
struct	ImportedAttachmentFile	A non-markdown file discovered during import, to be uploaded as an attachment.
struct	ImportedPageData	Data for an imported page, ready to be persisted.
struct	NotionDatabaseSummary	A summary of a Notion database discovered during analysis.
struct	NotionMetadata	Metadata extracted from a Notion markdown & CSV export.
struct	ObsidianMetadata	Metadata extracted from Obsidian vault configuration.
struct	TypeMapping	A mapping from a discovered source type to a workspace type.

layout

Source: crates/domain/src/layout

Kind	Name	Description
enum	GridType	Grid layout type — currently only CSS Grid is supported.
enum	LayoutCompatibility	Compatibility result when applying a new layout to a page.
struct	Layout	A CSS Grid-based page layout definition.

layout_definition

Source: crates/domain/src/layout_definition

Kind	Name	Description
struct	LayoutDefinition	A named layout definition stored in the workspace.

memory

Source: crates/domain/src/memory

Kind	Name	Description
enum	MemoryLifetime	The lifetime tier of a memory entry.
enum	MemoryScope	The scope of a memory entry — where it applies.
enum	MemorySource	What produced a memory entry (provenance, not access control).
enum	MemoryValidationError	Validation errors for memory entry creation.
struct	ConversationScratchpad	A conversation scratchpad — ephemeral key-value store for a single conversation.
struct	DecayConfig	Per-tier decay configuration.
struct	MemoryEntry	A single memory entry in the agent memory system.
struct	MemoryQuery	Query parameters for searching the memory store.
struct	ScratchpadEntry	A single entry in a conversation scratchpad.

ollama

Source: crates/domain/src/ollama

Kind	Name	Description
enum	HardwareTier	Hardware tier classification based on system RAM.
enum	ModelCategory	Category of model recommendation.
struct	OllamaModelInfo	Information about an installed Ollama model.
struct	OllamaStatus	Status of the local Ollama server.
struct	PullProgress	Progress update during model pull.
struct	RecommendedModel	A recommended model for a given hardware tier.
struct	SystemCapabilities	System hardware capabilities for model selection.

page

Source: crates/domain/src/page

Kind	Name	Description
struct	Page	A page represents a single markdown file in the vault.
struct	PageParts	All fields needed to reconstruct a [Page] from storage.

page_detail

Source: crates/domain/src/page_detail

Kind	Name	Description
struct	PageDetail	Composite page information for the context panel.

page_property

Source: crates/domain/src/page_property

Kind	Name	Description
struct	PagePropertyView	A property and its current value as seen by the UI for a specific page.

page_tree

Source: crates/domain/src/page_tree

Kind	Name	Description
struct	PageTreeNode	A node in the page tree hierarchy for navigation purposes.

page_type

Source: crates/domain/src/page_type

Kind	Name	Description
enum	PageType	The type/category of a page in the workspace.

participant

Source: crates/domain/src/participant

Kind	Name	Description
enum	ParticipantKind	The kind of participant: human user or AI agent.
enum	ParticipantValidationError	Validation error for participant creation.
struct	Participant	A participant in a workspace, representing either a human or an agent.

property_definition

Source: crates/domain/src/property_definition

Kind	Name	Description
enum	PropertyValueType	The value type of a property definition.
struct	PropertyConfig	Configuration for a property definition.
struct	PropertyDefinition	A workspace-scoped property definition.
struct	SelectOption	A single option for Select or MultiSelect property types.

recent_workspace

Source: crates/domain/src/recent_workspace

Kind	Name	Description
struct	RecentWorkspace	A recently accessed workspace entry.

reference

Source: crates/domain/src/reference

Kind	Name	Description
struct	Reference	A reference represents a wiki-style link between pages.

rename

Source: crates/domain/src/rename

Kind	Name	Description
struct	LinkUpdateInfo	Information about a link that will be updated during rename.
struct	RenamePlan	Preview information for a page rename operation.
struct	RenamedPageInfo	Result of a successful page rename operation.

search

Source: crates/domain/src/search

Kind	Name	Description
struct	SearchResult	A search result representing a matching page.

settings

Source: crates/domain/src/settings

Kind	Name	Description
enum	AgentProvider	Agent LLM provider selection.
enum	EditorMode	The user’s preferred editor mode for viewing and editing page content.
enum	SignInMethod	User’s preferred sign-in method.
enum	ThemePreference	User’s preferred theme mode.
enum	UserPersona	User persona representing their primary use case.
struct	AgentSettings	Agent-specific settings stored alongside application settings.
struct	NotificationSettings	Notification preferences for agent events.
struct	Settings	Application settings stored in JSON.

tag

Source: crates/domain/src/tag

Kind	Name	Description
struct	Tag	A tag that can be applied to pages for categorization and filtering.
struct	TagGroup	A group of related tags.
struct	TagGroupParts	All fields needed to reconstruct a TagGroup from storage.
struct	TagParts	All fields needed to reconstruct a Tag from storage.
struct	TagSummary	Lightweight tag representation for page display.

type_definition

Source: crates/domain/src/type_definition

Kind	Name	Description
enum	AssignmentScope	The scope (origin) of a page type assignment.
struct	TypeAssignment	A record that a page has been assigned a specific type.
struct	TypeDefinition	A workspace-scoped type definition (e.g. “Page”, “Folder”, or user-defined types).

type_template

Source: crates/domain/src/type_template

Kind	Name	Description
struct	TemplateProperty	A property definition within a template.
struct	TypeTemplate	A read-only type template that can be installed into a workspace.

workspace

Source: crates/domain/src/workspace

Kind	Name	Description
struct	Workspace	A workspace represents a vault — a directory containing all of a user’s pages.

workspace_name

Source: crates/domain/src/workspace_name

Kind	Name	Description
enum	WorkspaceNameError	Error returned when workspace name validation fails.
struct	WorkspaceName	A validated workspace name that is safe for use as a folder name.