Skip to main content

Glossary

This glossary defines the naming conventions and runtime terms used across Acolyte’s lifecycle, tools, memory, protocol, storage, and TUI.

Naming conventions

SuffixExampleMeaning
Domain nounSession, TaskIn-memory domain entity used by core logic
*RecordSessionRecord, TaskRecordOne persisted entity record
*EntryMemoryContextEntry, queue entryOne runtime/pipeline item (non-persisted by default)
*StateSessionStateAggregate runtime/persisted state container
*ContractTaskContract, StatusContractBoundary shape for protocol/config/transport
*StoreSessionStore, TaskStoreBehavior interface for persistence operations
*SchemasessionSchema, taskSchemaZod runtime validator and source of truth for unions
*InputPhasePrepareInput, LifecycleInputOperation-specific input payload
*OutputCliOutputOperation-specific output payload

Core terms

TermDefinition
BackendWhere Acolyte’s persistence and future remote execution are hosted — local or cloud; the deployment level, broader than Storage and distinct from Provider
Base Agent InputImmutable prompt input created during prepare and used for the generation pass
Chat PromotionState transition that moves completed chat rows from the active (re-rendered) region to static (write-once scrollback)
Chat ViewportThe whole live chat surface — header, transcript, pending, composer, and footer — modeled as one ordered semantic unit and laid out by terminal layout
ChatRowOne display block in the chat transcript; may render as many visual lines (e.g. a usage summary or status panel)
ChatViewportPresentationSemantic, renderer-independent description of the chat viewport derived from the presentation input; consumed by terminal layout to produce a Terminal Scene
ChatViewportPresentationInputLossless per-render snapshot of live chat state that chat-state publishes as the input payload for viewport presentation; carries raw state only, no derived wording or layout
Cloud SyncFeature that syncs memory and sessions to a hosted cloud API for portable agent identity across machines
CloudClientHTTP client that implements MemoryStore and SessionStore against the cloud API
ComposerThe chat input surface — prompt text, cursor, picker, suggestions, help, and status — modeled semantically and laid out by terminal layout
Context BudgetingToken allocation strategy that reserves system space first and fills the remaining budget by priority
DistillMemory source that extracts observations from conversations at project, user, or session scope
Ecosystem DetectorPluggable rule that identifies the workspace type and resolves available tooling
EffectLifecycle-owned side-effect applied per-tool-result via callback (format, lint)
EmbeddingProvider-generated vector representation of a memory record used for semantic recall
EntryRuntime or pipeline item used during processing and not necessarily persisted
Frozen OverflowTUI renderer optimization where active content lines that exceed the viewport are written once to scrollback and excluded from subsequent re-renders
HostRuntime environment around the model that provides tools, lifecycle structure, and memory
Hybrid RecallRelevance-ranked memory selection using a weighted blend of cosine similarity and TF-IDF token overlap
Input ControllerRenderer-independent owner of the composer’s logical text and cursor; reduceInput applies edit actions with no terminal geometry
Lifecycle PolicyCentralized limits and defaults for lifecycle behavior
Lifecycle StateInternal task-scoped runtime state used during the lifecycle pass
Memory DistillerExtracts and commits observations from conversations after each request
Memory CorpusActive, recallable memory records across the scopes visible to a request; archived records are excluded
Memory EngineTop-level memory capability that maintains continuity across turns
Memory PipelineInternal memory flow from ingest through commit
Memory PolicyCentralized limits and defaults for memory behavior
Memory ToolkitOn-demand tools (memory-search, memory-add) the model invokes to access memory at runtime
Message KindSemantic message classification used by history handling (text, tool_payload)
Model JudgmentThe model’s responsibility for deciding how to complete the task within host constraints
ObservationMemory record kind for facts extracted from conversations via memory-observe tool calls
PolicyCentralized subsystem rules, limits, or defaults that make intended behavior explicit without owning the implementation
ProviderModel service selected for a request (openai, anthropic, google, or vercel)
RecordPersisted entity object stored by a persistence layer
RegistryComposition layer that wires implementations into an agent-facing surface under shared contracts
Resource IDTyped cross-session identity key used for memory and execution scoping
SessionOne chat session in memory, including messages, model, token usage, and timestamps
SessionRecordOne stored session record
SessionStateAggregate session state (sessions[], activeSessionId)
SessionStoreRead/write/create interface for session persistence
SkillDeclarative prompt extension defined in a SKILL.md file with metadata and compatibility constraints
Skill RosterAmbient per-turn line listing the activatable (non-active) skills and their descriptions, from which the model selects via skill-activate; the selection surface, distinct from the loaded-skill store
Step BudgetPer-turn tool-call limit inlined into tool execution to prevent runaway loops
StorageThe persistence mechanism a *Store uses for memory and session records — sqlite (local) or cloud
TaskLifecycle work request moving through accept, queue, run, and terminal states
Task QueueRuntime queue policy that orders accepted tasks and enforces capacity and cancellation boundaries
Terminal ScenePhysical styled lines, cursor geometry, and finalizable section identities produced by terminal layout for the renderer
Terminal ThemeFixed internal mapping of semantic style roles to terminal-neutral styles; not user-configurable theming
TF-IDFTerm Frequency–Inverse Document Frequency; weights token matches by rarity across the memory corpus so uncommon terms score higher
Token OverlapKeyword matching component of hybrid recall that catches exact term matches embeddings miss
ToolkitGroup of domain tools exposed through adapters and composition
TranscriptRowSemantic transcript entry (message, tool, command, or tasklist) with a stable id and lifecycle state; the persisted successor to ChatRow
TurnOne model response to a user message, including all tool calls within that response
Workspace CommandTyped shell command descriptor used for lint, format, and test commands
Workspace ProfileCached per-workspace detection result containing ecosystem, package manager, and commands