session

package

Go to main page

Versions in this module

v0

v0.7.1

Oct 5, 2026

v0.7.1-rc.1

Oct 5, 2026

v0.7.0

Oct 4, 2026

v0.6.1-rc.1

Oct 4, 2026

v0.6.0

Oct 1, 2026

v0.5.2-rc.1

Oct 1, 2026

v0.5.1

Oct 1, 2026

v0.5.1-rc.1

Oct 1, 2026

v0.5.0

Sep 30, 2026

v0.4.2-rc.2

Sep 30, 2026

v0.4.2-rc.1

Sep 28, 2026

v0.4.1

Sep 22, 2026

v0.4.1-rc.1

Sep 22, 2026

v0.4.0

Sep 22, 2026

Changes in this version

+ const PostureAllow

+ const PostureAsk

+ const PostureAuto

+ const PostureDeny

+ const PostureGuardian

+ const SearchDefaultCount

+ var ApprovalPostures = []string

+ var ApprovalWheel = []string

+ var ErrPlainDocument = errors.New("plain text")

+ var ErrUnsupportedDocument = errors.New("unsupported document")

+ func BashBeltAsked() bool

+ func BeltWorkerBrief(store *plandb.Store, task *plandb.Task, root, resume bool, wake string) string

+ func CloseUsage()

+ func GenerateImage(ctx context.Context, gen ImageGen, parsed GenerateImageArgs) (string, bool)

+ func LandRunTree(dir, title string, sign bool) (branch string, changed []string, refusal string, err error)

+ func OpenRunPlan(dir, title, brief string) (*plandb.Store, error)

+ func PlanStorePath(dir string) string

+ func RegisterRunEngine(engine RunEngine)

+ func SetTaskArchived(dir, sessionID, taskID string, archived bool) error

+ func StopUsageWriter(path string) bool

+ func SweepHomeContext(ctx context.Context, standingRoot string, note func(string))

+ func SweepPlacesContext(ctx context.Context, root string, now time.Time, note func(string))

+ func SweepStandingContext(ctx context.Context, root string, now time.Time, note func(string))

+ func WebFetch(ctx context.Context, fetcher search.Fetcher, url string) (string, bool)

+ func WebSearch(ctx context.Context, provider search.Provider, query string, count int) (string, bool)

+ func WebSearchCount(asked int) int

type Agent

+ func NewBeltWorker(config Config, completer Completer, task *plandb.Task, storePath string) (*Agent, error)

+ func (a *Agent) ApprovalDial() bool

+ func (a *Agent) ApprovalPosture() string

+ func (a *Agent) AskRun(ctx context.Context, rootID, question string, earlier []RunAskExchange) (RunAskAnswer, error)

+ func (a *Agent) ContinueRun(ctx context.Context, row uint64) (string, error)

+ func (a *Agent) PlanAmend(id, text string) error

+ func (a *Agent) PlanCancel(id string) error

+ func (a *Agent) PlanNote(id, text string) error

+ func (a *Agent) PlanPause(id string) error

+ func (a *Agent) PlanPriority(id string, n int) error

+ func (a *Agent) PlanResume(id string) error

+ func (a *Agent) PlanRunSummary(rootID string) (RunPlanSummary, bool)

+ func (a *Agent) PlanSpend(since time.Time) []PlanSpendLine

+ func (a *Agent) PlanTaskPage(id string) (PlanTaskPage, bool)

+ func (a *Agent) PlanTasks() []PlanTaskRow

+ func (a *Agent) RebuildApprovalGate() error

+ func (a *Agent) RefreshRunSummary(ctx context.Context, rootID string, lastLook time.Time) (RunPlanSummary, bool)

+ func (a *Agent) ReplaceQuestion(ctx context.Context, answer Answer) (<-chan Event, error)

+ func (a *Agent) ResolvedApprovalPosture() string

+ func (a *Agent) RetryTask(id uint64) error

+ func (a *Agent) SendRunNote(rootID, text string) error

+ func (a *Agent) SetApprovalPosture(posture string) error

+ func (a *Agent) StandingApprovalPosture() string

+ func (a *Agent) TaskReport() string

type Answer

+ Clarify bool

+ type ApprovalGate interface

+ Build func(posture string) (*approval.Policy, bool, error)

+ Standing func() string

type Config

+ ApprovalGate ApprovalGate

+ ApprovalPosture string

+ type DocumentAnswer struct

+ Rung string

+ Text string

+ func ReadDocument(ctx context.Context, read DocumentRead) (DocumentAnswer, error)

type DocumentParser

+ func NewDocumentParser(config Config) (DocumentParser, error)

+ func NewDocumentParserFromProfile(settings config.Config) (DocumentParser, error)

+ type DocumentRead struct

+ Account func(model string, usage *ai.Usage)

+ Engine string

+ Keep func(key, rung, text string)

+ ModelOf func(kind string) string

+ PagesFrom int

+ PagesTo int

+ Parser func() (DocumentParser, error)

+ Path string

+ Question string

+ Recall func(key string) (rung, text string, ok bool)

+ Workspace string

type Event

+ Discussion *QuestionDiscussion

+ Refused bool

type EventKind

+ const EventQuestionDiscussion

type Facts

+ Approval string

+ type GenerateImageArgs struct

+ AspectRatio string

+ Model string

+ Path string

+ Prompt string

+ ReferencePaths []string

+ Size string

+ type ImageGen struct

+ Account func(model string, usage *ai.Usage)

+ Client MediaGenerator

+ DefaultModel string

+ Directory string

+ Pick func(modality, word string) (string, error)

+ Record func(path, prompt string)

+ Workspace string

type Meta

+ Approval string

+ ArchivedTasks map[string]bool

+ type PlanAgent interface

+ PlanAmend func(id, text string) error

+ PlanCancel func(id string) error

+ PlanNote func(id, text string) error

+ PlanPause func(id string) error

+ PlanPriority func(id string, priority int) error

+ PlanResume func(id string) error

+ PlanRunSummary func(rootID string) (RunPlanSummary, bool)

+ PlanTaskPage func(id string) (PlanTaskPage, bool)

+ PlanTasks func() []PlanTaskRow

+ RefreshRunSummary func(ctx context.Context, rootID string, lastLook time.Time) (RunPlanSummary, bool)

+ type PlanCommandPart struct

+ Command string

+ End int

+ RecordAddressed bool

+ RunCopyPrefix bool

+ SepEnd int

+ Separator string

+ Start int

+ type PlanSpendLine struct

+ Calls int

+ Model string

+ Seat string

+ USD float64

+ type PlanStep struct

+ Children []string

+ Command string

+ FullOutput string

+ Kind string

+ NotRun bool

+ Observation string

+ ObservationHeadWithheld bool

+ Parts []PlanCommandPart

+ Refused bool

+ Step int

+ Writes []string

+ type PlanTaskNote struct

+ At time.Time

+ Author string

+ Body string

+ Person bool

+ type PlanTaskPage struct

+ Checks []string

+ Children []PlanTaskRow

+ Description string

+ Folder string

+ Live plandb.LiveStep

+ Notes []PlanTaskNote

+ Result string

+ Row PlanTaskRow

+ Steps []PlanStep

+ WaitRows []PlanTaskRow

+ type PlanTaskRow struct

+ Depth int

+ Done int

+ Ended time.Time

+ Failed int

+ Folder string

+ ID string

+ Live plandb.LiveStep

+ LiveParts []PlanCommandPart

+ Note string

+ Parent string

+ Queued int

+ Running int

+ Seat string

+ Started time.Time

+ Status string

+ Steps int

+ Stopped bool

+ Title string

+ Total int

+ TrajectoryPath string

+ USD float64

+ Waits []string

type Question

+ ClarificationDepth int

+ type QuestionDiscussion struct

+ Error string

+ Event *Event

+ ID string

+ Seq uint64

+ Words string

+ type RunAskAnswer struct

+ From []RunAskSource

+ IsNote bool

+ Note string

+ Text string

+ type RunAskExchange struct

+ Answer string

+ Question string

+ type RunAskSource struct

+ ID string

+ StepEnd int

+ StepStart int

+ Title string

+ type RunEngine interface

+ Land func(ctx context.Context, store *plandb.Store, workspace, rootID string) (RunLanding, error)

+ Start func(ctx context.Context, spec RunSpec) RunSummary

+ type RunLanding struct

+ Branch string

+ Changed []string

+ Home string

+ Refused string

+ type RunLimit string

+ const RunLimitCost

+ const RunLimitTime

+ type RunPlanSummary struct

+ Next string

+ Now string

+ Since string

+ What string

+ WrittenAt time.Time

+ type RunSpec struct

+ Brief string

+ CompleterFor func(model string) Completer

+ CostUSD float64

+ Elapsed time.Duration

+ OnSpend func(float64)

+ PlanModel string

+ ProfileDir string

+ Slots int

+ StepsPerTask int

+ Store *plandb.Store

+ Title string

+ WorkModel string

+ Workspace string

+ type RunSummary struct

+ Cut []string

+ Limit RunLimit

+ Nodes int

+ Outcome string

+ Result string

+ Steps int

+ USD float64

type SessionRow

+ ArchivedTasks map[string]bool

type TaskAskKind

+ const TaskAskContinue

+ type TaskCopyRecord struct

+ Branch string

+ Dir string

+ Ground string

+ Home string

+ HomeSha string

+ Mode TaskMode

+ Root string

+ Rung GroundRung

+ Seal string

type TaskEnding

+ const TaskEndingCostLimit

+ const TaskEndingTimeLimit

type TaskFacts

+ CannotContinue string

type TaskIndexEntry

+ VerdictBasis *plandb.VerdictBasis

type TaskNotice

+ Copy *TaskCopyRecord

type TaskPresence

+ const TaskPresenceInterrupted

type TaskState

+ const TaskInterrupted

v0.3.1-rc.1

Sep 22, 2026

v0.3.0

Sep 18, 2026

Changes in this version

+ const LandingDecidingWord

+ var Seats = []Seat

+ func SeatValid(word string) bool

+ type AgentKind string

+ const AgentAudit

+ const AgentChat

+ const AgentRepair

+ const AgentTask

type Config

+ TaskLanded func(TaskLanding)

+ type Seat string

+ const SeatHigh

+ const SeatJudge

+ const SeatLow

+ const SeatMastermind

+ const SeatReflex

+ const SeatTalk

+ const SeatWorker

+ func SeatOfAgent(kind AgentKind) (Seat, bool)

+ func SeatOfRole(role roles.Role) (Seat, bool)

+ func SeatOfTier(tier roles.Tier) (Seat, bool)

type TaskEnding

+ const TaskEndingInterrupted

type TaskIndexEntry

+ Branch string

+ type TaskLanding struct

+ Attempt int

+ Brief string

+ Changed int

+ Checks []string

+ Claim string

+ CostUSD float64

+ Deliverable string

+ Ending string

+ High string

+ ID uint64

+ Report string

+ State TaskState

+ Tokens int

+ Worker string

+ Wrote []string

+ func LoadLandedForJudge(tasksPath string) ([]TaskLanding, error)

type TaskNotice

+ Settling string

type UsageLine

+ Seat Seat

+ func TagUsage(line UsageLine, role roles.Role, seat Seat) UsageLine

v0.2.2-rc.1

Sep 18, 2026

v0.2.1

Sep 17, 2026

Changes in this version

+ const AdmissionContextVersion

+ const AnswerBanked

+ const ArtifactsIndexName

+ const BashCeilingSeconds

+ const BashPromotedLead

+ const CancelHarness

+ const CancelJob

+ const CancelRun

+ const CancelTask

+ const ConnectAskHead

+ const ConnectAskReason

+ const ConnectKeyPrompt

+ const ConsentFallbackReason

+ const ConsentWaiting

+ const DecisionSep

+ const DefaultRunCapUSD

+ const HarnessChangeKey

+ const HarnessDropKey

+ const HarnessModelNote

+ const HarnessNotNowKey

+ const HarnessPhaseAsking

+ const HarnessRunKey

+ const HarnessSaveKey

+ const JobNameWords

+ const LandingAgainKey

+ const LandingDecideKey

+ const LandingNoKey

+ const LandingTakeBackKey

+ const LandingTellKey

+ const LandingYesKey

+ const MatchInside

+ const MatchPrefix

+ const MatchScattered

+ const MatchWord

+ const MatchWordStart

+ const MovedWord

+ const NoChangeReply

+ const PartialStringLimit

+ const PhaseAllSlow

+ const PhaseAsking

+ const PhaseBriefing

+ const PhaseChecking

+ const PhaseRunning

+ const PhaseTakingStock

+ const PhaseTidying

+ const QuestionCap

+ const ResumedWord

+ const SpellOutOpening

+ const StandingAskLead

+ const StandingAskReason

+ const StandingNoKey

+ const StandingOnceKey

+ const SubjectConversation

+ const SubjectStanding

+ const SubjectTask

+ const TakeoverStale

+ const TakeoverWord

+ const TaskGradeEvidence

+ const TaskJournalTail

+ const TaskModelBlank

+ const TaskModelPrompt

+ const TaskNameWords

+ const TaskPhaseChecking

+ const TaskPhaseRepairing

+ const TaskPhaseSizing

+ const TaskPhaseWorking

+ const TaskProposalLead

+ const TaskProposalPickReason

+ const TranscriptName

+ const UsageLedgerName

+ var ErrCompactionInFlight = errors.New("session: a compaction pass is already running")

+ var ErrConversationUnchecked error = uncheckedConversation

+ var ErrLaunchBudget = errors.New("session: launch limit reached")

+ var ErrNoSessionDir = errors.New("this conversation has no folder to leave a request in")

+ var ErrNobodyToRead = errors.New("nobody is in there to read your line")

+ var ErrNotThatConversation = errors.New("that correction was written for another conversation, so it was not sent")

+ var ErrNothingToCompact = errors.New("session: nothing to compact")

+ var ErrNothingToRewind = errors.New("session: nothing to rewind")

+ var ErrNothingToSteer = errors.New("nothing is running to steer")

+ var ErrSendUnanswered = errors.New("no answer came back, so it is not known whether these words arrived")

+ var ErrSessionLocked = errors.New("session file is open in another codeaf")

+ var ErrSpendRail = errors.New("session: the spend rail was reached")

+ var ErrTaskDecided = errors.New("session: that task has already been settled")

+ var ErrTaskHandedOver = errors.New("session: that task is already handed to codeaf")

+ var ErrTurnInFlight = errors.New("session: a turn is in flight; interrupt it first")

+ var TaskResolutions = []TaskResolution

+ func ActionCategoryWords() string

+ func AnswerLabel(kind QuestionKind, key string) string

+ func AnswerResolves(answer Answer) bool

+ func AnswersPath(sessionDir string) string

+ func ArgumentRefusal(text string) bool

+ func AskTakeover(sessionDir string) error

+ func AudioDir(place Place, workspace string) string

+ func BackgroundTold(root string) bool

+ func BashBoundSeconds(args json.RawMessage, backgroundAfter int) float64

+ func BashTimeoutSeconds(args json.RawMessage) float64

+ func CancelTakeover(sessionDir string)

+ func CompactThreshold(window int) int

+ func CompactThresholdFor(model string, window int) int

+ func ContextFillPinned() (int, bool)

+ func ConversationReference(sessionID string, seq int64) string

+ func CountUnbilledCall()

+ func CountWorking(nodes []WorkNode) int

+ func DecisionsPath(sessionDir string) string

+ func DecisionsSection(records []DecisionRecord) string

+ func EstimateTokens(bytes int) int

+ func FlushUsage()

+ func GroundWord(rung GroundRung, promise TaskMode) string

+ func HarnessBelt(workspace string, seams HarnessBeltSeams) []bare.Tool

+ func HarnessBeltNames(workspace string, seams HarnessBeltSeams) map[string]bool

+ func ImagesDir(place Place, workspace string) string

+ func InUse(path string) bool

+ func IsNoChangeReply(text string) bool

+ func LastLook(root string) time.Time

+ func LastLookAt(root, place string) time.Time

+ func LastTold(dir string) time.Time

+ func LooseTasksRoot() string

+ func MatchQuality(text, needle string) (int, bool)

+ func MusicDir(place Place, workspace string) string

+ func NewMemoryTidy(parent Config, brainPath, root string, idle standing.Idle) standing.Tidy

+ func NewSessionID() string

+ func NewStandingRunner(parent Config, root string) standing.Runner

+ func NewStandingSentinel(parent Config) standing.Sentinel

+ func NewsSubject(conversation string, node uint64) string

+ func NoteLook(root string, at time.Time)

+ func NoteLookAt(root, place string, at time.Time)

+ func NoteTold(dir string, at time.Time)

+ func OnLaneNews(fn func(LaneNews)) (previous func(LaneNews))

+ func OnPhaseNews(fn func(PhaseNews)) (previous func(PhaseNews))

+ func ParseReasoning(level string) (string, bool)

+ func PartialString(argsText, field string) (string, bool)

+ func PeekReport(path string) (string, bool)

+ func PlaceSession(place Place) string

+ func PlacesRoot() string

+ func PreflightNote(root string, e Elsewhere, parts ...string) string

+ func ReasoningKey(model string) string

+ func RecordArtifact(path string, artifact Artifact)

+ func RecordRoots() []string

+ func RecordUnbilledCall(path string, line UsageLine)

+ func RecordUsage(path string, line UsageLine)

+ func RunsRoot() string

+ func SaveMeta(dir string, meta Meta) error

+ func SetArchived(dir string, archived bool) error

+ func SetOfferAnswerer(answerer offerAnswerer) (previous offerAnswerer)

+ func SharedFiles(one, two []string) []string

+ func ShortCaption(line string) string

+ func SpendShare(usd, budget float64) float64

+ func SpendToday(lines []UsageLine, now time.Time) float64

+ func SpokeIn(path string) (spoken bool, sure bool)

+ func StandingIdle() standing.Idle

+ func StandingOnceIsAnAnswer(item standing.Item) bool

+ func SteerDelivered(waiting bool) string

+ func SubharnessInput(card SubharnessCard) json.RawMessage

+ func SweepHome(standingRoot string, note func(string))

+ func SweepPlaces(root string, now time.Time, note func(string))

+ func SweepStanding(root string, now time.Time, note func(string))

+ func TakeoverPath(sessionDir string) string

+ func TaskAgeWord(d time.Duration) string

+ func TaskIndexPath(sessionFile string) string

+ func TaskKindWord(kind TaskKind) string

+ func TaskMatches(entry TaskIndexEntry, query string) bool

+ func TaskReasonOf(ending TaskEnding, report string) string

+ func TaskRecordPath(uri string) string

+ func TaskReportAccount(report, result string) string

+ func TaskResolveEnum() string

+ func TaskResolveVerbs() string

+ func TaskSlug(title string) string

+ func TaskWordsMatch(text, query string) bool

+ func TellLane(news LaneNews)

+ func TellPhase(news PhaseNews)

+ func TrustedWindow(window int) int

+ func TrustedWindowFor(model string, window int) int

+ func UnattendedNotice(config Config) string

+ func UnbilledCalls() int64

+ func UnsavedEditsNote(root string) string

+ func UsageDrops() int64

+ func UsageLedgerPath() string

+ func UsageLineDay(line UsageLine) time.Time

+ func UsageSubjectWord(kind string) string

+ func VideoDir(place Place, workspace string) string

+ func WorkPath(id string) (kind, rest string)

+ func WriteAnswer(sessionDir string, kind QuestionKind, id uint64, key string) error

+ type AbandonReason string

+ const AbandonStopTimeout

+ type ActionCategory string

+ const ActionBrowse

+ const ActionCommunicate

+ const ActionCoordinate

+ const ActionCreate

+ const ActionEdit

+ const ActionPlan

+ const ActionRead

+ const ActionRun

+ const ActionSearch

+ const ActionTest

+ const ActionTransfer

+ const ActionWait

+ const ActionWork

+ func ActionCategories() []ActionCategory

+ func ActionCategoryForTool(tool string) ActionCategory

+ func ActionCategoryForTools(tools []string) ActionCategory

+ func ParseActionCategory(word string) (ActionCategory, bool)

+ func SplitActionLine(raw string) (ActionCategory, string)

+ type AdmissionContext struct

+ Evidence []AdmissionHandle

+ Quotes []AdmissionQuote

+ Version int

+ type AdmissionHandle struct

+ Call string

+ Depth int

+ Detail string

+ From string

+ Input string

+ Outcome AdmissionOutcome

+ Result string

+ Source string

+ Tool string

+ type AdmissionOutcome string

+ const AdmissionFailed

+ const AdmissionOK

+ const AdmissionUnanswered

+ const AdmissionUnknown

+ type AdmissionQuote struct

+ Calls []string

+ Depth int

+ From string

+ ID string

+ Source string

+ Speaker string

+ Text string

+ type Agent struct

+ func New(config Config) (*Agent, error)

+ func (a *Agent) Abandon(reason AbandonReason) (Usage, bool)

+ func (a *Agent) AnchorWorkspace(path string) (string, error)

+ func (a *Agent) AnswerLaneOffer(yes bool) bool

+ func (a *Agent) AnswerSubharness(id uint64, text string, takingOver bool)

+ func (a *Agent) AskQuestion(q Question) (func(), error)

+ func (a *Agent) Attach() (events <-chan Event, running bool, stop func())

+ func (a *Agent) AttachReplay() (entries []DisplayEntry, events <-chan Event, stop func())

+ func (a *Agent) Autonomy() map[AskKind]Policy

+ func (a *Agent) Cancel(id string) (string, error)

+ func (a *Agent) CancelWithReason(id, why string) (string, error)

+ func (a *Agent) Close() error

+ func (a *Agent) Compact(ctx context.Context) error

+ func (a *Agent) CompactWithFocus(ctx context.Context, _ string) error

+ func (a *Agent) ContextTokens() int

+ func (a *Agent) ContinueTask(id uint64, words string) error

+ func (a *Agent) ConversationEffort() string

+ func (a *Agent) Decisions() []DecisionRecord

+ func (a *Agent) DefaultEffort() string

+ func (a *Agent) EarlierHistory() EarlierHistory

+ func (a *Agent) Elsewhere() Elsewhere

+ func (a *Agent) ElsewhereExcept(others ...string) Elsewhere

+ func (a *Agent) Facts() Facts

+ func (a *Agent) FollowUp(text string) (<-chan Event, error)

+ func (a *Agent) Forget(query string) (string, error)

+ func (a *Agent) HandUnverifiedToModel(id uint64) error

+ func (a *Agent) HarnessDesigns() <-chan Event

+ func (a *Agent) HoldQuestion(kind QuestionKind, token string)

+ func (a *Agent) HoldTask(id uint64)

+ func (a *Agent) Interrupt()

+ func (a *Agent) InterruptFor(door StopDoor)

+ func (a *Agent) InterruptNamed(door StopDoor, name string)

+ func (a *Agent) Land(folder string) (FolderLanding, error)

+ func (a *Agent) LandingFor(folder string) (FolderLanding, bool)

+ func (a *Agent) Memories(query string) ([]MemoryLine, error)

+ func (a *Agent) Model() string

+ func (a *Agent) NeedsPerson() bool

+ func (a *Agent) NewsKey() string

+ func (a *Agent) NoteConnected(service, account string)

+ func (a *Agent) OpenQuestions() []Question

+ func (a *Agent) OrchestrateNodeJournal(runID, nodeID string) (string, bool)

+ func (a *Agent) OrchestrateSnapshot(id string) (orchestrate.Snapshot, bool)

+ func (a *Agent) Orchestrations() <-chan Event

+ func (a *Agent) OtherProjects(now time.Time) []OtherProject

+ func (a *Agent) PendingConnect() []string

+ func (a *Agent) PendingConsent() []uint64

+ func (a *Agent) PendingDecisions() []PendingDecision

+ func (a *Agent) PendingSubharnessAsk(id uint64) bool

+ func (a *Agent) PendingTasks() []uint64

+ func (a *Agent) Places() []PlaceRef

+ func (a *Agent) ProjectPresence() []SessionPresence

+ func (a *Agent) PromoteCall(callID string) (string, bool)

+ func (a *Agent) Reasoning() string

+ func (a *Agent) ReasoningFor(model string) string

+ func (a *Agent) ReasoningLevels() map[string]string

+ func (a *Agent) ReferPlace(path string, arrival PlaceArrival) (PlaceRef, error)

+ func (a *Agent) Remember(text string) (string, error)

+ func (a *Agent) RememberScoped(text, scope string) (string, error)

+ func (a *Agent) Remembers() bool

+ func (a *Agent) RemovePlace(path string) error

+ func (a *Agent) ResolveConflict(id uint64) error

+ func (a *Agent) ResolveConnect(id string, approve bool)

+ func (a *Agent) ResolveConnectKey(id string, key string)

+ func (a *Agent) ResolveConsent(id uint64, allow bool)

+ func (a *Agent) ResolveConsentRemember(id uint64, allow bool, scope ConsentScope)

+ func (a *Agent) ResolveHarness(id uint64, run bool, model string)

+ func (a *Agent) ResolveOrchestrate(id, answer string) (string, error)

+ func (a *Agent) ResolveQuestion(answer Answer) error

+ func (a *Agent) ResolveStanding(id uint64, answer StandingAnswer)

+ func (a *Agent) ResolveSubharness(id uint64, run bool, input json.RawMessage)

+ func (a *Agent) ResolveTask(id uint64, answer TaskAnswer)

+ func (a *Agent) ResolveUnverified(id uint64, resolution TaskResolution, why string) error

+ func (a *Agent) ResolvedEffort() string

+ func (a *Agent) ResumeStoppedTurn(ctx context.Context) (<-chan Event, bool)

+ func (a *Agent) RetargetTask(id uint64, model string) (ModelLanding, error)

+ func (a *Agent) Rewind() ([]DisplayEntry, error)

+ func (a *Agent) RewindAt(index int) ([]DisplayEntry, error)

+ func (a *Agent) RewindPoints() []RewindPoint

+ func (a *Agent) RunHarnessRequest(ctx context.Context, name, text, model string) (<-chan Event, error)

+ func (a *Agent) RunOrchestrate(ctx context.Context, goal, model string, capDollars float64) (string, error)

+ func (a *Agent) SetAPIKey(key string) error

+ func (a *Agent) SetApprovalPolicy(policy *approval.Policy)

+ func (a *Agent) SetAutonomy(kind AskKind, policy Policy) error

+ func (a *Agent) SetContextWindow(tokens int)

+ func (a *Agent) SetConversationEffort(rung string) bool

+ func (a *Agent) SetModel(model string)

+ func (a *Agent) SetPlaceMode(path, word string) error

+ func (a *Agent) SetReasoning(level string)

+ func (a *Agent) SetReasoningFor(model, level string)

+ func (a *Agent) SetSources(sources modelsource.Set)

+ func (a *Agent) SetTaskEffort(id uint64, rung string) error

+ func (a *Agent) SettleWrites()

+ func (a *Agent) ShortTitle() string

+ func (a *Agent) SpellOut(ctx context.Context, draft string) string

+ func (a *Agent) StandingExcept(id string) error

+ func (a *Agent) StandingHere() (stand []standing.Item, excepted []standing.Item)

+ func (a *Agent) StandingPause(id string) (standing.Status, error)

+ func (a *Agent) StandingStandDown(id string) error

+ func (a *Agent) StandingTrees() []StandingTree

+ func (a *Agent) StartTask(ctx context.Context, brief string, solo bool) (uint64, string, string, error)

+ func (a *Agent) StateBlock() string

+ func (a *Agent) Steer(words string) (<-chan Event, error)

+ func (a *Agent) SteerOrchestrate(id, text string) error

+ func (a *Agent) SteerRepeatKnown() bool

+ func (a *Agent) SteerTask(id uint64, text string) (SteerReceipt, error)

+ func (a *Agent) SteerTaskFrom(id uint64, text string, from SteerSource) (SteerReceipt, error)

+ func (a *Agent) StillGoing() bool

+ func (a *Agent) StopWork() error

+ func (a *Agent) SubharnessIntake(name string) (SubharnessCard, error)

+ func (a *Agent) SubharnessList() []SubharnessRow

+ func (a *Agent) SubharnessRun(ctx context.Context, name string, input json.RawMessage) (uint64, string, error)

+ func (a *Agent) Submit(ctx context.Context, text string) (<-chan Event, error)

+ func (a *Agent) SubmitImage(ctx context.Context, text string, images []Image) (<-chan Event, error)

+ func (a *Agent) SubmitStanding(ctx context.Context, text string) (<-chan Event, error)

+ func (a *Agent) TakeBackDecision(id uint64) error

+ func (a *Agent) TakeoverAsked() bool

+ func (a *Agent) TaskBeat(id uint64) string

+ func (a *Agent) TaskContextTokens(id uint64) int

+ func (a *Agent) TaskEffort(id uint64) string

+ func (a *Agent) TaskIndex() []TaskIndexEntry

+ func (a *Agent) TaskJournal(id uint64) string

+ func (a *Agent) TaskUpdates() <-chan Event

+ func (a *Agent) Title() string

+ func (a *Agent) TitleChanges() <-chan Event

+ func (a *Agent) ToolOnBelt(name string) bool

+ func (a *Agent) Transcript() []DisplayEntry

+ func (a *Agent) Typing()

+ func (a *Agent) UnlandedChanges() []StandingChange

+ func (a *Agent) Usage() Usage

+ func (a *Agent) WaitingOn() string

+ func (a *Agent) Wakes() <-chan (<-chan Event)

+ func (a *Agent) WatchHarnessDesigns() (<-chan Event, func())

+ func (a *Agent) WatchOrchestrations() (<-chan Event, func())

+ func (a *Agent) WatchQuestions() (<-chan Event, func())

+ func (a *Agent) WatchTask(id uint64) (<-chan Event, error)

+ func (a *Agent) WatchTaskRoom(id uint64) (<-chan Event, func(), error)

+ func (a *Agent) WatchTaskUpdates() (<-chan Event, func())

+ func (a *Agent) WatchTitle() (<-chan Event, func())

+ func (a *Agent) WatchWakes() (<-chan (<-chan Event), func())

+ func (a *Agent) Why() string

+ func (a *Agent) WithdrawQuestion(kind QuestionKind, token, reason string)

+ func (a *Agent) WorkingNow() []WorkNode

+ type Answer struct

+ Ask AskKind

+ AskedBack []Exchange

+ At time.Time

+ Blanks map[string]string

+ Change string

+ Comments map[string]string

+ DecidedBy DecidedBy

+ Dial *float64

+ From string

+ ID uint64

+ Key string

+ Kind QuestionKind

+ Labels []string

+ Picked []string

+ Ref string

+ Reframe string

+ Revises bool

+ Scope AnswerScope

+ TakingOver bool

+ Why string

+ func DrainAnswers(sessionDir string) ([]Answer, error)

+ func (a Answer) FirstKey() string

+ func (a Answer) Keys() []string

+ func (a Answer) Words() string

+ type AnswerAction struct

+ Allow bool

+ Kind QuestionKind

+ Scope ConsentScope

+ Standing StandingAnswer

+ Task TaskAnswer

+ func AnswerFromKey(kind QuestionKind, key string) (AnswerAction, bool)

+ type AnswerOption struct

+ Blocks []Block

+ Body string

+ Consequence string

+ Dimensions map[string]string

+ Key string

+ Label string

+ Safe bool

+ Widening bool

+ func AnswerOptions(kind QuestionKind) []AnswerOption

+ func HarnessOptions(ask AskKind) []AnswerOption

+ func StandingOptions(item standing.Item) []AnswerOption

+ type AnswerScope string

+ const ScopeAlways

+ const ScopeOnce

+ const ScopeProject

+ const ScopeTask

+ type Artifact struct

+ Created time.Time

+ Kind string

+ Path string

+ Session string

+ Title string

+ func ArtifactsSince(path string, since time.Time) []Artifact

+ func ReadArtifacts(path string) []Artifact

+ type AskKind string

+ const AskAssumption

+ const AskChoice

+ const AskClarification

+ const AskConfirmation

+ const AskJudgement

+ const AskLanding

+ const AskPermission

+ const AskRatify

+ func (k AskKind) Waits() bool

+ type Asker struct

+ Kind AskerKind

+ Name string

+ type AskerKind string

+ const AskerEngine

+ const AskerModel

+ const AskerSurface

+ const AskerTask

+ const AskerWindow

+ type Blank struct

+ Choices []string

+ Default string

+ Kind BlankKind

+ Label string

+ type BlankKind string

+ const BlankChoice

+ const BlankNumber

+ const BlankPath

+ const BlankText

+ const BlankTime

+ type Block struct

+ Body string

+ Kind BlockKind

+ Path string

+ Rows [][]string

+ Title string

+ type BlockKind string

+ const BlockDiagram

+ const BlockDiff

+ const BlockImage

+ const BlockLayout

+ const BlockTable

+ const BlockText

+ type Blocking struct

+ Tasks []string

+ Turn bool

+ func (b Blocking) Blocks() bool

+ type Budget struct

+ SpentUSD float64

+ SpentWall time.Duration

+ USD float64

+ Wall time.Duration

+ func (b Budget) Exhausted() (bool, string)

+ func (b Budget) Left() (time.Duration, float64)

+ func (b Budget) Set() bool

+ type CheckRun struct

+ Command string

+ Failures []string

+ Passed bool

+ Ran bool

+ Tail string

+ Unread string

+ type Completer interface

+ CompleteWithMessages func(ctx context.Context, messages []ai.Message, options ...ai.Option) (*ai.Response, error)

+ type Confidence string

+ const ConfidenceFairly

+ const ConfidenceSure

+ const ConfidenceUnsure

+ type Config struct

+ APIKey string

+ ApprovalPolicy *approval.Policy

+ ArtifactsIndex string

+ AskConsent bool

+ Attribution bool

+ BaseURL string

+ BashBackgroundAfterSeconds int

+ Budget Budget

+ CompactEnabled bool

+ Connect *connect.Manager

+ ContextWindow int

+ ContextWindowFor func(model string) int

+ ConversationHistory ConversationHistoryReader

+ DefaultEffort effort.Rung

+ Divide bool

+ DocumentEngine string

+ Effort effort.Rung

+ EffortRole effort.Role

+ Errand bool

+ Guardian bool

+ HarnessCards bool

+ HarnessDesignWindow time.Duration

+ HarnessStore *subharness.Store

+ Harnesses []subharness.Entry

+ InTask bool

+ Interactive bool

+ Media MediaGenerator

+ MediaModel func(modality string) string

+ MediaPick func(modality, word string) (string, error)

+ Memory *store.Store

+ MemoryImport string

+ Model string

+ ModelFallbacks []string

+ ModelPrice func(model string) (prompt, completion float64, known bool)

+ NearestModels func(model string) []string

+ OneModel bool

+ OrchestrateRunner func(ctx context.Context, goal, model string, capDollars float64) (string, error)

+ Place Place

+ ProfileDir string

+ PromptProfile string

+ ReasoningProfile func(model string) (provider.ReasoningProfile, bool)

+ ReplyGuardOff bool

+ RolesSource func(key string) (string, bool)

+ Routing provider.RoutingStrategy

+ RunHarness func(ctx context.Context, name, text, model string, step func(subharness.Trail)) (string, subharness.Usage, error)

+ SearchFetcher search.Fetcher

+ SearchProvider search.Provider

+ SessionFile string

+ Sources modelsource.Set

+ SpendRailUSD float64

+ Standing *Standing

+ SubharnessLastRun func(name string) string

+ SubharnessMemory SubharnessMemory

+ SubharnessRecordRun func(name string, note SubharnessRunNote)

+ Subharnesses *exec.Registry

+ SupportsImages func(model string) bool

+ SupportsParameter func(model, parameter string) (bool, bool)

+ System string

+ TaskAudit bool

+ TaskAutoApproveSeconds int

+ TaskDeadline time.Duration

+ TaskLanes *TaskLanes

+ TaskMaxLoad float64

+ TaskMinFreeMB int

+ TaskModel string

+ TaskModels func() []string

+ TaskParallel int

+ TaskProgressCheck func(brief string, evidence []string) (working bool, reason string)

+ TaskRepairRounds int

+ TaskSettle string

+ Unattended bool

+ Workspace string

+ WorktreeRoot string

+ func (c Config) WorktreePath(jobID string) string

+ type ConsentScope string

+ const ConsentOnce

+ const ConsentRule

+ const ConsentToolSession

+ func ConsentScopeOf(action AnswerAction, answer Answer) ConsentScope

+ type ConversationHistoryReader interface

+ ConversationExchange func(context.Context, string, int64, int, int) ([]store.MessageHit, error)

+ FindConversationMessages func(context.Context, string, string, string, int) ([]store.MessageHit, error)

+ Session func(string) (store.Session, bool, error)

+ type DaySpend struct

+ At time.Time

+ Calls int

+ Label string

+ Tokens int

+ USD float64

+ func UsageByDay(lines []UsageLine, window UsageWindow) []DaySpend

+ func UsageTotals(lines []UsageLine) DaySpend

+ type DecidedBy string

+ const DecidedByAsker

+ const DecidedByDial

+ const DecidedByPerson

+ const DecidedByRecord

+ const DecidedByWindow

+ type Decision struct

+ Brief string

+ Observed []string

+ Reason string

+ Spent bool

+ Verb DecisionVerb

+ type DecisionClause struct

+ GiveUp int

+ Text string

+ type DecisionRecord struct

+ Ask AskKind

+ At time.Time

+ By DecidedBy

+ Change string

+ Head string

+ ID uint64

+ Kind QuestionKind

+ Labels []string

+ Picked []string

+ Ref string

+ Scope AnswerScope

+ Stakes Stakes

+ Subject SubjectRef

+ Was []string

+ Why string

+ func ReadDecisions(sessionDir string) ([]DecisionRecord, error)

+ func (r DecisionRecord) Line() string

+ func (r DecisionRecord) LineClauses() []DecisionClause

+ func (r DecisionRecord) Reversible() bool

+ func (r DecisionRecord) Words() string

+ type DecisionVerb string

+ const DecideCarryOn

+ const DecideDone

+ const DecideStop

+ type Dial struct

+ Default float64

+ Labels []string

+ Max float64

+ Min float64

+ type DisplayEntry struct

+ Answered bool

+ Args string

+ CallID string

+ Caption string

+ CaptionCategory ActionCategory

+ Hint string

+ ImageRefs []string

+ Output string

+ ReplyTags []TaskReplyTag

+ Role string

+ Steer *SteerMark

+ Text string

+ Took time.Duration

+ Tool string

+ type DocumentParser interface

+ ParseDocument func(context.Context, provider.DocumentRequest) (*provider.DocumentResponse, error)

+ type EarlierHistory struct

+ Entries []DisplayEntry

+ Floor int

+ type Elsewhere struct

+ Read time.Time

+ func NewElsewhere(now time.Time, names map[string]string, rows ...SessionPresence) Elsewhere

+ func ReadElsewhere(bucket string, now time.Time, exclude ...string) Elsewhere

+ func (e Elsewhere) Any() bool

+ func (e Elsewhere) Runs(entry TaskIndexEntry) bool

+ func (e Elsewhere) Tasks() []ElsewhereTask

+ func (e Elsewhere) Touching(files []string) (touching, unknown []ElsewhereTask)

+ type ElsewhereTask struct

+ Session string

+ SessionID string

+ Task PresenceTask

+ type Event struct

+ Account string

+ Answer *Answer

+ Args string

+ ArgsText string

+ Attempt int

+ Attempts int

+ AuthURL string

+ Bytes int

+ CallID string

+ Category ActionCategory

+ ConnectID string

+ Count int

+ Entry *exec.JournalEntry

+ Err error

+ Failed bool

+ Goal string

+ Harness *subharness.Harness

+ HarnessMade bool

+ Hint string

+ ID uint64

+ Job *JobNotice

+ Kind EventKind

+ Memo bool

+ Model string

+ ModelNote string

+ NeedsKey bool

+ Output string

+ Phase string

+ Question *Question

+ Retry *RetryNews

+ Rule string

+ Service string

+ ServiceName string

+ ShortTitle string

+ Stalled bool

+ Standing *StandingNotice

+ Steer *SteerNote

+ Step *subharness.Trail

+ Subharness *SubharnessCard

+ Task *TaskNotice

+ TaskPhase *TaskPhaseNotice

+ TaskReplyTags []TaskReplyTag

+ Text string

+ ThoughtTail string

+ Took time.Duration

+ Tool string

+ Usage Usage

+ Wait string

+ type EventKind int

+ const EventAssistantDone

+ const EventCaption

+ const EventCompacted

+ const EventCompacting

+ const EventConnectAsk

+ const EventConnectAuth

+ const EventConnectDone

+ const EventConsentRequest

+ const EventError

+ const EventGuardianAllowed

+ const EventHarnessDesign

+ const EventHarnessDesignDone

+ const EventHarnessDesignRevising

+ const EventHarnessOffer

+ const EventHarnessProgress

+ const EventHarnessRun

+ const EventHarnessStep

+ const EventJobUpdate

+ const EventMoved

+ const EventNotice

+ const EventNudge

+ const EventOrchestrateFuel

+ const EventOrchestrateNote

+ const EventOrchestratePause

+ const EventQuestion

+ const EventQuestionAnswered

+ const EventQuestionWithdrawn

+ const EventReasoning

+ const EventRetrying

+ const EventRowNews

+ const EventStandingProposal

+ const EventStandingUpdate

+ const EventSteerAccepted

+ const EventSteerConsumed

+ const EventSteerFellThrough

+ const EventSubharnessAsk

+ const EventSubharnessProposal

+ const EventSubharnessProposalOff

+ const EventSubharnessStep

+ const EventTakeover

+ const EventTaskPhase

+ const EventTaskProposal

+ const EventTaskReplyTags

+ const EventTaskUpdate

+ const EventTextDelta

+ const EventThinking

+ const EventTitleChanged

+ const EventToolAnnounced

+ const EventToolBegin

+ const EventToolEnd

+ const EventToolFailed

+ const EventToolFinished

+ const EventToolForming

+ const EventTurnDone

+ type Exchange struct

+ Asked string

+ At time.Time

+ Option string

+ Replied string

+ type Expectation struct

+ Absent bool

+ Fact string

+ Holds string

+ Path string

+ type FactSource interface

+ ContextTokens func() int

+ Model func() string

+ ReasoningLevels func() map[string]string

+ Title func() string

+ Usage func() Usage

+ type Facts struct

+ ContextTokens int

+ Model string

+ NeedsPerson bool

+ Places []PlaceRef

+ Reasoning map[string]string

+ ShortTitle string

+ Spent Usage

+ Thinking string

+ Title string

+ func FactsOf(source FactSource) Facts

+ func (f Facts) LevelFor(model string) string

+ type FolderLanding struct

+ Files []string

+ Folder string

+ Merged string

+ Name string

+ Note string

+ func (l FolderLanding) Kept() bool

+ func (l FolderLanding) KeptByPolicy() bool

+ type GroundRung string

+ const GroundRungCopy

+ const GroundRungHere

+ const GroundRungSnapshot

+ const GroundRungUniverse

+ type HarnessBeltSeams struct

+ ArtifactsIndex string

+ Media MediaGenerator

+ MediaModel func(modality string) string

+ MediaPick func(modality, word string) (string, error)

+ Place Place

+ Seer Completer

+ type Image struct

+ Bytes []byte

+ MIME string

+ Path string

+ type InputKind string

+ const InputBlanks

+ const InputChecklist

+ const InputDial

+ const InputNone

+ const InputPairs

+ const InputText

+ type InputShape struct

+ Blanks []Blank

+ Dial *Dial

+ Kind InputKind

+ Prompt string

+ Secret bool

+ func TaskModelShape(notice TaskNotice) InputShape

+ type JobKind string

+ const JobKindCommand

+ const JobKindRender

+ const JobKindTask

+ const JobKindWatch

+ type JobNotice struct

+ Command string

+ Detail string

+ Elapsed time.Duration

+ ExitCode int

+ ID int

+ Kind JobKind

+ LogPath string

+ Name string

+ Started time.Time

+ State JobState

+ Ticks int

+ func (n JobNotice) Label() string

+ func (n JobNotice) Over() bool

+ type JobState string

+ const JobDone

+ const JobFailed

+ const JobRunning

+ const JobStopped

+ func (s JobState) Over() bool

+ type LandedTask struct

+ Entry TaskIndexEntry

+ Session SessionRow

+ func LandedSince(w *World, since time.Time) []LandedTask

+ type Landing struct

+ Checked bool

+ Delivered bool

+ Elsewhere bool

+ Ending TaskEnding

+ Files []string

+ ID uint64

+ InPlace bool

+ Merged bool

+ Produced bool

+ Report string

+ Retained string

+ Signature string

+ State TaskState

+ Title string

+ type LaneNews struct

+ Alt string

+ At time.Time

+ Failed bool

+ Hedged bool

+ Lane string

+ Model string

+ Rate float64

+ Reason string

+ Relayed bool

+ Role lane.Role

+ Session string

+ Subject string

+ TTFT time.Duration

+ Trying bool

+ Winner string

+ type MediaGenerator interface

+ GenerateImage func(ctx context.Context, request provider.ImageRequest) (*provider.ImageResponse, error)

+ GenerateMusic func(ctx context.Context, request provider.MusicRequest) (*provider.MusicResponse, error)

+ GenerateVideo func(ctx context.Context, request provider.VideoRequest) (*provider.VideoResponse, error)

+ Speak func(ctx context.Context, request provider.SpeechRequest) (*provider.SpeechResponse, error)

+ Transcribe func(ctx context.Context, request provider.TranscriptionRequest) (*provider.TranscriptionResponse, error)

+ type MemoryLine struct

+ ID string

+ Text string

+ Title string

+ type Meta struct

+ Archived bool

+ Build string

+ Created time.Time

+ Effort string

+ ID string

+ LastUserAt time.Time

+ LaunchDir string

+ Model string

+ Owned bool

+ Places []PlaceRef

+ ShortTitle string

+ SpentUSD float64

+ Title string

+ Tokens int

+ Trees []StandingTree

+ Workspace string

+ func LoadMeta(dir string) (Meta, error)

+ type ModelLanding string

+ const ModelLandsNextRequest

+ const ModelLandsNow

+ type ModelSpend struct

+ Calls int

+ Model string

+ Tokens int

+ USD float64

+ func UsageByModel(lines []UsageLine) []ModelSpend

+ type OtherProject struct

+ Name string

+ Path string

+ Tasks []OtherProjectTask

+ func ReadOtherProjects(root, skip string, now time.Time, pid int) []OtherProject

+ type OtherProjectTask struct

+ Mine bool

+ type PendingDecision struct

+ Depth int

+ Journal string

+ Notice TaskNotice

+ func (d PendingDecision) Waiting() string

+ type Person struct

+ func NewPerson() *Person

+ func (p *Person) Acceptance() string

+ func (p *Person) Ask() string

+ func (p *Person) Budget() Budget

+ func (p *Person) Decide(r Remains) Decision

+ func (p *Person) Report(Landing) string

+ type Phase = provider.Phase

+ type PhaseNews = provider.PhaseNews

+ type Pick struct

+ Confidence Confidence

+ Key string

+ Reason string

+ WouldChange string

+ func (p *Pick) UnmarshalJSON(raw []byte) error

+ type Place struct

+ Dir string

+ Owned bool

+ Workspace string

+ func (p Place) Artifacts() string

+ func (p Place) Card() string

+ func (p Place) ID() string

+ func (p Place) Logs() string

+ func (p Place) MetaPath() string

+ func (p Place) NodeJournals() string

+ func (p Place) State() string

+ func (p Place) Tasks() string

+ func (p Place) Transcript() string

+ func (p Place) Trees() string

+ func (p Place) Work() string

+ type PlaceArrival string

+ const PlaceKept

+ const PlaceSaid

+ type PlaceRef struct

+ Arrival PlaceArrival

+ Chose string

+ Mode string

+ Path string

+ Referred time.Time

+ Repository bool

+ type PlaceSource interface

+ Places func() []PlaceRef

+ type Policy struct

+ After time.Duration

+ Kind PolicyKind

+ type PolicyKind string

+ const PolicyAsk

+ const PolicyDecide

+ const PolicyRecommendThenAuto

+ type PresenceJob struct

+ Dir string

+ ID string

+ StartedAt time.Time

+ Title string

+ type PresenceQuestion struct

+ Asked time.Time

+ Full *Question

+ ID uint64

+ Kind QuestionKind

+ Options []AnswerOption

+ Text string

+ func (q PresenceQuestion) Answerable() bool

+ func (q PresenceQuestion) Label(key string) string

+ type PresenceState string

+ const PresenceIdle

+ const PresenceWaiting

+ const PresenceWorking

+ type PresenceTask struct

+ Activity string

+ Done int

+ Files []string

+ ID string

+ Kind TaskKind

+ Parent string

+ Phase string

+ StartedAt time.Time

+ State string

+ Title string

+ Total int

+ type Principal interface

+ Acceptance func() string

+ Ask func() string

+ Budget func() Budget

+ Decide func(Remains) Decision

+ Report func(Landing) string

+ type Project struct

+ Bucket string

+ Dir string

+ Name string

+ Path string

+ Sessions []SessionRow

+ func (p Project) At() time.Time

+ func (p Project) NeedsPerson() int

+ func (p Project) Running() int

+ type Question struct

+ Ask AskKind

+ Asked time.Time

+ Asker Asker

+ Attach []Block

+ Batch string

+ Blocking Blocking

+ Deadline time.Time

+ Form QuestionForm

+ Head string

+ ID uint64

+ Input InputShape

+ Kind QuestionKind

+ Later bool

+ Options []AnswerOption

+ Pick *Pick

+ Policy Policy

+ Reason string

+ Ref string

+ Scope []AnswerScope

+ Stakes Stakes

+ Subject SubjectRef

+ Withdrawn *Withdrawal

+ func ConnectQuestion(id, name string, needsKey bool, keyAsk string, secret bool) Question

+ func HarnessQuestion(id uint64, card Event) Question

+ func (q Question) Check(records []DecisionRecord) error

+ func (q Question) Open() bool

+ func (q Question) Option(key string) (AnswerOption, bool)

+ func (q Question) Revisable() bool

+ func (q Question) SecretAnswer() bool

+ func (q Question) Token() string

+ func (q Question) Waiting() bool

+ type QuestionForm string

+ const FormCard

+ const FormLine

+ const FormRoom

+ const FormSheet

+ type QuestionKind string

+ const QuestionAsk

+ const QuestionConflict

+ const QuestionConnect

+ const QuestionConsent

+ const QuestionFuel

+ const QuestionHarness

+ const QuestionLanding

+ const QuestionStanding

+ const QuestionSubharness

+ const QuestionSubharnessAsk

+ const QuestionTask

+ type Receipt struct

+ Calls int

+ Children float64

+ Direct float64

+ Unbilled int

+ func UsageTree(lines []UsageLine, conversation string) Receipt

+ func (r Receipt) Folded() float64

+ type Record struct

+ Earlier []DisplayEntry

+ Entries []DisplayEntry

+ Floor int

+ Requests RequestBooks

+ Unreadable string

+ func ReadTranscript(path string) Record

+ func ReadTranscriptBytes(data []byte) Record

+ type Remains struct

+ Acceptance string

+ BaselineRead bool

+ Blocked []string

+ Checks []CheckRun

+ Delivery deliveryContract

+ Landed bool

+ Landings []Landing

+ Made bool

+ Reader string

+ ReaderSaysDone bool

+ ReaderUnreachable bool

+ Running []string

+ Said string

+ Stashed int

+ Unread []string

+ WasFailing []string

+ WasFailingTests map[string][]string

+ type RequestBooks struct

+ Latest int

+ Recent []RequestLine

+ type RequestLine struct

+ Input int

+ Output int

+ type RetryNews struct

+ Attempt int

+ Attempts int

+ Model string

+ Next string

+ Reason string

+ type RewindPoint struct

+ Entry int

+ Index int

+ Said string

+ Turn bool

+ type SessionLockedError struct

+ Path string

+ func (e *SessionLockedError) Error() string

+ func (e *SessionLockedError) Unwrap() error

+ type SessionPresence struct

+ Build string

+ Dir string

+ Jobs []PresenceJob

+ PID int

+ Question PresenceQuestion

+ Reason string

+ RunningTasks []PresenceTask

+ Schema int

+ SessionID string

+ State PresenceState

+ UpdatedAt time.Time

+ Workspace string

+ func HomePresence(exclude string) []SessionPresence

+ func ReadAllPresence(root string, now time.Time, exclude string) []SessionPresence

+ func ReadProjectPresence(bucket string, now time.Time, exclude ...string) []SessionPresence

+ func ReadSessionPresence(dir string, now time.Time) (SessionPresence, bool)

+ func (p SessionPresence) Fresh(now time.Time) bool

+ func (p SessionPresence) Holds(id string) bool

+ func (p SessionPresence) NeedsPerson() bool

+ func (p SessionPresence) Phase(id string) string

+ type SessionRow struct

+ Archived bool

+ At time.Time

+ Created time.Time

+ Dir string

+ ID string

+ Live bool

+ Model string

+ Open bool

+ Owned bool

+ Places []PlaceRef

+ Presence SessionPresence

+ Project string

+ ProjectDir string

+ Spend float64

+ Tasks TaskRollup

+ Title string

+ Tokens int

+ Transcript string

+ Workspace string

+ func (r SessionRow) Doing() string

+ func (r SessionRow) NeedsPerson() bool

+ func (r SessionRow) Phase(entry TaskIndexEntry) string

+ func (r SessionRow) Reason() string

+ func (r SessionRow) Runs(entry TaskIndexEntry) bool

+ type Stakes string

+ const StakesCostly

+ const StakesIrreversible

+ const StakesReversible

+ type StaleBuildRow struct

+ Build string

+ PID int

+ SessionID string

+ Workspace string

+ func SweepStaleBuilds(projectsDir, currentRev string, now time.Time) (rows []StaleBuildRow)

+ type Standing struct

+ DailyRailUSD float64

+ Store *standing.Store

+ Watch standing.Watch

+ type StandingAnswer struct

+ Approved bool

+ Change string

+ Once bool

+ type StandingChange struct

+ Files int

+ Folder string

+ Name string

+ type StandingNotice struct

+ CostWords string

+ Deadline time.Time

+ Guessed bool

+ ID uint64

+ Item standing.Item

+ Options []AnswerOption

+ Text string

+ Update string

+ WhenWords string

+ type StandingTree struct

+ Branch string

+ Cut time.Time

+ Dir string

+ Folder string

+ Home string

+ HomeSha string

+ Mode TaskMode

+ Root string

+ Wrote []string

+ type SteerMark struct

+ At time.Time

+ Consumed bool

+ Landing string

+ type SteerNote struct

+ At time.Time

+ ID uint64

+ Landing string

+ Words string

+ type SteerReceipt struct

+ Again bool

+ Direction uint64

+ Heard ModelLanding

+ Held bool

+ Landing string

+ Waiting bool

+ type SteerSource struct

+ At time.Time

+ Conversation string

+ Scope string

+ Seq uint64

+ type Steward struct

+ func NewSteward(ask string, budget Budget, spent func() float64) *Steward

+ func (s *Steward) Acceptance() string

+ func (s *Steward) Ask() string

+ func (s *Steward) Budget() Budget

+ func (s *Steward) Decide(r Remains) Decision

+ func (s *Steward) Report(landing Landing) string

+ type StopDoor string

+ const StopByAbandoned

+ const StopByClosing

+ const StopByEngineStopped

+ const StopByLeaving

+ const StopByPerson

+ const StopByRetired

+ const StopByTakeover

+ const StopByWorkStopped

+ func StoppedBy(err error) (StopDoor, bool)

+ type SubharnessCard struct

+ Fields []SubharnessField

+ Manifest exec.Manifest

+ Missing []string

+ Why string

+ type SubharnessField struct

+ Field exec.Field

+ Filled bool

+ Value json.RawMessage

+ type SubharnessMemory interface

+ Recall func(ctx context.Context, subharness, query string) ([]exec.Note, error)

+ Remember func(ctx context.Context, subharness, note string) error

+ type SubharnessRow struct

+ LastRun string

+ Manifest exec.Manifest

+ type SubharnessRunNote struct

+ At time.Time

+ CostUSD float64

+ Finished bool

+ Why string

+ type SubjectKind string

+ const SubjectAccount

+ const SubjectCall

+ const SubjectNode

+ const SubjectNone

+ const SubjectOrder

+ const SubjectPage

+ const SubjectRun

+ type SubjectRef struct

+ CallID string

+ ID uint64

+ Kind SubjectKind

+ Name string

+ Ref string

+ type SubjectSpend struct

+ Calls int

+ ID string

+ Kind string

+ Label string

+ Root string

+ Session string

+ Tokens int

+ USD float64

+ Workspace string

+ func UsageBySubject(lines []UsageLine) []SubjectSpend

+ type Summary struct

+ Asked int

+ At time.Time

+ File string

+ Last string

+ LastAssistant string

+ LastUser string

+ Opening string

+ Title string

+ func Peek(path string) (Summary, bool)

+ func Recent(dir string, limit int) []Summary

+ func RecentSessions(dir string, limit int) []Summary

+ type TaskAnswer struct

+ Approved bool

+ Model string

+ Redirect string

+ type TaskAsk struct

+ Consequence string

+ Kind TaskAskKind

+ No string

+ Owner TaskAskOwner

+ Reason string

+ Yes string

+ type TaskAskKind string

+ const TaskAskApprove

+ const TaskAskCap

+ const TaskAskCheck

+ const TaskAskConflict

+ const TaskAskHeld

+ const TaskAskStart

+ type TaskAskOwner string

+ const TaskAskOwnerModel

+ const TaskAskOwnerPerson

+ type TaskBeatRow struct

+ Node uint64

+ Phase string

+ RequestFinished time.Time

+ RequestStarted time.Time

+ Requests int

+ Started time.Time

+ Title string

+ UpdatedAt time.Time

+ func ReadTaskBeat(path string) (TaskBeatRow, bool)

+ func (r TaskBeatRow) Working() bool

+ type TaskCall struct

+ FirstToken time.Time

+ Model string

+ Phase provider.CallPhase

+ Reasoning int

+ Served string

+ Started time.Time

+ Tokens int

+ func (c *TaskCall) Received() int

+ type TaskChangeDisposition string

+ const TaskChangesConflicted

+ const TaskChangesInPlace

+ const TaskChangesKept

+ const TaskChangesMerged

+ const TaskChangesNone

+ type TaskEnding string

+ const TaskEndingBlocked

+ const TaskEndingCircling

+ const TaskEndingError

+ const TaskEndingNotes

+ const TaskEndingRefused

+ const TaskEndingStale

+ const TaskEndingSteps

+ const TaskEndingStopped

+ const TaskEndingUpstream

+ const TaskEndingWire

+ type TaskFacts struct

+ Branch string

+ Cap string

+ Conflicts []string

+ Consent bool

+ Countdown string

+ Decider TaskAskOwner

+ Ending TaskEnding

+ Gap string

+ GroundHeld bool

+ Held bool

+ Hold string

+ Kind TaskKind

+ Life string

+ Liveness TaskLiveness

+ Merge string

+ Paused bool

+ Phase string

+ Report string

+ Shifted bool

+ State TaskState

+ Stopped bool

+ Waits []string

+ type TaskGraph struct

+ type TaskIndexEntry struct

+ Activity string

+ ArtifactURI string

+ Cost float64

+ DurationMS int64

+ EndedAt time.Time

+ Ending TaskEnding

+ Files []string

+ FilesChanged int

+ Ground string

+ ID string

+ Kind TaskKind

+ Label string

+ MaySplit string

+ Mode TaskMode

+ Model string

+ Name string

+ Outcome string

+ Parent string

+ Phase string

+ RepairedOn string

+ Rung GroundRung

+ SessionID string

+ StartedAt time.Time

+ Status string

+ Title string

+ Tokens int

+ TranscriptURI string

+ Where string

+ func LandedTouching(rows []TaskIndexEntry, files []string, after time.Time) (touching, unknown []TaskIndexEntry)

+ func LookupTask(rows []TaskIndexEntry, token string) (TaskIndexEntry, bool)

+ func ReadTaskIndex(path string) []TaskIndexEntry

+ func SearchTaskIndex(rows []TaskIndexEntry, query string, limit int) []TaskIndexEntry

+ func (e TaskIndexEntry) Duration() time.Duration

+ func (e TaskIndexEntry) Live() bool

+ func (e TaskIndexEntry) StatusFacts(held bool) TaskFacts

+ type TaskKind string

+ const TaskKindAdaptive

+ const TaskKindHarness

+ const TaskKindJob

+ const TaskKindQuick

+ const TaskKindSubharness

+ type TaskLanes struct

+ func NewTaskLanes() *TaskLanes

+ type TaskLiveness string

+ const TaskLivenessHeld

+ const TaskLivenessUnclaimed

+ const TaskLivenessUnknown

+ type TaskMode string

+ const TaskModeFolder

+ const TaskModeInPlace

+ const TaskModeMirror

+ const TaskModeReference

+ const TaskModeWorktree

+ type TaskNode struct

+ Base string

+ CheckBase string

+ Checks []string

+ Expects []Expectation

+ Family []string

+ FamilyDeclared []string

+ FamilyWas []string

+ Frozen string

+ Ground string

+ Home string

+ HomeSha string

+ Mode TaskMode

+ Rung GroundRung

+ Seal string

+ Universe string

+ type TaskNotice struct

+ Acceptance string

+ Branch string

+ Brief string

+ Changed []string

+ Checked provider.Reading

+ Conflicts []string

+ Context string

+ CostUSD float64

+ Deadline time.Time

+ Decided *TaskAnswer

+ Decider TaskAskOwner

+ DependsOn []uint64

+ Doing string

+ Elapsed time.Duration

+ Elsewhere string

+ EndedAt time.Time

+ Ending TaskEnding

+ Ground string

+ GroundHeld bool

+ ID uint64

+ Kind TaskKind

+ Mending string

+ Merge string

+ Mode TaskMode

+ Model string

+ ModelOptions []string

+ NextModel string

+ Node string

+ Parent uint64

+ Paused bool

+ Report string

+ Result string

+ ResultCut bool

+ ResultHeld bool

+ ResultWhole string

+ Run string

+ Rung GroundRung

+ Shifted bool

+ StartedAt time.Time

+ State TaskState

+ Stopped bool

+ Summary string

+ Thinking string

+ Title string

+ Tokens int

+ Waiting string

+ Where string

+ Withdrawn string

+ func (n TaskNotice) StatusFacts() TaskFacts

+ type TaskPhaseNotice struct

+ Call *TaskCall

+ ID uint64

+ Phase string

+ Round int

+ Rounds int

+ Text string

+ type TaskPresence string

+ const TaskPresenceDone

+ const TaskPresenceFinishing

+ const TaskPresenceIncomplete

+ const TaskPresenceNeedsLook

+ const TaskPresenceQueued

+ const TaskPresenceStopped

+ const TaskPresenceUnknown

+ const TaskPresenceWaiting

+ const TaskPresenceWorking

+ type TaskRecord struct

+ Beat string

+ Journal []byte

+ Kept bool

+ Report string

+ func ReadTaskRecord(uri string, tail int) TaskRecord

+ func ReadTaskRecordUnder(roots []string, uri string, tail int) (TaskRecord, error)

+ type TaskReplyTag struct

+ ID uint64

+ Obligation string

+ Request string

+ Revision uint64

+ Title string

+ type TaskResolution string

+ const TaskAccept

+ const TaskReaudit

+ const TaskRefute

+ type TaskRollup struct

+ Done int

+ Failed int

+ Incomplete int

+ Newest time.Time

+ Rows []TaskIndexEntry

+ Running int

+ Spend float64

+ Tokens int

+ func (r TaskRollup) Total() int

+ type TaskSettle string

+ const TaskSettleAsk

+ const TaskSettleAuto

+ type TaskState string

+ const TaskDone

+ const TaskFailed

+ const TaskQueued

+ const TaskRunning

+ const TaskUnverified

+ type TaskStatus struct

+ Ask TaskAsk

+ Attention bool

+ Branch string

+ Changes TaskChangeDisposition

+ Ending TaskEnding

+ Fault bool

+ Liveness TaskLiveness

+ On TaskWaitOn

+ Presence TaskPresence

+ Reason string

+ State TaskState

+ Tier TaskTier

+ Word string

+ func ProjectTask(facts TaskFacts) TaskStatus

+ func (s TaskStatus) ChangesUnlanded() bool

+ func (s TaskStatus) RowWord() string

+ func (s TaskStatus) Settled() bool

+ type TaskTier string

+ const TaskTierMoving

+ const TaskTierOver

+ const TaskTierYourCall

+ type TaskWaitOn string

+ const TaskWaitMachine

+ const TaskWaitNobody

+ const TaskWaitPerson

+ const TaskWaitWork

+ type Usage struct

+ CacheRead int

+ CacheWrite int

+ Calls int

+ CostUSD float64

+ Duration time.Duration

+ EmptyReflex int

+ Input int

+ Output int

+ Turns int

+ func (u Usage) CachedShare() (float64, bool)

+ type UsageCache struct

+ Path string

+ func (c *UsageCache) Full() bool

+ func (c *UsageCache) Read(since time.Time) ([]UsageLine, error)

+ type UsageGrain string

+ const GrainDay

+ const GrainMonth

+ const GrainWeek

+ type UsageLine struct

+ At time.Time

+ Calls int

+ Day string

+ Empty bool

+ HedgeWasteUSD float64

+ Hedged bool

+ Input int

+ Lane string

+ Model string

+ Output int

+ Reconciled bool

+ Role string

+ Root string

+ Session string

+ Standing string

+ TPS float64

+ TTFTms int64

+ Task string

+ USD float64

+ Unbilled bool

+ Workspace string

+ func ReadUsage(path string, since time.Time) ([]UsageLine, error)

+ type UsageWindow struct

+ From time.Time

+ Grain UsageGrain

+ To time.Time

+ func LastDays(now time.Time, days int) UsageWindow

+ func (w UsageWindow) Buckets() int

+ func (w UsageWindow) Coarser() UsageWindow

+ func (w UsageWindow) Finer() UsageWindow

+ func (w UsageWindow) Holds(at time.Time) bool

+ func (w UsageWindow) Label() string

+ func (w UsageWindow) Normalized() UsageWindow

+ func (w UsageWindow) Step(n int) UsageWindow

+ type Withdrawal struct

+ At time.Time

+ By AskerKind

+ Reason string

+ type WorkNode struct

+ Born time.Time

+ Children []WorkNode

+ ID string

+ State WorkState

+ Title string

+ type WorkState string

+ const WorkDone

+ const WorkRunning

+ const WorkWaiting

+ type World struct

+ Artifacts []Artifact

+ Projects []Project

+ Read time.Time

+ func ReadHome() World

+ func ReadWorld(root string) World

+ func (w *World) Adopt(root string, seed SessionRow, now time.Time) bool

+ func (w World) Sessions() []SessionRow

v0.2.1-rc.3

Sep 17, 2026

v0.2.1-rc.2

Sep 17, 2026

v0.2.1-rc.1

Sep 17, 2026

v0.2.0

Sep 15, 2026

v0.1.1-rc.1

Sep 15, 2026

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