application

package

Go to main page

Versions in this module

v0

v0.16.2

Jul 16, 2026

Changes in this version

type CanonicalChunk

+ Body string

+ Breadcrumb []string

+ Depth int

+ EntryHash string

+ IsAttachment bool

+ IsSummary bool

+ SourceAttachmentPath string

type ErrorCode

+ const ErrorInvalidArgument

type ProjectRuntimeOptions

+ ExcludeEmbeddedFromIndex bool

type ScoredChunkHit

+ Body string

+ Breadcrumb []string

+ Depth int

+ EntryID string

+ IsAttachment bool

+ IsSummary bool

+ SourceAttachmentPath string

+ type SearchIndexEntryManifest interface

+ IndexedEntries func(context.Context, IndexNamespace) ([]StoredEntryRef, error)

+ type StoredEntryRef struct

+ EntryID string

v0.16.1

Jul 14, 2026

v0.16.0

Jul 13, 2026

Changes in this version

+ const DefaultShellCanonical

+ const DefaultShowDownDepth

+ const DefaultShowUpDepth

+ const ExecutionForkPreferred

+ const PreparedTransitionVersion

+ const SessionCodecVersion

+ const WorkflowEventCode

+ const WorkflowMaxLabelLength

+ var ErrSessionNotFound = errors.New("sdd: session not found")

+ func AttachmentDirRelPath(entryID string) (string, error)

+ func MutationBatchDigest(batch MutationBatch) (string, error)

+ type Access string

+ const AccessRead

+ const AccessWrite

+ type AccessResolver interface

+ ListProjects func(context.Context, Principal) (ProjectList, error)

+ ResolveDependency func(context.Context, Principal, ProjectID, string) (*ProjectRuntime, error)

+ ResolvePrincipal func(context.Context, RequestIdentity) (Principal, error)

+ ResolveProject func(context.Context, Principal, ProjectID, Access) (*ProjectRuntime, error)

+ type Application struct

+ func NewApplication(access AccessResolver) (*Application, error)

+ func (a *Application) AbandonWorkflowSession(ctx context.Context, identity RequestIdentity, project ProjectID, ...) (WorkflowAbandonResult, error)

+ func (a *Application) ApplyPrepared(ctx context.Context, identity RequestIdentity, project ProjectID, ...) (TransitionResult, error)

+ func (a *Application) BindSession(ctx context.Context, identity RequestIdentity, project ProjectID, ...) (BindSessionResult, error)

+ func (a *Application) CreateEntry(ctx context.Context, identity RequestIdentity, project ProjectID, ...) (CreateEntryResult, error)

+ func (a *Application) CurrentSnapshot(ctx context.Context, identity RequestIdentity, project ProjectID) (*Snapshot, error)

+ func (a *Application) FinishWIP(ctx context.Context, identity RequestIdentity, project ProjectID, ...) (MutationResult, error)

+ func (a *Application) Info(ctx context.Context, identity RequestIdentity, project ProjectID, ...) (InfoResult, error)

+ func (a *Application) ListSessions(ctx context.Context, identity RequestIdentity, project ProjectID) (ListSessionsResult, error)

+ func (a *Application) ListWorkflowSessions(ctx context.Context, identity RequestIdentity, project ProjectID) ([]WorkflowSessionSummary, error)

+ func (a *Application) OpenWorkflow(ctx context.Context, identity RequestIdentity, project ProjectID, ...) (*WorkflowSession, *WorkflowServe, error)

+ func (a *Application) Procedures(ctx context.Context, identity RequestIdentity, project ProjectID, ...) (ProcedureListResult, error)

+ func (a *Application) ReadAttachment(ctx context.Context, identity RequestIdentity, project ProjectID, ...) (ReadAttachmentResult, error)

+ func (a *Application) RecoverPrepared(ctx context.Context, identity RequestIdentity, project ProjectID, ...) (TransitionResult, error)

+ func (a *Application) ReleaseSession(ctx context.Context, identity RequestIdentity, project ProjectID, ...) error

+ func (a *Application) ReplaceSummary(ctx context.Context, identity RequestIdentity, project ProjectID, ...) (MutationResult, error)

+ func (a *Application) ResumeWorkflow(ctx context.Context, identity RequestIdentity, project ProjectID, ...) (*WorkflowSession, WorkflowResumeResult, error)

+ func (a *Application) Search(ctx context.Context, identity RequestIdentity, project ProjectID, ...) (SearchResult, error)

+ func (a *Application) Show(ctx context.Context, identity RequestIdentity, project ProjectID, ...) (ShowResult, error)

+ func (a *Application) StageBlob(ctx context.Context, identity RequestIdentity, project ProjectID, ...) (StagedBlob, error)

+ func (a *Application) StartWIP(ctx context.Context, identity RequestIdentity, project ProjectID, ...) (string, MutationResult, error)

+ func (a *Application) View(ctx context.Context, identity RequestIdentity, project ProjectID, ...) (ViewResult, error)

+ func (a *Application) Vocabulary(ctx context.Context, identity RequestIdentity, project ProjectID) (string, error)

+ type ApplicationError struct

+ Action *ProjectAction

+ ApplyState ApplyState

+ Cause error

+ Code ErrorCode

+ Holder *SessionHolder

+ Message string

+ Project ProjectRef

+ Revision string

+ Version uint32

+ func (e *ApplicationError) Error() string

+ func (e *ApplicationError) Unwrap() error

+ type AppliedMutation struct

+ Batch MutationBatch

+ BatchID string

+ Project ProjectID

+ Revision string

+ type ApplyResult struct

+ Revision string

+ State ApplyState

+ type ApplyState string

+ const MutationApplied

+ const MutationNotApplied

+ const MutationUnknown

+ type AttachmentMaterialization struct

+ BlobID string

+ Digest BlobDigest

+ LogicalPath string

+ Size int64

+ SourceName string

+ type AttachmentPage struct

+ Content []byte

+ Digest BlobDigest

+ Filename string

+ More bool

+ NextOffset int64

+ Offset int64

+ TotalSize int64

+ type Author struct

+ Email string

+ Name string

+ type BindSessionRequest struct

+ Chooser ChooserKind

+ ClientName string

+ ClientVersion string

+ MCPSessionID string

+ SessionID SessionID

+ Takeover bool

+ type BindSessionResult struct

+ Binding SessionBinding

+ Created bool

+ Project ProjectRef

+ type BlobDigest struct

+ Algorithm string

+ Value string

+ type BlobOwner struct

+ Session SessionID

+ Subject string

+ type CanonicalChunk struct

+ ContentHash string

+ EntryID string

+ ID string

+ Ordinal int

+ Revision string

+ Text string

+ type ChooserKind string

+ const ChooserAgent

+ const ChooserGate

+ const ChooserUser

+ type CreateEntryResult struct

+ Binding SessionBinding

+ EntryID string

+ Findings []Finding

+ Project ProjectRef

+ Summary string

+ type DocumentChange struct

+ CanonicalBytes []byte

+ Delete bool

+ Document *EntryDocument

+ LogicalPath string

+ type EmbeddingExecutor interface

+ Embed func(context.Context, []EmbeddingInput) ([]EmbeddingVector, error)

+ Spec func(context.Context) (EmbeddingSpec, error)

+ type EmbeddingExecutorFuncs struct

+ EmbedFunc func(context.Context, []EmbeddingInput) ([]EmbeddingVector, error)

+ SpecFunc func(context.Context) (EmbeddingSpec, error)

+ func (f EmbeddingExecutorFuncs) Embed(ctx context.Context, inputs []EmbeddingInput) ([]EmbeddingVector, error)

+ func (f EmbeddingExecutorFuncs) Spec(ctx context.Context) (EmbeddingSpec, error)

+ type EmbeddingInput struct

+ ID string

+ Purpose EmbeddingPurpose

+ Text string

+ type EmbeddingPurpose string

+ const EmbeddingDocument

+ const EmbeddingQuery

+ type EmbeddingSpec struct

+ Dimensions int

+ Fingerprint string

+ type EmbeddingVector struct

+ ID string

+ Values []float32

+ type EntryDocument struct

+ Attachments []string

+ Body string

+ Frontmatter map[string]any

+ LogicalPath string

+ type EntryDraft struct

+ AttachmentHandles []string

+ Body string

+ Closes []string

+ Confidence string

+ Intent string

+ Kind string

+ Layer string

+ Participants []string

+ Refs []EntryRef

+ SkipPreflight bool

+ Supersedes []string

+ Topics []string

+ type EntryRef struct

+ Desc string

+ ID string

+ Kind string

+ type ErrorCode string

+ const ErrorActionRequired

+ const ErrorAuthenticationRequired

+ const ErrorGraphConflict

+ const ErrorMigrationRequired

+ const ErrorProjectRequired

+ const ErrorProjectUnavailable

+ const ErrorReadDenied

+ const ErrorRecoveryRequired

+ const ErrorSessionConflict

+ const ErrorSessionInUse

+ const ErrorSessionOwnership

+ const ErrorWriteDenied

+ type FinalizerOutcome struct

+ Message string

+ Name string

+ Succeeded bool

+ type Finding struct

+ Category string

+ Observation string

+ Severity string

+ type GraphStore interface

+ Apply func(context.Context, string, MutationBatch, StagedBlobReader) (ApplyResult, error)

+ Current func(context.Context) (*Snapshot, error)

+ ReadAttachmentPage func(context.Context, string, string, int64, int) (AttachmentPage, error)

+ Reconcile func(context.Context, string, string) (ApplyResult, error)

+ type IndexNamespace struct

+ Dimensions int

+ Fingerprint string

+ Metric string

+ Project ProjectID

+ type IndexedChunk struct

+ Chunk CanonicalChunk

+ Vector []float32

+ type InfoRequest struct

+ type InfoResult struct

+ Language string

+ Participant string

+ Project ProjectRef

+ Search string

+ type LLMExecutor interface

+ Capabilities func(context.Context) ([]string, error)

+ Execute func(context.Context, LLMRequest) (LLMResult, error)

+ type LLMExecutorFuncs struct

+ CapabilitiesFunc func(context.Context) ([]string, error)

+ ExecuteFunc func(context.Context, LLMRequest) (LLMResult, error)

+ func (f LLMExecutorFuncs) Capabilities(ctx context.Context) ([]string, error)

+ func (f LLMExecutorFuncs) Execute(ctx context.Context, request LLMRequest) (LLMResult, error)

+ type LLMRequest struct

+ IdempotencyKey string

+ OutputSchema json.RawMessage

+ Prompt string

+ PromptDigest string

+ Purpose string

+ RequiredCapabilities []string

+ Routing map[string]string

+ SystemPrompt string

+ type LLMResult struct

+ ExecutorFingerprint string

+ FinishReason string

+ Output []byte

+ Usage LLMUsage

+ type LLMUsage struct

+ InputTokens int64

+ OutputTokens int64

+ type ListSessionsResult struct

+ Project ProjectRef

+ Sessions []SessionSummary

+ type MutationBatch struct

+ Attachments []AttachmentMaterialization

+ Author Author

+ Changes []DocumentChange

+ Digest string

+ ID string

+ Message string

+ type MutationFinalizer interface

+ Finalize func(context.Context, AppliedMutation) error

+ Name func() string

+ type MutationResult struct

+ Binding SessionBinding

+ Project ProjectRef

+ type PreparedTransition struct

+ Batch MutationBatch

+ BlobIDs []string

+ BlobOwner BlobOwner

+ ExpectedGraphRevision string

+ Version uint32

+ type Principal struct

+ Participant string

+ Subject string

+ type ProcedureListRequest struct

+ type ProcedureListResult struct

+ Procedures string

+ Project ProjectRef

+ type ProjectAction struct

+ ActionURL string

+ DisplayName string

+ ID string

+ Reason string

+ State ProjectState

+ type ProjectConfigDocument struct

+ Fields map[string]any

+ LogicalPath string

+ type ProjectID string

+ type ProjectList struct

+ Actions []ProjectAction

+ Projects []ProjectSummary

+ type ProjectRef struct

+ DisplayName string

+ ID ProjectID

+ type ProjectRuntime struct

+ func NewProjectRuntime(options ProjectRuntimeOptions) (*ProjectRuntime, error)

+ func (r *ProjectRuntime) Project() ProjectRef

+ type ProjectRuntimeOptions struct

+ Dependencies []string

+ Embeddings EmbeddingExecutor

+ Finalizers []MutationFinalizer

+ Graph GraphStore

+ LLM LLMExecutor

+ Language string

+ Now func() time.Time

+ Project ProjectRef

+ SearchIndex SearchIndexStore

+ Sessions SessionStore

+ StagedBlobs StagedBlobStore

+ type ProjectState string

+ const ProjectActionRequired

+ const ProjectReady

+ const ProjectUnavailable

+ type ProjectSummary struct

+ CanRead bool

+ CanWrite bool

+ SourceID string

+ State ProjectState

+ type ReadAttachmentRequest struct

+ EntryID string

+ Filename string

+ MaxBytes int

+ Offset int64

+ type ReadAttachmentResult struct

+ Available []string

+ Page AttachmentPage

+ Project ProjectRef

+ type RegistryFunction struct

+ Class string

+ Doc string

+ Name string

+ Reads []string

+ Writes []string

+ func WorkflowRegistryDocs(class string) ([]RegistryFunction, error)

+ type RequestIdentity struct

+ Attributes map[string]any

+ Scopes []string

+ Subject string

+ type ScoredChunkHit struct

+ ChunkID string

+ ContentHash string

+ Namespace IndexNamespace

+ Revision string

+ Score float64

+ type SearchIndexStore interface

+ Manifest func(context.Context, IndexNamespace) ([]StoredChunkRef, error)

+ Nearest func(context.Context, []IndexNamespace, []float32, int) ([]ScoredChunkHit, error)

+ Reconcile func(context.Context, IndexNamespace, string, []IndexedChunk, []string) error

+ type SearchIndexStoreFuncs struct

+ ManifestFunc func(context.Context, IndexNamespace) ([]StoredChunkRef, error)

+ NearestFunc func(context.Context, []IndexNamespace, []float32, int) ([]ScoredChunkHit, error)

+ ReconcileFunc func(context.Context, IndexNamespace, string, []IndexedChunk, []string) error

+ func (f SearchIndexStoreFuncs) Manifest(ctx context.Context, namespace IndexNamespace) ([]StoredChunkRef, error)

+ func (f SearchIndexStoreFuncs) Nearest(ctx context.Context, namespaces []IndexNamespace, vector []float32, limit int) ([]ScoredChunkHit, error)

+ func (f SearchIndexStoreFuncs) Reconcile(ctx context.Context, namespace IndexNamespace, revision string, ...) error

+ type SearchRequest struct

+ AllRepos bool

+ IncludeSuperseded bool

+ Kind string

+ Layer string

+ Limit int

+ MaxCitations int

+ Phrase string

+ Repos []string

+ Terms []string

+ Type string

+ type SearchResult struct

+ EntryIDs []string

+ Project ProjectRef

+ Results string

+ type SessionAppend struct

+ Events []StoredEvent

+ Metadata *SessionMetadata

+ type SessionBinding struct

+ Generation uint64

+ MCPSessionID string

+ Project ProjectID

+ SessionID SessionID

+ Subject string

+ Version uint64

+ type SessionFilter struct

+ Project ProjectID

+ Subject string

+ type SessionHolder struct

+ ClientName string

+ ClientVersion string

+ ExpiresAt time.Time

+ Generation uint64

+ LastActivity time.Time

+ MCPSessionID string

+ Subject string

+ type SessionHolderRecord struct

+ EndedAt time.Time

+ Holder SessionHolder

+ Reason string

+ type SessionID string

+ type SessionMetadata struct

+ CodecVersion uint32

+ Holder *SessionHolder

+ HolderHistory []SessionHolderRecord

+ ID SessionID

+ Label string

+ Participant string

+ Project ProjectID

+ Subject string

+ UpdatedAt time.Time

+ type SessionStore interface

+ Append func(context.Context, SessionID, uint64, SessionAppend) (uint64, error)

+ Create func(context.Context, SessionMetadata) (StoredSession, error)

+ List func(context.Context, SessionFilter) ([]StoredSession, error)

+ Load func(context.Context, SessionID) (StoredSession, error)

+ type SessionSummary struct

+ Holder *SessionHolder

+ HolderLive bool

+ ID SessionID

+ Label string

+ Participant string

+ UpdatedAt time.Time

+ type ShowRequest struct

+ DownDepth int

+ IDs []string

+ UpDepth int

+ type ShowResult struct

+ Entries string

+ FullIDs []string

+ Project ProjectRef

+ SummaryIDs []string

+ type Snapshot struct

+ func BuildSnapshot(_ context.Context, data SnapshotData) (*Snapshot, error)

+ func LoadSnapshotFS(ctx context.Context, project ProjectID, revision string, fsys fs.FS, ...) (*Snapshot, error)

+ func (s *Snapshot) Project() ProjectID

+ func (s *Snapshot) Revision() string

+ type SnapshotData struct

+ Config ProjectConfigDocument

+ Entries []EntryDocument

+ Project ProjectID

+ Revision string

+ WIP []WIPDocument

+ type StagedBlob struct

+ CreatedAt time.Time

+ Digest BlobDigest

+ Filename string

+ ID string

+ Owner BlobOwner

+ Size int64

+ type StagedBlobReader interface

+ Open func(context.Context, string) (io.ReadCloser, error)

+ type StagedBlobStore interface

+ Open func(context.Context, BlobOwner, string) (io.ReadCloser, error)

+ Release func(context.Context, BlobOwner, string) error

+ Retain func(context.Context, BlobOwner, string, []string) error

+ Stage func(context.Context, BlobOwner, string, io.Reader) (StagedBlob, error)

+ Stat func(context.Context, BlobOwner, string) (StagedBlob, error)

+ type StoredChunkRef struct

+ ContentHash string

+ ID string

+ Revision string

+ type StoredEvent struct

+ Code string

+ CodecVersion uint32

+ Payload json.RawMessage

+ type StoredSession struct

+ Events []StoredEvent

+ Metadata SessionMetadata

+ Version uint64

+ type TransitionResult struct

+ Apply ApplyResult

+ Binding SessionBinding

+ Finalizers []FinalizerOutcome

+ Project ProjectRef

+ type ViewRequest struct

+ AllRepos bool

+ Layout string

+ Repos []string

+ type ViewResult struct

+ Project ProjectRef

+ Sections string

+ type WIPDocument struct

+ Content string

+ LogicalPath string

+ type WorkflowAbandonResult struct

+ Abandoned bool

+ Base *WorkflowServe

+ Discarded []WorkflowInstanceSummary

+ HeldMarkers []string

+ Label string

+ Session SessionID

+ type WorkflowAdvanceRequest struct

+ Instance string

+ Label string

+ Report map[string]any

+ 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

+ ClientName string

+ ClientVersion string

+ Label string

+ MCPSessionID string

+ Shell string

+ type WorkflowParkResult struct

+ Base *WorkflowServe

+ Instance string

+ Procedure string

+ Step string

+ type WorkflowResumeRequest struct

+ ClientName string

+ ClientVersion string

+ MCPSessionID string

+ SessionID SessionID

+ Takeover bool

+ type WorkflowResumeResult struct

+ Instructions string

+ Label string

+ Open []WorkflowServe

+ Participant string

+ Session SessionID

+ type WorkflowServe struct

+ Base *WorkflowServe

+ Diagnostics []string

+ Execution string

+ Goal string

+ Instance string

+ InstructionUnit string

+ Instructions string

+ Missing []string

+ PendingChooser *WorkflowChooser

+ Procedure string

+ Produced map[string]any

+ ReportSchema map[string]any

+ Session SessionID

+ Status string

+ Step string

+ func (s *WorkflowServe) ReminderInstructions() string

+ type WorkflowSession struct

+ func (w *WorkflowSession) Abandon(ctx context.Context, identity RequestIdentity, instance, reason string) (WorkflowAbandonResult, error)

+ func (w *WorkflowSession) Advance(ctx context.Context, identity RequestIdentity, request WorkflowAdvanceRequest) (*WorkflowServe, error)

+ func (w *WorkflowSession) Binding() SessionBinding

+ func (w *WorkflowSession) Framing(ctx context.Context, identity RequestIdentity) (string, error)

+ func (w *WorkflowSession) ID() SessionID

+ func (w *WorkflowSession) IsShell(instance string) bool

+ func (w *WorkflowSession) Leave(ctx context.Context, identity RequestIdentity) error

+ func (w *WorkflowSession) LogRead(ctx context.Context, identity RequestIdentity, tool string, ...) error

+ func (w *WorkflowSession) OpenInstances() []WorkflowInstanceSummary

+ func (w *WorkflowSession) Park(ctx context.Context, identity RequestIdentity, instance, note string) (WorkflowParkResult, error)

+ func (w *WorkflowSession) Project() ProjectID

+ func (w *WorkflowSession) Release(ctx context.Context, identity RequestIdentity) error

+ func (w *WorkflowSession) Reopen(ctx context.Context, identity RequestIdentity, label string) (*WorkflowServe, error)

+ func (w *WorkflowSession) ServeAll(ctx context.Context, identity RequestIdentity) (WorkflowResumeResult, error)

+ func (w *WorkflowSession) ServeShell(ctx context.Context, identity RequestIdentity) (*WorkflowServe, error)

+ func (w *WorkflowSession) StageAttachment(ctx context.Context, identity RequestIdentity, filename string, content []byte) (string, error)

+ func (w *WorkflowSession) Start(ctx context.Context, identity RequestIdentity, request WorkflowStartRequest) (*WorkflowServe, error)

+ type WorkflowSessionSummary struct

+ Anchor string

+ Holder *SessionHolder

+ HolderLive bool

+ Label string

+ LastActivity time.Time

+ Open []WorkflowInstanceSummary

+ Participant string

+ Session SessionID

+ type WorkflowStartRequest struct

+ Canonical string

+ Label string

+ Params map[string]any

+ Parent string

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL