application

type Access string

type AccessResolver interface {
	ResolvePrincipal(context.Context, RequestIdentity) (Principal, error)
	ListProjects(context.Context, Principal) (ProjectList, error)
	ResolveProject(context.Context, Principal, ProjectID, Access) (*ProjectRuntime, error)
	ResolveDependency(context.Context, Principal, ProjectID, string) (*ProjectRuntime, error)
}

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

type ApplicationError struct {
	Code       ErrorCode
	Message    string
	Project    ProjectRef
	Action     *ProjectAction
	ApplyState ApplyState
	Revision   string
	Version    uint32
	Holder     *SessionHolder
	Cause      error
}

type AppliedMutation struct {
	Project  ProjectID
	BatchID  string
	Revision string
	Batch    MutationBatch
}

type ApplyResult struct {
	State    ApplyState
	Revision string
}

type ApplyState string

type AttachmentMaterialization struct {
	BlobID      string
	Digest      BlobDigest
	Size        int64
	SourceName  string
	LogicalPath string
}

type AttachmentPage struct {
	Filename   string
	Content    []byte
	Offset     int64
	NextOffset int64
	TotalSize  int64
	More       bool
	Digest     BlobDigest
}

type Author struct {
	Name  string
	Email string
}

type BindSessionRequest struct {
	SessionID     SessionID
	MCPSessionID  string
	ClientName    string
	ClientVersion string
	Chooser       ChooserKind
	Takeover      bool
}

type BindSessionResult struct {
	Project ProjectRef
	Binding SessionBinding
	Created bool
}

type BlobDigest struct {
	Algorithm string
	Value     string
}

type BlobOwner struct {
	Subject string
	Session SessionID
}

type CanonicalChunk struct {
	ID      string
	EntryID string
	Ordinal int
	// Revision is deprecated: graph revision is a mutation-concurrency token,
	// never a vector-freshness token (d-cpt-65i). Reconciliation and hit
	// validity ignore it. Retained only for source compatibility.
	Revision    string
	ContentHash string
	Text        string
	// The following persisted citation and identity fields carry everything a
	// store needs to render a citation and answer entry-presence queries
	// without re-deriving chunks. Both the CLI indexer and the application
	// vector search populate them through the shared chunk-derivation helper.
	Body                 string
	Breadcrumb           []string
	Depth                int
	IsSummary            bool
	IsAttachment         bool
	SourceAttachmentPath string
	// EntryHash is the entry-state hash (entry content + summary + attachment
	// bytes) — the same definition as the CLI manifest state hash.
	EntryHash string
}

type ChooserKind string

type CreateEntryResult struct {
	Project  ProjectRef
	Binding  SessionBinding
	EntryID  string
	Summary  string
	Findings []Finding
}

type DocumentChange struct {
	LogicalPath    string
	Document       *EntryDocument
	CanonicalBytes []byte
	Delete         bool
}

type EmbeddingExecutor interface {
	Spec(context.Context) (EmbeddingSpec, error)
	Embed(context.Context, []EmbeddingInput) ([]EmbeddingVector, error)
}

type EmbeddingExecutorFuncs struct {
	SpecFunc  func(context.Context) (EmbeddingSpec, error)
	EmbedFunc func(context.Context, []EmbeddingInput) ([]EmbeddingVector, error)
}

type EmbeddingInput struct {
	ID      string
	Text    string
	Purpose EmbeddingPurpose
}

type EmbeddingPurpose string

type EmbeddingSpec struct {
	Fingerprint string
}

type EmbeddingVector struct {
	ID     string
	Values []float32
}

type EntryDocument struct {
	LogicalPath string
	Frontmatter map[string]any
	Body        string
	Attachments []string
}

type EntryDraft struct {
	Kind              string
	Layer             string
	Intent            string
	Body              string
	Refs              []EntryRef
	Closes            []string
	Supersedes        []string
	Participants      []string
	Confidence        string
	Topics            []string
	AttachmentHandles []string
	SkipPreflight     bool
}

type EntryRef struct {
	ID   string
	Kind string
	Desc string
}

type ErrorCode string

type FinalizerOutcome struct {
	Name      string
	Succeeded bool
	Message   string
}

type Finding struct {
	Severity    string
	Category    string
	Observation string
}

type GraphStore interface {
	Current(context.Context) (*Snapshot, error)
	Apply(context.Context, string, MutationBatch, StagedBlobReader) (ApplyResult, error)
	Reconcile(context.Context, string, string) (ApplyResult, error)
	ReadAttachmentPage(context.Context, string, string, int64, int) (AttachmentPage, error)
}

type IndexNamespace struct {
	Project     ProjectID
	Fingerprint string
	Metric      string
}

type IndexedChunk struct {
	Chunk  CanonicalChunk
	Vector []float32
}

type InfoRequest struct{}

type InfoResult struct {
	Project     ProjectRef
	Participant string
	Language    string
	Search      string
}

type LLMExecutor interface {
	Capabilities(context.Context) ([]string, error)
	Execute(context.Context, LLMRequest) (LLMResult, error)
}

type LLMExecutorFuncs struct {
	CapabilitiesFunc func(context.Context) ([]string, error)
	ExecuteFunc      func(context.Context, LLMRequest) (LLMResult, error)
}

type LLMRequest struct {
	Purpose              string
	SystemPrompt         string
	Prompt               string
	OutputSchema         json.RawMessage
	RequiredCapabilities []string
	Routing              map[string]string
	PromptDigest         string
	IdempotencyKey       string
}

type LLMResult struct {
	Output              []byte
	ExecutorFingerprint string
	FinishReason        string
	Usage               LLMUsage
}

type LLMUsage struct {
	InputTokens  int64
	OutputTokens int64
}

type ListSessionsResult struct {
	Project  ProjectRef
	Sessions []SessionSummary
}

type MutationBatch struct {
	ID          string
	Digest      string
	Changes     []DocumentChange
	Attachments []AttachmentMaterialization
	Message     string
	Author      Author
}

type MutationFinalizer interface {
	Name() string
	Finalize(context.Context, AppliedMutation) error
}

type MutationResult struct {
	Project ProjectRef
	Binding SessionBinding
}

type PreparedTransition struct {
	Version               uint32
	ExpectedGraphRevision string
	Batch                 MutationBatch
	BlobOwner             BlobOwner
	BlobIDs               []string
}

type Principal struct {
	Subject     string
	Participant string
}

type ProcedureListRequest struct{}

type ProcedureListResult struct {
	Project    ProjectRef
	Procedures string
}

type ProjectAction struct {
	ID          string
	DisplayName string
	State       ProjectState
	ActionURL   string
	Reason      string
}

type ProjectConfigDocument struct {
	LogicalPath string
	Fields      map[string]any
}

type ProjectID string

type ProjectList struct {
	Actions  []ProjectAction
	Projects []ProjectSummary
}

type ProjectRef struct {
	ID          ProjectID
	DisplayName string
}

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

type ProjectRuntimeOptions struct {
	Project      ProjectRef
	Language     string
	Dependencies []string
	Graph        GraphStore
	Sessions     SessionStore
	StagedBlobs  StagedBlobStore
	Embeddings   EmbeddingExecutor
	SearchIndex  SearchIndexStore
	LLM          LLMExecutor
	Finalizers   []MutationFinalizer
	Now          func() time.Time
	// ExcludeEmbeddedFromIndex mirrors the CLI's excludeEmbedded semantics for
	// the vector index: connected-repo runtimes set it so binary-shipped base
	// entries embed once per machine (in the base store) rather than once per
	// connected repo. The base runtime leaves it false — its store includes
	// embedded entries. The rule is applied identically at index and read time.
	ExcludeEmbeddedFromIndex bool
}

type ProjectState string

type ProjectSummary struct {
	ProjectRef
	SourceID string
	CanRead  bool
	CanWrite bool
	State    ProjectState
}

type ReadAttachmentRequest struct {
	EntryID  string
	Filename string
	Offset   int64
	MaxBytes int
}

type ReadAttachmentResult struct {
	Project   ProjectRef
	Page      AttachmentPage
	Available []string
}

type RegistryFunction struct {
	Name   string
	Class  string
	Doc    string
	Reads  []string
	Writes []string
}

type RequestIdentity struct {
	Subject    string
	Scopes     []string
	Attributes map[string]any
}

type ScoredChunkHit struct {
	Namespace IndexNamespace
	ChunkID   string
	EntryID   string
	// Revision is deprecated and ignored by hit validity (see CanonicalChunk).
	Revision    string
	ContentHash string
	Score       float64
	// Persisted citation fields, rendered directly into search citations so a
	// hit needs no re-derivation of its source chunk.
	Body                 string
	Breadcrumb           []string
	Depth                int
	IsSummary            bool
	IsAttachment         bool
	SourceAttachmentPath string
}

type SearchIndexEntryManifest interface {
	IndexedEntries(context.Context, IndexNamespace) ([]StoredEntryRef, error)
}

type SearchIndexStore interface {
	Manifest(context.Context, IndexNamespace) ([]StoredChunkRef, error)
	Reconcile(context.Context, IndexNamespace, string, []IndexedChunk, []string) error
	Nearest(context.Context, []IndexNamespace, []float32, int) ([]ScoredChunkHit, error)
}

type SearchIndexStoreFuncs struct {
	ManifestFunc  func(context.Context, IndexNamespace) ([]StoredChunkRef, error)
	ReconcileFunc func(context.Context, IndexNamespace, string, []IndexedChunk, []string) error
	NearestFunc   func(context.Context, []IndexNamespace, []float32, int) ([]ScoredChunkHit, error)
}

type SearchRequest struct {
	Terms             []string
	Phrase            string
	Type              string
	Layer             string
	Kind              string
	IncludeSuperseded bool
	Limit             int
	MaxCitations      int
	Repos             []string
	AllRepos          bool
}

type SearchResult struct {
	Project  ProjectRef
	Results  string
	EntryIDs []string
}

type SessionAppend struct {
	Metadata *SessionMetadata
	Events   []StoredEvent
}

type SessionBinding struct {
	SessionID    SessionID
	Subject      string
	Project      ProjectID
	MCPSessionID string
	Generation   uint64
	Version      uint64
}

type SessionFilter struct {
	Subject string
	Project ProjectID
}

type SessionHolder struct {
	Subject       string
	MCPSessionID  string
	ClientName    string
	ClientVersion string
	Generation    uint64
	LastActivity  time.Time
	ExpiresAt     time.Time
}

type SessionHolderRecord struct {
	Holder  SessionHolder
	EndedAt time.Time
	Reason  string
}

type SessionID string

type SessionMetadata struct {
	CodecVersion  uint32
	ID            SessionID
	Subject       string
	Project       ProjectID
	Participant   string
	Label         string
	Holder        *SessionHolder
	HolderHistory []SessionHolderRecord
	UpdatedAt     time.Time
}

type SessionStore interface {
	Create(context.Context, SessionMetadata) (StoredSession, error)
	Load(context.Context, SessionID) (StoredSession, error)
	List(context.Context, SessionFilter) ([]StoredSession, error)
	Append(context.Context, SessionID, uint64, SessionAppend) (uint64, error)
}

type SessionSummary struct {
	ID          SessionID
	Label       string
	Participant string
	UpdatedAt   time.Time
	Holder      *SessionHolder
	HolderLive  bool
}

type ShowRequest struct {
	IDs       []string
	UpDepth   int
	DownDepth int
}

type ShowResult struct {
	Project    ProjectRef
	Entries    string
	FullIDs    []string
	SummaryIDs []string
}

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

type SnapshotData struct {
	Project  ProjectID
	Revision string
	Config   ProjectConfigDocument
	Entries  []EntryDocument
	WIP      []WIPDocument
}

type StagedBlob struct {
	ID        string
	Owner     BlobOwner
	Digest    BlobDigest
	Size      int64
	Filename  string
	CreatedAt time.Time
}

type StagedBlobReader interface {
	Open(context.Context, string) (io.ReadCloser, error)
}

type StagedBlobStore interface {
	Stage(context.Context, BlobOwner, string, io.Reader) (StagedBlob, error)
	Stat(context.Context, BlobOwner, string) (StagedBlob, error)
	Open(context.Context, BlobOwner, string) (io.ReadCloser, error)
	Retain(context.Context, BlobOwner, string, []string) error
	Release(context.Context, BlobOwner, string) error
}

type StoredChunkRef struct {
	ID string
	// Revision is deprecated and ignored by reconciliation (see CanonicalChunk).
	Revision    string
	ContentHash string
}

type StoredEntryRef struct {
	EntryID string
}

type StoredEvent struct {
	CodecVersion uint32
	Code         string
	Payload      json.RawMessage
}

type StoredSession struct {
	Metadata SessionMetadata
	Version  uint64
	Events   []StoredEvent
}

type TransitionResult struct {
	Project    ProjectRef
	Binding    SessionBinding
	Apply      ApplyResult
	Finalizers []FinalizerOutcome
}

type ViewRequest struct {
	Layout   string
	Repos    []string
	AllRepos bool
}

type ViewResult struct {
	Project  ProjectRef
	Sections string
}

type WIPDocument struct {
	LogicalPath string
	Content     string
}

type WorkflowAbandonResult struct {
	Abandoned   bool
	Session     SessionID
	Label       string
	Discarded   []WorkflowInstanceSummary
	HeldMarkers []string
	Base        *WorkflowServe
}

type WorkflowAdvanceRequest struct {
	Instance string
	Report   map[string]any
	Label    string
}

type WorkflowChooser struct {
	Chooser string
	Kind    ChooserKind
	Options []WorkflowChooserOption
}

type WorkflowChooserOption struct {
	Choice  string
	Collect []string
}

type WorkflowInstanceSummary struct {
	Instance  string
	Procedure string
	Step      string
}

type WorkflowOpenRequest struct {
	MCPSessionID  string
	ClientName    string
	ClientVersion string
	Shell         string
	Label         string
}

type WorkflowParkResult struct {
	Instance  string
	Procedure string
	Step      string
	Base      *WorkflowServe
}

type WorkflowResumeRequest struct {
	SessionID     SessionID
	MCPSessionID  string
	ClientName    string
	ClientVersion string
	Takeover      bool
}

type WorkflowResumeResult struct {
	Session      SessionID
	Participant  string
	Label        string
	Open         []WorkflowServe
	Instructions string
}

type WorkflowServe struct {
	Session         SessionID
	Instance        string
	Procedure       string
	Status          string
	Step            string
	Goal            string
	Instructions    string
	Missing         []string
	ReportSchema    map[string]any
	PendingChooser  *WorkflowChooser
	Execution       string
	Produced        map[string]any
	Diagnostics     []string
	InstructionUnit string
	Base            *WorkflowServe
}

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

type WorkflowSessionSummary struct {
	Session      SessionID
	Label        string
	Participant  string
	Anchor       string
	Open         []WorkflowInstanceSummary
	LastActivity time.Time
	Holder       *SessionHolder
	HolderLive   bool
}

type WorkflowStartRequest struct {
	Canonical string
	Params    map[string]any
	Label     string
	Parent    string
}