Documentation
¶
Overview ¶
Package coding composes the product-level Coding Agent runtime and defines its stable event and state boundaries.
Index ¶
- Constants
- Variables
- func MarshalEvent(event Event) ([]byte, error)
- func PublishedReloadGeneration(err error) (uint64, bool)
- func TranscriptWindowMayBeTruncated(state State) bool
- func ValidateAgentLibrary(library AgentLibrary) error
- func ValidateEvent(event Event) error
- func ValidatePromptText(text string) error
- type AgentDraft
- type AgentDraftOrigin
- type AgentDraftPreview
- type AgentDraftPromotion
- type AgentDraftScope
- type AgentDraftSummary
- type AgentLibrary
- type AgentLibraryDiagnostic
- type AgentLibraryEntry
- type AgentRunRequest
- type ApprovalKind
- type ApprovalRequired
- type ApprovalResolved
- type ApprovalState
- type ApprovalUnknown
- type AttemptBase
- type AttemptBasePreparer
- type AttemptBaseRequest
- type BackgroundTaskInspection
- type BackgroundTaskLifecycle
- type BootstrapOptions
- type BootstrapResult
- type CandidateIdentity
- type ChildControlState
- type ChildPauseKind
- type CompactionCompleted
- type CompactionMode
- type CompactionPreview
- type CompactionRequest
- type CompactionStarted
- type CompactionState
- type Disclosure
- type DurableState
- type Event
- type EventJournalDurability
- type EventObservation
- type EventPayload
- type EventRecord
- type EventSubscription
- type EventType
- type ExecutionOptions
- type ExportEvent
- type GenerateAgentDraftRequest
- type GoalChanged
- type GoalRequest
- type GoalState
- type GoalStatus
- type HistoryPage
- type HistoryRequest
- type HookDeniedError
- type HookStoppedError
- type IncompleteReply
- type IntegrationDiagnostic
- type IntegrationGeneration
- type InteractionCompleted
- type InteractionOutcome
- type InteractionRecovery
- type InteractionSource
- type InteractionStarted
- type InteractionState
- type MCPSnapshot
- type MediaCapabilityGate
- type MessageCommitted
- type MessageDelta
- type MessageDiscarded
- type ModeChanged
- type ModelRetry
- type OneShotAgentRunRequest
- type OpenOptions
- type OperatingMode
- type Phase
- type PlanDocument
- type PlanModeChanged
- type PlanReviewRequired
- type PlanReviewResolved
- type PlanReviewState
- type PromoteAgentDraftRequest
- type QuestionRejected
- type QuestionRequired
- type QuestionResolved
- type QuestionState
- type ReloadPublicationError
- type RetryState
- type RunCompleted
- type RunInterrupted
- type RunStarted
- type RunState
- type Runtime
- func (r *Runtime) ApplyTeamIntegration(ctx context.Context, approval TeamIntegrationApproval) (TeamIntegrationResult, error)
- func (r *Runtime) Cancel() error
- func (r *Runtime) CancelSubagent(ctx context.Context, childSessionID string) error
- func (r *Runtime) CleanupTeam(ctx context.Context, request TeamCleanupRequest) (TeamCleanupResult, error)
- func (r *Runtime) ClearGoal(ctx context.Context) error
- func (r *Runtime) Close(ctx context.Context) error
- func (r *Runtime) Compact(ctx context.Context, request CompactionRequest) iter.Seq2[Event, error]
- func (r *Runtime) ConfirmTeam(ctx context.Context, confirmation TeamConfirmation) (TeamReference, error)
- func (r *Runtime) ConfirmTeamNonInteractive(context.Context, TeamConfirmation) (TeamReference, error)
- func (r *Runtime) Continue(ctx context.Context) iter.Seq2[Event, error]
- func (r *Runtime) DeclineTeam(ctx context.Context, proposalID string) error
- func (r *Runtime) DiscardAgentDraft(ctx context.Context, draftID string, expectedDigest string) error
- func (r *Runtime) DiscoverTeamRecovery(ctx context.Context) ([]TeamRecoveryCandidate, error)
- func (r *Runtime) EnterPlanMode(ctx context.Context) (string, error)
- func (r *Runtime) ExitPlanMode(context.Context) (string, error)
- func (r *Runtime) FollowUp(messages ...ai.Message) error
- func (r *Runtime) Fork(ctx context.Context, entryID string) (string, error)
- func (r *Runtime) GenerateAgentDraft(ctx context.Context, request GenerateAgentDraftRequest) (AgentDraft, error)
- func (r *Runtime) GenerateTeamProposal(ctx context.Context, prompt TeamProposalPrompt) (TeamProposal, error)
- func (r *Runtime) GoalSnapshot() GoalState
- func (r *Runtime) History(ctx context.Context, request HistoryRequest) (HistoryPage, error)
- func (r *Runtime) InspectAgentDraft(ctx context.Context, draftID string) (AgentDraft, error)
- func (r *Runtime) InspectBackgroundTask(ctx context.Context, taskID string) (BackgroundTaskInspection, error)
- func (r *Runtime) InspectSubagent(ctx context.Context, childSessionID string) (subagent.Detail, error)
- func (r *Runtime) InspectSubagentState(ctx context.Context, childSessionID string) (State, error)
- func (r *Runtime) InspectTeamWorkerState(ctx context.Context, target TeamWorkerTarget) (State, error)
- func (r *Runtime) Interject(messages ...ai.Message) error
- func (r *Runtime) KillBackgroundTask(ctx context.Context, taskID string, source background.KillSource) (background.Outcome, background.Subject, error)
- func (r *Runtime) KnownBackgroundTaskIDs(ctx context.Context) []string
- func (r *Runtime) ListAgentDrafts(ctx context.Context) ([]AgentDraftSummary, error)
- func (r *Runtime) ListAgentProfiles(ctx context.Context) (AgentLibrary, error)
- func (r *Runtime) ListSubagents(ctx context.Context) ([]subagent.Summary, error)
- func (r *Runtime) ListWorkspaceFiles(ctx context.Context) (attachment.Snapshot, error)
- func (r *Runtime) MCP(ctx context.Context) (_ MCPSnapshot, returnErr error)
- func (r *Runtime) Navigate(ctx context.Context, entryID string, summarize bool) iter.Seq2[Event, error]
- func (r *Runtime) ObserveEvents() (EventObservation, error)
- func (r *Runtime) ObserveTeamWorker(ctx context.Context, target TeamWorkerTarget) (EventObservation, error)
- func (r *Runtime) PauseGoal(ctx context.Context) error
- func (r *Runtime) PlanDocumentPath() (string, error)
- func (r *Runtime) PlanState() planmode.State
- func (r *Runtime) PrepareTeamIntegration(ctx context.Context, request TeamIntegrationRequest) (TeamIntegrationPreview, error)
- func (r *Runtime) PreviewCompaction(ctx context.Context) (CompactionPreview, error)
- func (r *Runtime) PromoteAgentDraft(ctx context.Context, request PromoteAgentDraftRequest) (AgentDraftPromotion, error)
- func (r *Runtime) Prompt(ctx context.Context, messages ...ai.Message) iter.Seq2[Event, error]
- func (r *Runtime) ProposeTeam(ctx context.Context, request TeamProposalRequest) (TeamProposal, error)
- func (r *Runtime) ReadPlanDocument(ctx context.Context) (PlanDocument, error)
- func (r *Runtime) ReadTeam(ctx context.Context, request TeamReadRequest) (TeamView, error)
- func (r *Runtime) RecoverTeamIntegration(ctx context.Context, request TeamIntegrationRecoveryRequest) (TeamIntegrationResult, error)
- func (r *Runtime) RejectQuestion(ctx context.Context, requestID string, schemaDigest string) iter.Seq2[Event, error]
- func (r *Runtime) RejectSubagentQuestion(ctx context.Context, childSessionID string, requestID string, ...) (ChildControlState, error)
- func (r *Runtime) RejectTeamIntegration(ctx context.Context, approval TeamIntegrationApproval) error
- func (r *Runtime) RejectTeamWorkerQuestion(ctx context.Context, target TeamWorkerTarget, requestID string, ...) (TeamControlReference, error)
- func (r *Runtime) Reload(ctx context.Context) (returnErr error)
- func (r *Runtime) ReplacementPreflight(ctx context.Context) error
- func (r *Runtime) Resolve(ctx context.Context, resolution approval.Resolution) iter.Seq2[Event, error]
- func (r *Runtime) ResolvePlanReview(ctx context.Context, resolution planreview.Resolution) iter.Seq2[Event, error]
- func (r *Runtime) ResolveQuestion(ctx context.Context, resolution question.Resolution) iter.Seq2[Event, error]
- func (r *Runtime) ResolveSubagentApproval(ctx context.Context, childSessionID string, resolution approval.Resolution) (ChildControlState, error)
- func (r *Runtime) ResolveSubagentQuestion(ctx context.Context, childSessionID string, resolution question.Resolution) (ChildControlState, error)
- func (r *Runtime) ResolveTeamWorkerApproval(ctx context.Context, target TeamWorkerTarget, resolution approval.Resolution) (TeamControlReference, error)
- func (r *Runtime) ResolveTeamWorkerQuestion(ctx context.Context, target TeamWorkerTarget, resolution question.Resolution) (TeamControlReference, error)
- func (r *Runtime) ResolveWorkspaceFile(ctx context.Context, reference attachment.Reference) (attachment.Resolved, error)
- func (r *Runtime) ResumeGoal(ctx context.Context) iter.Seq2[Event, error]
- func (r *Runtime) ResumeTeam(ctx context.Context, teamID team.ID, decision TeamResumeDecision) (TeamReference, error)
- func (r *Runtime) ReviseTeamProposal(ctx context.Context, proposalID string, feedback string) (TeamProposal, error)
- func (r *Runtime) RunAgent(ctx context.Context, request AgentRunRequest) (subagent.Result, error)
- func (r *Runtime) RunAgentEvents(ctx context.Context, request AgentRunRequest) iter.Seq2[Event, error]
- func (r *Runtime) RunOneShotAgent(ctx context.Context, request OneShotAgentRunRequest) (subagent.Result, error)
- func (r *Runtime) SetMode(ctx context.Context, mode OperatingMode) error
- func (r *Runtime) SetSkillEnabled(ctx context.Context, id SkillID, enabled bool) error
- func (r *Runtime) Skills(ctx context.Context) (_ SkillSnapshot, returnErr error)
- func (r *Runtime) Snapshot() State
- func (r *Runtime) StartGoal(ctx context.Context, request GoalRequest) iter.Seq2[Event, error]
- func (r *Runtime) Steer(messages ...ai.Message) error
- func (r *Runtime) SubagentControlState(childSessionID string) (ChildControlState, error)
- func (r *Runtime) SubmitTeamControl(ctx context.Context, request TeamControlRequest) (TeamControlReference, error)
- func (r *Runtime) SubscribeEvents(afterCursor uint64) (*EventSubscription, error)
- func (r *Runtime) TeamIntegrationRecoveries(ctx context.Context) ([]TeamIntegrationRecovery, error)
- func (r *Runtime) TeamRecoveryCandidates() ([]TeamRecoveryCandidate, error)
- func (r *Runtime) Tree(ctx context.Context) (SessionTree, error)
- func (r *Runtime) WaitSubagent(ctx context.Context, childSessionID string) (subagent.Result, error)
- func (r *Runtime) WorkspaceStatus(ctx context.Context) (changes.WorktreeStatus, error)
- type RuntimeError
- type RuntimeStateError
- type SessionCloseReason
- type SessionClosed
- type SessionForked
- type SessionNavigated
- type SessionNode
- type SessionNodeKind
- type SessionOpened
- type SessionTarget
- type SessionTree
- type SessionTreeChanged
- type SkillDiagnostic
- type SkillID
- type SkillSnapshot
- type SkillSource
- type SkillSummary
- type State
- type StatusChanged
- type StreamDraft
- func (draft StreamDraft) Append(delta MessageDelta) StreamDraft
- func (draft StreamDraft) AppendBatch(deltas []MessageDelta) StreamDraft
- func (draft StreamDraft) Equal(other StreamDraft) bool
- func (draft StreamDraft) HasReasoningDelta() bool
- func (draft StreamDraft) HasTextDelta() bool
- func (draft StreamDraft) Len() int
- func (draft StreamDraft) MarshalJSON() ([]byte, error)
- func (draft StreamDraft) Materialize() []MessageDelta
- func (draft StreamDraft) ReasoningText() string
- func (draft StreamDraft) Text() string
- func (draft *StreamDraft) UnmarshalJSON(data []byte) error
- type SubagentLifecycle
- type SubagentState
- type TeamActivity
- type TeamAdmissionMode
- type TeamAttemptRecoveryCandidate
- type TeamAttemptView
- type TeamChangeView
- type TeamCleanupRequest
- type TeamCleanupResult
- type TeamCleanupView
- type TeamConfirmation
- type TeamControlAction
- type TeamControlLifecycle
- type TeamControlLifecycleState
- type TeamControlReference
- type TeamControlRequest
- type TeamControlStatus
- type TeamControlView
- type TeamIntegrationApproval
- type TeamIntegrationLifecycle
- type TeamIntegrationLifecycleState
- type TeamIntegrationPreview
- type TeamIntegrationRecovery
- type TeamIntegrationRecoveryRequest
- type TeamIntegrationRequest
- type TeamIntegrationResult
- type TeamIntegrationStatus
- type TeamLifecycle
- type TeamLifecycleState
- type TeamLifecycleStatus
- type TeamMemberView
- type TeamProposal
- type TeamProposalPrompt
- type TeamProposalRequest
- type TeamReadRequest
- type TeamRecoveryCandidate
- type TeamRecoveryDiagnostic
- type TeamRecoveryDisposition
- type TeamReference
- type TeamResumeDecision
- type TeamTaskSpec
- type TeamTaskView
- type TeamView
- type TeamWorkerSpec
- type TeamWorkerTarget
- type TelemetryEvent
- type TelemetryObserver
- type TelemetryObserverFunc
- type TelemetrySignal
- type TokenUsage
- type ToolCall
- type ToolCompleted
- type ToolStarted
- type ToolState
- type ToolStatus
- type ToolUpdated
- type TurnCompleted
- type TurnStarted
- type WorkspaceChange
- type WorkspaceChanged
Constants ¶
const ( HistoryPageDefaultLimit = 100 HistoryPageMaxLimit = 200 )
History page bounds. A history read is a bounded backward walk over the durable session path, so a caller cannot ask for an unbounded payload.
const ( ModeAgent = config.ModeAgent ModePlan = config.ModePlan )
Supported Coding Agent operating modes.
const CompactionStrategyFull = "full"
CompactionStrategyFull selects full context reconstruction with an archive.
const (
// EventSchema is the current Coding Agent event envelope schema.
EventSchema = "pips.coding.event/v1alpha1"
)
const ( // MaxPromptTextBytes is the largest UTF-8 text prompt accepted by Coding // frontends and Runtime. MaxPromptTextBytes = maxEventTextBytes )
const ( // SendMessageToolName is the stable main-agent child messaging protocol // name. SendMessageToolName = "send_subagent_message" )
Variables ¶
var ( // ErrInvalidEvent means an event or payload violates the Coding event contract. ErrInvalidEvent = errors.New("coding event: invalid event") // ErrEventProtocol means an event cannot follow the preceding reducer state. ErrEventProtocol = errors.New("coding event: protocol violation") // ErrUnsafeEventEncoding prevents direct serialization that bypasses disclosure. ErrUnsafeEventEncoding = errors.New("coding event: disclosure projection required") )
var ( // ErrEventGap means a subscriber can no longer continue from its cursor. // Callers must obtain a fresh snapshot and subscription. ErrEventGap = errors.New("coding runtime: event subscription gap") // ErrEventStreamClosed means the Runtime no longer accepts subscriptions. ErrEventStreamClosed = errors.New("coding runtime: event stream closed") )
var ( ErrGoalExists = errors.New("coding goal: clear the existing Goal before replacing it") ErrGoalMissing = errors.New("coding goal: no Goal to resume") ErrGoalIncomplete = errors.New("coding goal: completion is not verified") )
Goal control errors.
var ( // ErrRuntimeBusy means another Runtime operation owns the session. ErrRuntimeBusy = errors.New("coding runtime: busy") // ErrRuntimeClosed means the Runtime no longer owns its resources. ErrRuntimeClosed = errors.New("coding runtime: closed") // ErrRuntimePending means durable tool calls must be continued or resolved. ErrRuntimePending = errors.New("coding runtime: pending approval") // ErrRuntimeNotPaused means approval resolution requires a paused interaction. ErrRuntimeNotPaused = errors.New("coding runtime: not paused") // ErrRuntimeInvalid means Runtime construction input is incomplete or inconsistent. ErrRuntimeInvalid = errors.New("coding runtime: invalid options") // ErrAgentDraft means a model-generated Agent proposal or explicit local // promotion violated the non-executable draft contract. ErrAgentDraft = errors.New("coding runtime: invalid Agent draft") // ErrInputRequired means a non-interactive client encountered a structured // user question that it must not answer implicitly. ErrInputRequired = errors.New("coding runtime: structured user input required") // ErrPlanReviewRequired means a non-interactive client encountered a Plan // review decision that it must not answer implicitly. ErrPlanReviewRequired = errors.New("coding runtime: Plan review required") // ErrLegacyToolCallUnresolved means a resumed Session contains a pending // call for a removed pre-P1 Coding Tool protocol. It is never replayed or // guessed under the replacement name. ErrLegacyToolCallUnresolved = errors.New("coding runtime: legacy tool call unresolved") // produce a safe compaction plan. ErrCompactionUnavailable = errors.New("coding runtime: compaction unavailable") // ErrCompactionStale means history changed after preview and confirmation // must be requested again. ErrCompactionStale = errors.New("coding runtime: compaction preview is stale") // ErrCompactionRetrySuppressed prevents automatic compaction thrashing on // an unchanged leaf after a prior model or persistence failure. ErrCompactionRetrySuppressed = errors.New("coding runtime: automatic compaction retry suppressed") // ErrHookDenied means a trusted UserPromptSubmit lifecycle hook explicitly // rejected a prompt before an interaction was created. ErrHookDenied = errors.New("coding runtime: prompt denied by hook") // ErrHookStopped means a lifecycle hook stopped the event-specific // continuation without turning it into a Runtime failure. ErrHookStopped = errors.New("coding runtime: lifecycle event stopped by hook") )
var ( // ErrTeamAdmission reports a malformed or unavailable Team admission. ErrTeamAdmission = errors.New("coding Team admission failed") // ErrTeamRepositoryRequired reports a Workspace that cannot provide the // committed repository root required for isolated Worker Worktrees. ErrTeamRepositoryRequired = errors.New("coding Team requires a repository root with HEAD") // ErrTeamActive reports an existing proposal or admitted Team owner. ErrTeamActive = errors.New("coding Team is already active") // ErrTeamProposalNotFound reports an unknown or already consumed proposal. ErrTeamProposalNotFound = errors.New("coding Team proposal not found") // ErrTeamProposalStale reports repository or Runtime drift after preview. ErrTeamProposalStale = errors.New("coding Team proposal is stale") // ErrTeamDirty requires an explicit HEAD-only admission choice. ErrTeamDirty = errors.New("coding Team workspace has uncommitted changes") // ErrTeamInteractionRequired prevents implicit writable non-interactive admission. ErrTeamInteractionRequired = errors.New("interaction_required") )
var ( ErrTeamCleanupUnavailable = errors.New("coding Team cleanup unavailable") // ErrTeamCleanupStale means the reviewed Team resource revision changed. ErrTeamCleanupStale = errors.New("coding Team cleanup review is stale") // ErrTeamCleanupIntegrationRequired means Integration must be applied, recovered, or rejected first. ErrTeamCleanupIntegrationRequired = errors.New("coding Team cleanup requires an Integration decision") // ErrTeamCleanupRetained means one or more exact resources were deliberately preserved. ErrTeamCleanupRetained = errors.New("coding Team cleanup retained resources") )
var ( ErrTeamIntegrationUnavailable = errors.New("coding Team integration unavailable") // ErrTeamIntegrationSelection means selected Tasks do not have one exact captured result closure. ErrTeamIntegrationSelection = errors.New("coding Team integration selection is invalid") )
var ( // ErrTeamRecoveryNotFound means the requested Team is not a retained // candidate owned by the current Lead Session. ErrTeamRecoveryNotFound = errors.New("coding Team recovery candidate not found") // ErrTeamRecoveryStale means durable state changed after the candidate was // presented and the user must review a fresh candidate. ErrTeamRecoveryStale = errors.New("coding Team recovery candidate is stale") // ErrTeamRecoveryBlocked means exact identity or lifecycle validation does // not permit automatic recovery. ErrTeamRecoveryBlocked = errors.New("coding Team recovery is blocked") // ErrTeamRecoveryDecisionRequired prevents replaying interrupted Work // without an explicit user decision. ErrTeamRecoveryDecisionRequired = errors.New("coding Team recovery decision is required") )
var ( ErrTeamReadUnavailable = errors.New("coding Team view unavailable") // ErrTeamReadStale means a caller supplied a cursor newer than durable Team state. ErrTeamReadStale = errors.New("coding Team view cursor is stale") )
var ErrAttemptBaseConflict = errors.New("coding Team dependency base conflict")
ErrAttemptBaseConflict tells the trusted AttemptBasePreparer that captured dependency deltas cannot be composed without choosing a conflicting side. The owner projects it to blocked/conflicted state without opening a Worker.
ErrHistoryUnavailable means the Runtime has no open session to read history from.
var ErrInvalidPrompt = errors.New("coding prompt: invalid text")
ErrInvalidPrompt means prompt text is empty, malformed, or exceeds the bounded Runtime input contract.
var ErrTeamWorkerStale = errors.New("coding Team Worker target is stale")
ErrTeamWorkerStale means an inspection target no longer identifies the exact durable Attempt owner generation reviewed by the caller.
Functions ¶
func MarshalEvent ¶
MarshalEvent performs explicit full-content serialization for trusted local round trips. Persistence and process boundaries should marshal ExportEvent.
func PublishedReloadGeneration ¶
PublishedReloadGeneration reports whether err describes a reload whose candidate was already published. The returned generation ID is zero when err is nil or when the failure happened before publication.
func TranscriptWindowMayBeTruncated ¶ added in v0.1.6
TranscriptWindowMayBeTruncated reports whether the loaded conversation window is at the bootstrap cap, which means older durable messages may exist outside it.
It is a hint rather than proof: a session with exactly the cap many messages reports true and has no older page, in which case the first history read simply returns nothing.
func ValidateAgentLibrary ¶
func ValidateAgentLibrary(library AgentLibrary) error
ValidateAgentLibrary is retained as a narrow invariant check for callers that cache Library data across UI updates.
func ValidateEvent ¶
ValidateEvent verifies the envelope, payload discriminator, and bounded content.
func ValidatePromptText ¶
ValidatePromptText validates a text-only prompt without normalizing it.
Types ¶
type AgentDraft ¶
type AgentDraft struct {
Summary AgentDraftSummary
Origin AgentDraftOrigin
Definition []byte
Preview AgentDraftPreview
}
AgentDraft is the full local review surface. Definition is never written to a Session, Event, telemetry projection, or filesystem before promotion.
func (AgentDraft) Clone ¶
func (d AgentDraft) Clone() AgentDraft
Clone returns a fully detached Draft.
type AgentDraftOrigin ¶
type AgentDraftOrigin struct {
SessionID string `json:"session_id"`
InteractionID string `json:"interaction_id"`
RunID string `json:"run_id"`
Provider ai.Provider `json:"provider"`
Model string `json:"model"`
GenerationID uint64 `json:"generation_id"`
}
AgentDraftOrigin is content-free provenance for one ephemeral proposal run.
type AgentDraftPreview ¶
type AgentDraftPreview struct {
GenerationID uint64 `json:"generation_id"`
PlanDigest string `json:"plan_digest"`
Model string `json:"model"`
DeclaredTools []string `json:"declared_tools"`
Capabilities []subagent.EffectiveCapability `json:"capabilities"`
DeclaredSkills []string `json:"declared_skills"`
Skills []string `json:"skills"`
PreloadedSkills []string `json:"preloaded_skills"`
DelegationTargets []string `json:"delegation_targets"`
PrivateMCP []string `json:"private_mcp"`
PrivateHooks []string `json:"private_hooks"`
ToolSearch bool `json:"tool_search"`
Limits subagent.Limits `json:"limits"`
Output subagent.OutputContract `json:"output"`
}
AgentDraftPreview is the detached declared/effective authority comparison compiled from the immutable generation captured during proposal review.
func (AgentDraftPreview) Clone ¶
func (p AgentDraftPreview) Clone() AgentDraftPreview
Clone returns a fully detached preview.
type AgentDraftPromotion ¶
type AgentDraftPromotion struct {
AgentID string `json:"agent_id"`
Scope AgentDraftScope `json:"scope"`
DefinitionDigest string `json:"definition_digest"`
Target string `json:"target"`
GenerationID uint64 `json:"generation_id"`
ReloadRequired bool `json:"reload_required"`
}
AgentDraftPromotion is the explicit local result. Target is returned only to the user-facing caller and is not written to Runtime events or telemetry.
type AgentDraftScope ¶
type AgentDraftScope string
AgentDraftScope selects the only two private Pips Agent roots eligible for explicit draft promotion.
const ( // AgentDraftScopeUser targets the user-owned Pips Agent root. AgentDraftScopeUser AgentDraftScope = "user" // AgentDraftScopeProject targets the trusted Workspace's Pips Agent root. AgentDraftScopeProject AgentDraftScope = "project" )
type AgentDraftSummary ¶
type AgentDraftSummary struct {
DraftID string `json:"draft_id"`
AgentID string `json:"agent_id"`
Scope AgentDraftScope `json:"scope"`
DefinitionDigest string `json:"definition_digest"`
CreatedAt time.Time `json:"created_at"`
GenerationID uint64 `json:"generation_id"`
EffectiveToolCount int `json:"effective_tool_count"`
SelectedSkillCount int `json:"selected_skill_count"`
PrivateBindingCount int `json:"private_binding_count"`
}
AgentDraftSummary is safe for list views. It deliberately omits model output, description, selectors, definition content, paths, and opaque plan bindings.
type AgentLibrary ¶
type AgentLibrary struct {
Entries []AgentLibraryEntry
}
AgentLibrary is the content-safe, user-facing view of the immutable Agent registry. It deliberately excludes definition instructions and output JSON Schema: those are execution inputs, not library metadata.
func (AgentLibrary) Clone ¶
func (l AgentLibrary) Clone() AgentLibrary
Clone returns a detached library snapshot.
type AgentLibraryDiagnostic ¶
AgentLibraryDiagnostic is a bounded, content-free profile diagnostic.
type AgentLibraryEntry ¶
type AgentLibraryEntry struct {
ID string
Kind string
Scope string
Source string
Digest string
Status string
SuppressedBy string
Name string
Description string
Model string
UserVisible bool
ModelVisible bool
Delivery []string
DeclaredTools []string
RequiredTools []string
ToolSearch bool
Skills []string
Preloaded []string
OutputFormat string
Available bool
Diagnostics []AgentLibraryDiagnostic
}
AgentLibraryEntry is a content-safe discovery and availability projection. DeclaredTools and RequiredTools are requests made by the definition; they are not an authority grant. Effective capabilities are captured in the durable child execution plan when a child is actually admitted.
type AgentRunRequest ¶
AgentRunRequest is an explicit user-authored foreground invocation. The selected Agent ID is never inferred from a model response. Custom IDs are resolved only through the interaction-scoped visibility.user dispatcher.
type ApprovalKind ¶
type ApprovalKind string
ApprovalKind identifies the approval overlay content.
const ( ApprovalNone ApprovalKind = "" ApprovalReview ApprovalKind = "review" ApprovalUncertain ApprovalKind = "unknown" )
Approval overlay states.
type ApprovalRequired ¶
type ApprovalRequired struct {
RequestID string `json:"request_id"`
CallID string `json:"call_id"`
Tool string `json:"tool"`
Command []string `json:"command,omitempty"`
CWD string `json:"cwd,omitempty"`
Justification string `json:"justification,omitempty"`
Choices []approval.Choice `json:"choices"`
}
ApprovalRequired describes an exact pending operation for the approval overlay.
type ApprovalResolved ¶
type ApprovalResolved struct {
RequestID string `json:"request_id"`
Choice approval.Choice `json:"choice"`
}
ApprovalResolved carries the explicit choice durably applied to a request.
type ApprovalState ¶
type ApprovalState struct {
Kind ApprovalKind `json:"kind,omitempty"`
RequestedAt time.Time `json:"requested_at,omitzero"`
Required *ApprovalRequired `json:"required,omitempty"`
Unknown *ApprovalUnknown `json:"unknown,omitempty"`
}
ApprovalState is the current approval overlay projection.
func (ApprovalState) NonInteractiveError ¶
func (state ApprovalState) NonInteractiveError() error
NonInteractiveError projects the approval overlay into the fail-fast contract shared by non-interactive frontends.
type ApprovalUnknown ¶
type ApprovalUnknown struct {
RequestID string `json:"request_id"`
CallID string `json:"call_id"`
Tool string `json:"tool"`
Fingerprint string `json:"fingerprint"`
Attempt int `json:"attempt"`
Pending bool `json:"pending"`
Reason string `json:"reason,omitempty"`
Recoverable bool `json:"recoverable"`
Choices []approval.Choice `json:"choices"`
}
ApprovalUnknown describes an operation whose durable result is uncertain.
type AttemptBase ¶
type AttemptBase struct {
OID string
Evidence string
Resource teamstate.AttemptBaseResource
}
AttemptBase identifies the exact commit and bounded evidence exposed to a Worker. Base preparation is trusted control-plane work, never model input.
type AttemptBasePreparer ¶
type AttemptBasePreparer interface {
PrepareAttemptBase(context.Context, AttemptBaseRequest) (AttemptBase, error)
}
AttemptBasePreparer composes the immutable Git base for one Attempt.
type AttemptBaseRequest ¶
type AttemptBaseRequest struct {
Team team.Team
Task team.Task
AttemptID team.AttemptID
Resources teamstate.Snapshot
}
AttemptBaseRequest is the immutable input for dependency-aware base preparation. The default implementation accepts only dependency-free tasks; the Integration phase supplies composition for captured dependency results.
type BackgroundTaskInspection ¶ added in v0.1.9
type BackgroundTaskInspection struct {
Task background.Snapshot
Output string
}
BackgroundTaskInspection is one bounded view of a registered background task: its snapshot and a bounded, sanitized tail of the task's own output. No rendering surface holds more than this, so an inspect can never grow with a watch's log.
func (BackgroundTaskInspection) Lifecycle ¶ added in v0.1.9
func (i BackgroundTaskInspection) Lifecycle() BackgroundTaskLifecycle
Lifecycle projects the inspection's snapshot into the record the tasks pane and the event stream read, so every surface describes one task the same way.
type BackgroundTaskLifecycle ¶ added in v0.1.9
type BackgroundTaskLifecycle struct {
ID string `json:"id"`
Kind string `json:"kind"`
Description string `json:"description,omitempty"`
Command string `json:"command,omitempty"`
StartedAt time.Time `json:"started_at,omitzero"`
EndedAt time.Time `json:"ended_at,omitzero"`
Completed bool `json:"completed"`
ExitCode int `json:"exit_code,omitempty"`
Signal string `json:"signal,omitempty"`
}
BackgroundTaskLifecycle is one registered background task's compact projection. It is what the tasks pane lists under Watchers: the id, the kind, the description-preferred text, and the running state. A task's output is never part of it — a monitor's stdout reaches the model as events, not as pane content.
type BootstrapOptions ¶
type BootstrapOptions struct {
SessionID string
Provider ai.Provider
ModelID string
ContextWindow int
PlanMode planmode.State
Path []harness.Entry
HasPendingToolCalls bool
Tree harness.TreeSnapshot
}
BootstrapOptions describe one already-open durable Harness session.
type BootstrapResult ¶
type BootstrapResult struct {
State State
Recovery InteractionRecovery
// OrphanedToolCalls reports a durable tail of tool calls that have no
// results while no interaction is pending. The calls are not corruption:
// a stop landed between the assistant message that carries them and its
// results, and never wrote the journal's terminal record. The caller
// settles them before another operation can run.
OrphanedToolCalls bool
}
BootstrapResult contains restart state and the interaction journal projection.
func BootstrapState ¶
func BootstrapState(options BootstrapOptions) (BootstrapResult, error)
BootstrapState reconstructs durable frontend state without allocating live event sequence numbers.
type CandidateIdentity ¶
CandidateIdentity binds provisional deltas and their eventual commit or discard to one Agent run and turn. Text equality is never ownership.
func (CandidateIdentity) Key ¶
func (identity CandidateIdentity) Key() string
Key returns a stable frontend-local identity string.
type ChildControlState ¶
type ChildControlState struct {
ChildSessionID string
Pause ChildPauseKind
Approval approval.State
Question *question.Request
}
ChildControlState is the bounded, targetable control projection for one running custom child. It intentionally excludes raw tool output and profile instructions; durable detail remains in the child session.
func (ChildControlState) Clone ¶
func (s ChildControlState) Clone() ChildControlState
Clone returns a detached child-control projection.
type ChildPauseKind ¶
type ChildPauseKind string
ChildPauseKind identifies the independently resolvable input owner of a live custom child execution.
const ( // ChildPauseNone means the child has no unresolved input boundary. ChildPauseNone ChildPauseKind = "" // ChildPauseApproval means the child is waiting for its own approval decision. ChildPauseApproval ChildPauseKind = "approval" // ChildPauseQuestion means the child is waiting for its own structured answer. ChildPauseQuestion ChildPauseKind = "question" )
type CompactionCompleted ¶
type CompactionCompleted struct {
Mode CompactionMode `json:"mode"`
TokensBefore int `json:"tokens_before"`
TokensAfter int `json:"tokens_after"`
FirstKeptID string `json:"first_kept_id,omitempty"`
DurationMillis int64 `json:"duration_ms"`
CheckpointID string `json:"checkpoint_id,omitempty"`
Strategy string `json:"strategy,omitempty"`
}
CompactionCompleted announces one durably committed compaction.
type CompactionMode ¶
type CompactionMode string
CompactionMode identifies why compaction runs.
const ( CompactionManual CompactionMode = "manual" CompactionAutomatic CompactionMode = "automatic" )
Compaction modes.
type CompactionPreview ¶
type CompactionPreview struct {
Available bool `json:"available"`
DisabledReason string `json:"disabled_reason,omitempty"`
Token string `json:"token,omitempty"`
EstimatedTokens int `json:"estimated_tokens"`
ThresholdTokens int `json:"threshold_tokens"`
SummarizedMessages int `json:"summarized_messages"`
KeptMessages int `json:"kept_messages"`
FirstKeptID string `json:"first_kept_id,omitempty"`
SplitTurn bool `json:"split_turn"`
Strategy string `json:"strategy,omitempty"`
SourceLeafID string `json:"source_leaf_id,omitempty"`
}
CompactionPreview is a content-free, point-in-time compaction plan. Token binds confirmation to the exact durable leaf and budget snapshot.
type CompactionRequest ¶
CompactionRequest confirms a preview. Instructions are content-bearing and are never copied into Coding events or telemetry.
type CompactionStarted ¶
type CompactionStarted struct {
Mode CompactionMode `json:"mode"`
Preview CompactionPreview `json:"preview"`
}
CompactionStarted announces a manual or automatic compaction before model I/O.
type CompactionState ¶
type CompactionState struct {
Active bool `json:"active"`
Mode CompactionMode `json:"mode,omitempty"`
Preview CompactionPreview `json:"preview"`
TokensBefore int `json:"tokens_before"`
TokensAfter int `json:"tokens_after"`
FirstKeptID string `json:"first_kept_id,omitempty"`
DurationMillis int64 `json:"duration_ms"`
CheckpointID string `json:"checkpoint_id,omitempty"`
Strategy string `json:"strategy,omitempty"`
// BoundaryIndex is where the checkpoint falls in the bounded transcript the
// frontend received: the messages before it belong to the old branch and the
// messages after it belong to the context that follows the checkpoint. It is
// derived from the durable path, so a truncated tree does not hide the
// boundary.
BoundaryIndex int `json:"boundary_index,omitempty"`
}
CompactionState is the latest reducer projection of compaction lifecycle.
type Disclosure ¶
type Disclosure uint8
Disclosure selects the content retained at a serialization boundary.
const ( DisclosureSafe Disclosure = iota DisclosureContent )
Disclosure policies. Safe is the default for JSONL and non-interactive use.
type DurableState ¶
type DurableState struct {
SessionID string `json:"session_id"`
SessionOpen bool `json:"session_open"`
Provider ai.Provider `json:"provider,omitempty"`
ModelID string `json:"model_id,omitempty"`
Interaction InteractionState `json:"interaction"`
Transcript ai.Messages `json:"transcript"`
SyntheticMessages []int `json:"synthetic_messages,omitempty"`
Approval ApprovalState `json:"approval"`
Tree SessionTree `json:"tree"`
Compaction CompactionState `json:"compaction"`
}
DurableState is the restart-stable subset of State.
type Event ¶
type Event struct {
Schema string `json:"schema"`
Sequence uint64 `json:"sequence"`
Time time.Time `json:"time"`
SessionID string `json:"session_id"`
InteractionID string `json:"interaction_id,omitempty"`
RunID string `json:"run_id,omitempty"`
Type EventType `json:"type"`
Payload EventPayload `json:"-"`
}
Event is one immutable-by-contract increment in a Runtime event stream. Serialize it only through Project or MarshalEvent.
func UnmarshalEvent ¶
UnmarshalEvent strictly decodes one complete Coding event object.
func (Event) MarshalJSON ¶
MarshalJSON rejects direct Event serialization so callers cannot bypass the disclosure projection required at persistence and process boundaries.
func (*Event) UnmarshalJSON ¶
UnmarshalJSON performs strict event decoding.
type EventJournalDurability ¶ added in v0.1.9
type EventJournalDurability uint8
EventJournalDurability classifies whether a committed coding event belongs in the durable session journal. A live-only event is a projection for connected frontends: its content is derivable from the authoritative transcript and it must never be persisted as a journal record.
const ( // EventJournalDurable means the event is a durable lifecycle or audit fact. EventJournalDurable EventJournalDurability = iota // EventJournalLiveOnly means the event exists only for the live projection. EventJournalLiveOnly )
func JournalDurability ¶ added in v0.1.9
func JournalDurability(eventType EventType) EventJournalDurability
JournalDurability reports the persistence policy for one event type.
Streaming deltas and retry notices build a message that is already recorded by message.committed and the transcript. session.tree_changed carries a full transcript snapshot; persisting it duplicates the transcript and turns every interaction into an O(transcript) journal record. All three stay live-only.
type EventObservation ¶
type EventObservation struct {
State State
Children map[string]State
Cursor uint64
Subscription *EventSubscription
}
EventObservation atomically pairs the current Runtime State with a subscription that starts immediately after Cursor.
type EventPayload ¶
type EventPayload interface {
// contains filtered or unexported methods
}
EventPayload is the sealed set of Coding event payloads.
type EventRecord ¶
EventRecord pairs a Runtime-local broadcast cursor with one Coding event. Cursor is intentionally independent from Event.Sequence so a future hub can also carry child Session events without changing the per-Session protocol.
type EventSubscription ¶
type EventSubscription struct {
// contains filtered or unexported fields
}
EventSubscription is one bounded, independently cancelable Runtime event consumer. A slow consumer is closed with ErrEventGap; it never applies backpressure to the Runtime or its Agent execution.
func (*EventSubscription) Close ¶
func (s *EventSubscription) Close()
Close stops this consumer without affecting the Runtime or other consumers.
func (*EventSubscription) Err ¶
func (s *EventSubscription) Err() error
Err reports why the subscription ended. It returns nil for an explicit Close or a normal Runtime event-stream close.
func (*EventSubscription) Events ¶
func (s *EventSubscription) Events() <-chan EventRecord
Events returns the ordered event channel owned by the subscription.
type EventType ¶
type EventType string
EventType discriminates Coding Agent event payloads.
const ( EventSessionOpened EventType = "session.opened" EventSessionClosed EventType = "session.closed" EventSessionTreeChanged EventType = "session.tree_changed" EventSessionForked EventType = "session.forked" EventCompactionStarted EventType = "compaction.started" EventCompactionCompleted EventType = "compaction.completed" EventModeChanged EventType = "mode.changed" EventInteractionStarted EventType = "interaction.started" EventInteractionCompleted EventType = "interaction.completed" EventRunStarted EventType = "run.started" EventRunCompleted EventType = "run.completed" EventRunInterrupted EventType = "run.interrupted" EventTurnStarted EventType = "turn.started" EventTurnCompleted EventType = "turn.completed" EventMessageCommitted EventType = "message.committed" EventMessageDelta EventType = "message.delta" EventMessageDiscarded EventType = "message.discarded" EventMessageIncomplete EventType = "message.incomplete" EventModelRetry EventType = "model.retry" EventToolStarted EventType = "tool.started" EventToolUpdated EventType = "tool.updated" EventToolCompleted EventType = "tool.completed" EventSubagentCreated EventType = "subagent.created" EventSubagentStarted EventType = "subagent.started" EventSubagentProgress EventType = "subagent.progress" EventSubagentCompleted EventType = "subagent.completed" EventSubagentFailed EventType = "subagent.failed" EventSubagentCanceled EventType = "subagent.canceled" EventSubagentInterrupted EventType = "subagent.interrupted" EventBackgroundStarted EventType = "background.started" EventBackgroundCompleted EventType = "background.completed" EventTeamLifecycle EventType = "team.lifecycle" EventTeamControlLifecycle EventType = "team.control" EventTeamIntegrationLifecycle EventType = "team.integration" EventApprovalRequired EventType = "approval.required" EventApprovalUnknown EventType = "approval.unknown" EventApprovalResolved EventType = "approval.resolved" EventQuestionRequired EventType = "question.required" EventQuestionResolved EventType = "question.resolved" EventQuestionRejected EventType = "question.rejected" EventPlanReviewRequired EventType = "plan_review.required" EventPlanReviewResolved EventType = "plan_review.resolved" EventPlanModeChanged EventType = "plan_mode.changed" EventWorkspaceChanged EventType = "workspace.changed" EventStatusChanged EventType = "status.changed" EventIntegrationDiagnostic EventType = "integration.diagnostic" EventError EventType = "error" )
Coding Agent event types.
const EventGoalChanged EventType = "goal.changed"
EventGoalChanged replaces the session Goal projection.
type ExecutionOptions ¶
type ExecutionOptions struct {
TempRoot string
GitPath string
Environment func(string) (string, bool)
// HooksEnvironment is the invoking process environment snapshot supplied
// to reviewed lifecycle hook commands. It is intentionally distinct from
// Environment, which is a lookup used by Coding tool execution.
HooksEnvironment []string
SandboxProbe func(context.Context, *execution.Executor) error
ToolTimeout time.Duration
HTTPClient *http.Client
MCPClient *sdk.Implementation
MCPTerminate time.Duration
MCPMaxTools int
ResourceLimits resource.Limits
AgentProfileLimits agentprofile.Limits
AgentPluginLimits agentplugin.Limits
// SubagentProfileLimits bounds role and persona discovery.
SubagentProfileLimits subagentprofile.Limits
MCPLimits codingmcp.Limits
MCPDefinitions codingmcp.Definitions
ToolLimits tools.Limits
GitLimits git.Limits
Subagent subagent.ExecutionOptions
// GoalVerifierInProcess keeps the Goal verification panel in-process
// instead of spawning foreground general-purpose skeptic children. It is the
// seam for a test or an embedder whose model cannot serve a child agent; a
// production Runtime leaves it false and spawns the panel whenever it has
// subagents.
GoalVerifierInProcess bool
// SchedulerOptions inject the scheduled-task loop's clock and timer. A zero
// value uses the real clock; a test advances time and observes a fire
// without waiting an interval.
SchedulerOptions scheduler.Options
}
ExecutionOptions contain process- and resource-bound Runtime dependencies. Zero limits select the package production defaults.
type ExportEvent ¶
type ExportEvent struct {
// contains filtered or unexported fields
}
ExportEvent is an event that has passed an explicit disclosure projection.
func Project ¶
func Project(event Event, disclosure Disclosure) (ExportEvent, error)
Project applies an explicit disclosure policy and returns a defensive event.
func (ExportEvent) Event ¶
func (e ExportEvent) Event() Event
Event returns a defensive copy of the projected event.
func (ExportEvent) MarshalJSON ¶
func (e ExportEvent) MarshalJSON() ([]byte, error)
MarshalJSON serializes the already-projected event.
func (*ExportEvent) UnmarshalJSON ¶
func (e *ExportEvent) UnmarshalJSON(data []byte) error
UnmarshalJSON strictly decodes an exported event.
type GenerateAgentDraftRequest ¶
type GenerateAgentDraftRequest struct {
AgentID string
Intent string
Scope AgentDraftScope
}
GenerateAgentDraftRequest is explicit user intent for one model proposal. Intent is sent to the configured model but is never stored in the main Session or retained in the resulting Draft.
type GoalChanged ¶ added in v0.1.5
type GoalChanged struct {
State GoalState `json:"state"`
Redacted bool `json:"redacted,omitempty"`
}
GoalChanged replaces the session-local Goal projection. Empty State records an explicit clear. Events do not carry raw evidence or become control records.
type GoalRequest ¶ added in v0.1.5
GoalRequest is a session-scoped completion condition and optional cumulative observed token allowance. The Goal carries no work-segment cap: zero MaxTokens leaves it bounded by the no-progress guard and its own declarations.
func (GoalRequest) Validate ¶ added in v0.1.5
func (request GoalRequest) Validate() error
Validate permits CLI preflight without opening or trusting a workspace.
type GoalState ¶ added in v0.1.5
type GoalState struct {
ID string `json:"id,omitempty"`
Condition string `json:"condition,omitempty"`
Status GoalStatus `json:"status,omitempty"`
Reason string `json:"reason,omitempty"`
Attempts int `json:"attempts"`
Evaluations int `json:"evaluations"`
Tokens int `json:"tokens"`
MaxTokens int `json:"max_tokens"`
FailedCheckTokens int `json:"failed_check_tokens"`
Gaps []string `json:"gaps,omitempty"`
References []string `json:"references,omitempty"`
Revision uint64 `json:"revision,omitempty"`
}
GoalState is a defensive projection, never the control authority. Tokens includes successful Work/check usage and separately observed failed checks; it is not a claim of complete provider billing.
func (GoalState) Active ¶ added in v0.1.5
Active reports a nonterminal Goal, including one requiring explicit resume.
func (GoalState) Completed ¶ added in v0.1.5
Completed reports independently verified completion, not interaction success.
func (GoalState) NonInteractiveError ¶ added in v0.1.5
NonInteractiveError rejects every unverified nonempty Goal outcome.
type GoalStatus ¶ added in v0.1.5
type GoalStatus string
GoalStatus is the session Goal lifecycle projection.
const ( GoalReady GoalStatus = "ready" GoalRunning GoalStatus = "running" GoalAssessing GoalStatus = "assessing" GoalVerifying GoalStatus = "verifying" GoalWaiting GoalStatus = "waiting" GoalPaused GoalStatus = "paused" GoalBlocked GoalStatus = "blocked" GoalInterrupted GoalStatus = "interrupted" GoalCompleted GoalStatus = "completed" GoalCancelled GoalStatus = "cancelled" GoalFailed GoalStatus = "failed" GoalLimited GoalStatus = "limited" )
Goal lifecycle states.
type HistoryPage ¶ added in v0.1.6
type HistoryPage struct {
// Messages are ordered oldest first.
Messages []ai.Message
// Start is the absolute index of Messages[0] and Total is every durable
// conversation message in the session.
Start int
Total int
// More reports that a durable message exists older than Messages[0].
More bool
}
HistoryPage is one bounded, ordered slice of durable conversation history.
type HistoryRequest ¶ added in v0.1.6
type HistoryRequest struct {
// Before is the absolute index, counted from the oldest durable message, of the
// first message the caller does not have. A negative value means "immediately
// before the newest len(State.Transcript) messages", which is the window
// BootstrapState delivered to a fresh frontend.
Before int
// Limit is the page size. Zero selects HistoryPageDefaultLimit; values above
// HistoryPageMaxLimit are clamped.
Limit int
}
HistoryRequest asks for conversation messages older than the caller's window.
type HookDeniedError ¶
type HookDeniedError struct {
Reason string
}
HookDeniedError includes the reviewed hook's bounded reason while preserving a stable sentinel for non-interactive callers.
func (*HookDeniedError) Error ¶
func (e *HookDeniedError) Error() string
func (*HookDeniedError) Unwrap ¶
func (e *HookDeniedError) Unwrap() error
Unwrap exposes the stable hook-denial sentinel.
type HookStoppedError ¶
HookStoppedError identifies the hook event and bounded reason that stopped a continuation such as compaction or a clean agent turn.
func (*HookStoppedError) Error ¶
func (e *HookStoppedError) Error() string
func (*HookStoppedError) Unwrap ¶
func (e *HookStoppedError) Unwrap() error
Unwrap exposes the stable stop sentinel.
type IncompleteReply ¶ added in v0.1.7
type IncompleteReply struct {
Turn int `json:"turn"`
Text string `json:"text"`
Reason string `json:"reason,omitempty"`
Bytes int `json:"bytes"`
}
IncompleteReply carries the text of a provisional answer abandoned before session commit because its stream broke and recovery ran out. The text is model output, so it is shown as an explicitly incomplete reply, but it is never part of the conversation: it is not appended to the transcript and must not reach the Harness session or the next model request. Bytes is the retained text's size before the emitter's bound was applied, so a consumer can tell a truncated record from a complete one.
type IntegrationDiagnostic ¶
type IntegrationDiagnostic struct {
Component string `json:"component"`
Code string `json:"code"`
Message string `json:"message,omitempty"`
Disabled bool `json:"disabled"`
}
IntegrationDiagnostic reports an optional integration failure or suppression.
type IntegrationGeneration ¶
type IntegrationGeneration struct {
// contains filtered or unexported fields
}
IntegrationGeneration is one immutable, application-owned snapshot of the interaction-visible integrations. Its owner is the Runtime; interactions acquire leases and keep the complete snapshot until they settle.
The Extension Activation and MCP Connections are leases over executable state. They are released together with the generation, after all interaction leases have drained.
func (*IntegrationGeneration) ID ¶
func (g *IntegrationGeneration) ID() uint64
ID identifies the immutable generation for diagnostics and tests.
type InteractionCompleted ¶
type InteractionCompleted struct {
Outcome InteractionOutcome `json:"outcome"`
Stop agent.StopReason `json:"stop,omitempty"`
Usage TokenUsage `json:"usage"`
ModelUsage map[string]TokenUsage `json:"model_usage,omitempty"`
DurationMillis int64 `json:"duration_ms"`
}
InteractionCompleted closes one user interaction.
type InteractionOutcome ¶
type InteractionOutcome string
InteractionOutcome classifies a terminal user interaction.
const ( InteractionSucceeded InteractionOutcome = "succeeded" InteractionFailed InteractionOutcome = "failed" InteractionCanceled InteractionOutcome = "canceled" InteractionIncomplete InteractionOutcome = "incomplete" )
Interaction outcomes.
type InteractionRecovery ¶
type InteractionRecovery struct {
PendingID string
InterruptedIDs []string
LastID string
LastOutcome InteractionOutcome
LastStop agent.StopReason
LastUsage TokenUsage
LastDurationMS int64
}
InteractionRecovery is the durable interaction journal projection.
func (InteractionRecovery) Clone ¶
func (recovery InteractionRecovery) Clone() InteractionRecovery
Clone returns a defensive recovery snapshot.
type InteractionSource ¶
type InteractionSource string
InteractionSource identifies why an interaction was opened.
const ( // InteractionSourceUser is the ordinary user-driven flow. InteractionSourceUser InteractionSource = "" // InteractionSourceAgentNotification is a Runtime-generated continuation // for one or more completed background children. InteractionSourceAgentNotification InteractionSource = "agent_notification" )
type InteractionStarted ¶
type InteractionStarted struct {
Resumed bool `json:"resumed"`
Mode OperatingMode `json:"mode"`
Source InteractionSource `json:"source,omitempty"`
RootInteractionID string `json:"root_interaction_id,omitempty"`
NotificationIDs []string `json:"notification_ids,omitempty"`
}
InteractionStarted opens one interaction, including approval continuations and Runtime-generated Agent completion continuations.
type InteractionState ¶
type InteractionState struct {
ID string `json:"id,omitempty"`
Active bool `json:"active"`
Resumed bool `json:"resumed"`
Mode OperatingMode `json:"mode,omitempty"`
Source InteractionSource `json:"source,omitempty"`
RootInteractionID string `json:"root_interaction_id,omitempty"`
Outcome InteractionOutcome `json:"outcome,omitempty"`
Stop agent.StopReason `json:"stop,omitempty"`
Usage TokenUsage `json:"usage"`
ModelUsage map[string]TokenUsage `json:"model_usage,omitempty"`
// DurationMillis is the runtime's measured active turn time. The interaction
// journal rebuilds it on reopen, so unlike ModelUsage it stays durable.
DurationMillis int64 `json:"duration_ms"`
}
InteractionState is the current or most recently completed user interaction.
type MCPSnapshot ¶ added in v0.1.5
type MCPSnapshot struct {
GenerationID uint64 `json:"generation_id"`
Settled bool `json:"settled"`
Servers []codingmcp.ServerStatus `json:"servers"`
}
MCPSnapshot is the content-free MCP connection projection for frontends. It reflects the currently published integration generation only.
func (MCPSnapshot) Clone ¶ added in v0.1.5
func (s MCPSnapshot) Clone() MCPSnapshot
Clone returns a defensive copy.
type MediaCapabilityGate ¶ added in v0.1.9
type MediaCapabilityGate struct {
// Vision reports whether the model accepts image input.
Vision bool
// Documents reports whether the model accepts document input.
Documents bool
}
MediaCapabilityGate refuses tool-result media the active model cannot accept. It mirrors the model's declared capabilities: image parts need Vision and file parts need Documents. Text, structured content, and resource links pass through unchanged. Embedded resources are judged by their blob, because ai.ProviderParts projects an embedded blob into an image or file part before it reaches a provider.
func MediaGateForCapabilities ¶ added in v0.1.9
func MediaGateForCapabilities(capabilities ai.Capabilities) MediaCapabilityGate
MediaGateForCapabilities builds the gate for a model's declared capabilities.
type MessageCommitted ¶
type MessageCommitted struct {
Message ai.Message `json:"message"`
Synthetic bool `json:"synthetic,omitempty"`
}
MessageCommitted carries one message durably appended to the Harness session.
func (*MessageCommitted) UnmarshalJSON ¶
func (payload *MessageCommitted) UnmarshalJSON(data []byte) error
UnmarshalJSON decodes the interface-bearing message through the canonical ai message discriminator.
type MessageDelta ¶
type MessageDelta struct {
Kind ai.StreamEventType `json:"kind"`
Provider ai.Provider `json:"provider,omitempty"`
ResponseID string `json:"response_id,omitempty"`
Model string `json:"model,omitempty"`
Text string `json:"text,omitempty"`
Signature string `json:"signature,omitempty"`
ToolCallIndex int `json:"tool_call_index,omitempty"`
ToolCallID string `json:"tool_call_id,omitempty"`
ToolCallName string `json:"tool_call_name,omitempty"`
Arguments string `json:"arguments,omitempty"`
FinishReason ai.FinishReason `json:"finish_reason,omitempty"`
Usage *TokenUsage `json:"usage,omitempty"`
}
MessageDelta is one provider-neutral model streaming increment.
type MessageDiscarded ¶
type MessageDiscarded struct {
Turn int `json:"turn"`
}
MessageDiscarded clears one provisional streaming candidate that was rejected before it could become a committed assistant message.
type ModeChanged ¶
type ModeChanged struct {
Mode OperatingMode `json:"mode"`
}
ModeChanged records one process-local capability-policy transition.
type ModelRetry ¶ added in v0.1.7
type ModelRetry struct {
Turn int `json:"turn,omitempty"`
Attempt int `json:"attempt"`
MaxRetries int `json:"max_retries"`
DelayMillis int64 `json:"delay_ms"`
Reason string `json:"reason,omitempty"`
}
ModelRetry reports that a model request is being re-attempted after a retryable failure. It is progress, not output: nothing is added to the transcript, and the attempt in flight replaces the one that failed. Attempt is the 1-based ordinal of the retry about to start, MaxRetries is the retry budget available, DelayMillis is the backoff before it, and Reason is a short, content-free cause.
type OneShotAgentRunRequest ¶
OneShotAgentRunRequest supplies one user-authored definition for this exact invocation. Definition is parsed with the same strict profile contract as files, but is never persisted or made discoverable to the parent model.
type OpenOptions ¶
type OpenOptions struct {
Workspace workspace.Workspace
Trusted bool
Config config.Config
Paths paths.Layout
Session SessionTarget
Credentials credential.Store
Model ai.LanguageModel
Resolved modelcatalog.ResolvedModel
Execution ExecutionOptions
Extensions []extension.Extension
// AgentObservers receive raw run, turn, and tool events. TelemetryObservers
// receive the content-free Coding product projection.
AgentObservers []func(context.Context, agent.Event)
TelemetryObservers []TelemetryObserver
}
OpenOptions explicitly bind one Runtime to one Workspace, configuration, and durable session. Model is an optional test/embedder override; production callers normally provide Credentials and let Open construct the model.
type OperatingMode ¶
type OperatingMode = config.OperatingMode
OperatingMode selects the process-local Coding Agent capability policy. It is intentionally distinct from Phase, which describes lifecycle state.
type PlanDocument ¶
type PlanDocument struct {
Exists bool `json:"exists"`
Content string `json:"content,omitempty"`
Size int64 `json:"size"`
}
PlanDocument is the bounded plan-file view exposed to frontends.
type PlanModeChanged ¶
PlanModeChanged records one plan-mode state-machine transition.
type PlanReviewRequired ¶
type PlanReviewRequired struct {
Request planreview.Request `json:"request"`
}
PlanReviewRequired pauses one Plan interaction for explicit review.
type PlanReviewResolved ¶
type PlanReviewResolved struct {
RequestID string `json:"request_id"`
Kind planreview.Kind `json:"kind"`
Decision planreview.Decision `json:"decision"`
}
PlanReviewResolved records the exact content-free plan-mode decision.
type PlanReviewState ¶
type PlanReviewState struct {
RequestedAt time.Time `json:"requested_at,omitzero"`
Required *planreview.Request `json:"required,omitempty"`
}
PlanReviewState is the current explicit plan-mode decision request.
func (PlanReviewState) NonInteractiveError ¶
func (state PlanReviewState) NonInteractiveError() error
NonInteractiveError fails closed when explicit Plan review is pending.
type PromoteAgentDraftRequest ¶
PromoteAgentDraftRequest identifies the exact reviewed Draft. Definition is optional edited Markdown; nil promotes the original bytes, while a non-nil value is parsed and compiled as a complete replacement before any write.
type QuestionRejected ¶
type QuestionRejected struct {
RequestID string `json:"request_id"`
SchemaDigest string `json:"schema_digest"`
}
QuestionRejected records an explicit cancellation without fabricating an answer.
type QuestionRequired ¶
type QuestionRequired struct {
Request question.Request `json:"request"`
Count int `json:"count"`
Redacted bool `json:"redacted,omitempty"`
}
QuestionRequired pauses one interaction for structured user input.
type QuestionResolved ¶
type QuestionResolved struct {
Resolution question.Resolution `json:"resolution"`
AnswerCount int `json:"answer_count"`
Chat bool `json:"chat"`
Redacted bool `json:"redacted,omitempty"`
}
QuestionResolved carries the one accepted structured or chat response.
type QuestionState ¶
type QuestionState struct {
RequestedAt time.Time `json:"requested_at,omitzero"`
Required *question.Request `json:"required,omitempty"`
}
QuestionState is the current Runtime-owned structured input request.
func (QuestionState) NonInteractiveError ¶
func (state QuestionState) NonInteractiveError() error
NonInteractiveError fails closed when structured input is pending.
type ReloadPublicationError ¶
ReloadPublicationError reports cleanup diagnostics after a new integration generation was already published. Its wrapped error is not a candidate construction failure: callers must keep using the published generation while deciding how to surface or retry retirement cleanup.
func (*ReloadPublicationError) Error ¶
func (e *ReloadPublicationError) Error() string
func (*ReloadPublicationError) Unwrap ¶
func (e *ReloadPublicationError) Unwrap() error
type RetryState ¶ added in v0.1.7
type RetryState struct {
Active bool `json:"active,omitempty"`
Attempt int `json:"attempt,omitempty"`
MaxRetries int `json:"max_retries,omitempty"`
Reason string `json:"reason,omitempty"`
Deadline time.Time `json:"deadline,omitzero"`
}
RetryState is the live retry notice for the run in flight: a model request that failed and is starting a new attempt. A frontend renders the wait from it instead of appearing stalled. Attempt is the 1-based retry ordinal and MaxRetries the budget it counts against; Deadline is when the next attempt starts, and it is zero when the producer reported no delay.
type RunCompleted ¶
type RunCompleted struct {
Stop agent.StopReason `json:"stop"`
Turns int `json:"turns"`
Usage TokenUsage `json:"usage"`
}
RunCompleted closes one successful Agent invocation.
type RunInterrupted ¶ added in v0.1.5
type RunInterrupted struct {
Reason string `json:"reason"`
}
RunInterrupted closes a request that produced no usable response before a bounded context-recovery attempt. It does not complete the interaction.
type RunStarted ¶
type RunStarted struct {
ParentRunID string `json:"parent_run_id,omitempty"`
Agent string `json:"agent,omitempty"`
}
RunStarted opens one Agent invocation within an interaction.
type RunState ¶
type RunState struct {
ID string `json:"id"`
ParentRunID string `json:"parent_run_id,omitempty"`
Agent string `json:"agent,omitempty"`
Turn int `json:"turn"`
TurnOpen bool `json:"turn_open"`
Active bool `json:"active"`
Stop agent.StopReason `json:"stop,omitempty"`
Usage TokenUsage `json:"usage"`
}
RunState is one Agent invocation projected for frontend rendering.
type Runtime ¶
type Runtime struct {
// contains filtered or unexported fields
}
Runtime is the Coding Agent composition root for one Workspace and one writable Harness session.
func Open ¶
func Open(ctx context.Context, options OpenOptions) (*Runtime, error)
Open validates and acquires every Runtime dependency. A failed open releases already-acquired resources in exact reverse order.
func (*Runtime) ApplyTeamIntegration ¶
func (r *Runtime) ApplyTeamIntegration( ctx context.Context, approval TeamIntegrationApproval, ) (TeamIntegrationResult, error)
ApplyTeamIntegration applies an approved manifest as unstaged/untracked parent changes.
func (*Runtime) CancelSubagent ¶
CancelSubagent requests cancellation of one owned child.
func (*Runtime) CleanupTeam ¶
func (r *Runtime) CleanupTeam( ctx context.Context, request TeamCleanupRequest, ) (TeamCleanupResult, error)
CleanupTeam performs non-force cleanup of exact terminal Team artifacts. Captured Attempt result refs are retained intentionally.
func (*Runtime) ClearGoal ¶ added in v0.1.5
ClearGoal cancels the current Goal without deleting its durable audit trail.
func (*Runtime) Close ¶
Close starts the Runtime's unique cleanup owner and waits for it. If the caller deadline expires, cleanup continues in the background and a later Close waits for the same result. It is safe for concurrent and repeated calls.
func (*Runtime) Compact ¶
func (r *Runtime) Compact( ctx context.Context, request CompactionRequest, ) iter.Seq2[Event, error]
Compact confirms a manual preview and durably compacts older context.
func (*Runtime) ConfirmTeam ¶
func (r *Runtime) ConfirmTeam( ctx context.Context, confirmation TeamConfirmation, ) (TeamReference, error)
ConfirmTeam revalidates and consumes one proposal before crossing the first durable resource boundary.
func (*Runtime) ConfirmTeamNonInteractive ¶
func (r *Runtime) ConfirmTeamNonInteractive( context.Context, TeamConfirmation, ) (TeamReference, error)
ConfirmTeamNonInteractive always requires an explicit interactive decision.
func (*Runtime) Continue ¶
Continue reconciles a durable pending interaction after reopening a session.
func (*Runtime) DeclineTeam ¶
DeclineTeam consumes a proposal without creating resources.
func (*Runtime) DiscardAgentDraft ¶
func (r *Runtime) DiscardAgentDraft( ctx context.Context, draftID string, expectedDigest string, ) error
DiscardAgentDraft removes one exact process-local draft. The expected digest prevents a stale review surface from discarding a replacement.
func (*Runtime) DiscoverTeamRecovery ¶
func (r *Runtime) DiscoverTeamRecovery(ctx context.Context) ([]TeamRecoveryCandidate, error)
DiscoverTeamRecovery performs a fresh bounded, read-only reconciliation for this Lead Session. It never acquires a Team lease, repairs a continuation, opens a child Session, starts a scheduler, or invokes a model or Tool.
func (*Runtime) EnterPlanMode ¶
EnterPlanMode executes a direct enter_plan_mode call. Intercepted calls are paused for approval; this path answers calls that need no approval.
func (*Runtime) ExitPlanMode ¶
ExitPlanMode executes a direct exit_plan_mode call. Gated calls are paused for the plan approval view, so this path only rejects mistaken calls.
func (*Runtime) Fork ¶
Fork creates a new durable Session from one selected node. It does not close or mutate the source; runtimecontrol owns subsequent replacement.
func (*Runtime) GenerateAgentDraft ¶
func (r *Runtime) GenerateAgentDraft( ctx context.Context, request GenerateAgentDraftRequest, ) (AgentDraft, error)
GenerateAgentDraft runs one isolated proposal Agent and stores only a process-local, non-executable Draft after strict parsing and current- generation compilation succeed.
func (*Runtime) GenerateTeamProposal ¶
func (r *Runtime) GenerateTeamProposal( ctx context.Context, prompt TeamProposalPrompt, ) (TeamProposal, error)
GenerateTeamProposal runs an isolated, read-only proposal Agent and only installs its validated preview after the run and repository preflight end.
func (*Runtime) GoalSnapshot ¶ added in v0.1.5
GoalSnapshot returns the latest immutable Goal projection.
func (*Runtime) History ¶ added in v0.1.6
func (r *Runtime) History(ctx context.Context, request HistoryRequest) (HistoryPage, error)
History returns a bounded page of durable conversation history older than the caller's loaded window. It never mutates the session, the live State, or the model context: compaction may have removed messages from the context while they remain readable here.
func (*Runtime) InspectAgentDraft ¶
InspectAgentDraft returns one detached full definition for explicit local review. It is never used by model-facing Tool composition.
func (*Runtime) InspectBackgroundTask ¶ added in v0.1.9
func (r *Runtime) InspectBackgroundTask( ctx context.Context, taskID string, ) (BackgroundTaskInspection, error)
InspectBackgroundTask returns one task's bounded inspection view. It is the read half of the same control surface the stop Tool uses.
func (*Runtime) InspectSubagent ¶
func (r *Runtime) InspectSubagent( ctx context.Context, childSessionID string, ) (subagent.Detail, error)
InspectSubagent loads one durable child owned by the current parent Session.
func (*Runtime) InspectSubagentState ¶
func (r *Runtime) InspectSubagentState( ctx context.Context, childSessionID string, ) (State, error)
InspectSubagentState returns the ordinary Coding State used to render a child Session. Live children retain their complete event projection; terminal children reopened from disk fall back to their durable transcript.
func (*Runtime) InspectTeamWorkerState ¶
func (r *Runtime) InspectTeamWorkerState( ctx context.Context, target TeamWorkerTarget, ) (State, error)
InspectTeamWorkerState reconstructs one terminal Worker's ordinary Coding State from its exact durable Session and releases the read handle before returning. It never opens a model, Tool runtime, or Continuation execution.
func (*Runtime) Interject ¶ added in v0.1.9
Interject queues messages ahead of the current Agent invocation's pending steering, so they are injected before any message already queued to steer.
func (*Runtime) KillBackgroundTask ¶ added in v0.1.9
func (r *Runtime) KillBackgroundTask( ctx context.Context, taskID string, source background.KillSource, ) (background.Outcome, background.Subject, error)
KillBackgroundTask stops one background task or one of this session's own children. It is the one control method the model's stop Tool, the tasks pane, and the runtime control plane share, so a watch, a backgrounded command, and a delegated child are all stopped through exactly one path. The id resolves against the background registry first and then against this session's children, because the two id spaces cannot collide: a registry id carries a kind prefix and a child id is a session id.
The returned Subject names which producer answered, because the outcomes are worded differently: a task is stopped outright, while a child's cancellation is only initiated. The source decides whether the terminal completion still wakes the model: a model kill already returned its own Tool result and must not wake twice.
func (*Runtime) KnownBackgroundTaskIDs ¶ added in v0.1.9
KnownBackgroundTaskIDs lists the ids the Runtime's background registry still knows, oldest first. It is what a not-found stop names so the model can recover an id it lost. It reads the same registry the kill itself addresses.
The enumeration stays the registry's own even though the read and stop Tools now resolve a child's session id too: the reference's own enumeration is labelled "known bash task IDs" and lists no subagent either, and one list keeps the not-found sentence shared by both Tools from naming an id the registry half of the resolver never returned.
func (*Runtime) ListAgentDrafts ¶
func (r *Runtime) ListAgentDrafts(ctx context.Context) ([]AgentDraftSummary, error)
ListAgentDrafts returns deterministic content-safe process-local summaries.
func (*Runtime) ListAgentProfiles ¶
func (r *Runtime) ListAgentProfiles(ctx context.Context) (AgentLibrary, error)
ListAgentProfiles returns the current registry as safe Library metadata. It takes a short immutable-generation lease so a simultaneous reload cannot clear or replace the registry while this view is being derived.
func (*Runtime) ListSubagents ¶
ListSubagents returns durable children owned by the current parent Session.
func (*Runtime) ListWorkspaceFiles ¶
ListWorkspaceFiles returns a bounded content-free snapshot from the active Workspace. File contents are never read during discovery.
func (*Runtime) MCP ¶ added in v0.1.5
func (r *Runtime) MCP(ctx context.Context) (_ MCPSnapshot, returnErr error)
MCP returns per-server connection state for the published generation without exposing definitions, credentials, or transports. Unlike Skills it stays readable during an interaction: the interaction's lease pins the same generation, so no mixed view is possible.
func (*Runtime) Navigate ¶
func (r *Runtime) Navigate( ctx context.Context, entryID string, summarize bool, ) iter.Seq2[Event, error]
Navigate moves the current leaf in the same Session. Iteration owns the structural lease and publishes durable tree state after a successful append.
func (*Runtime) ObserveEvents ¶
func (r *Runtime) ObserveEvents() (EventObservation, error)
ObserveEvents atomically returns the current State and a subscription that begins after that State. It is the preferred bootstrap and resubscribe API for interactive frontends.
func (*Runtime) ObserveTeamWorker ¶
func (r *Runtime) ObserveTeamWorker( ctx context.Context, target TeamWorkerTarget, ) (EventObservation, error)
ObserveTeamWorker atomically snapshots and subscribes to one live Worker Runtime after validating its exact durable Attempt owner generation.
func (*Runtime) PauseGoal ¶ added in v0.1.5
PauseGoal revokes automatic activation and cancels an admitted stage.
func (*Runtime) PlanDocumentPath ¶
PlanDocumentPath returns the session plan-file path for frontend presentation. It does not create or read the file.
func (*Runtime) PlanState ¶
PlanState reports the current plan-mode state. It implements the plan tooling Service contract.
func (*Runtime) PrepareTeamIntegration ¶
func (r *Runtime) PrepareTeamIntegration( ctx context.Context, request TeamIntegrationRequest, ) (TeamIntegrationPreview, error)
PrepareTeamIntegration deterministically composes selected captured results.
func (*Runtime) PreviewCompaction ¶
func (r *Runtime) PreviewCompaction(ctx context.Context) (CompactionPreview, error)
PreviewCompaction returns a point-in-time manual plan without model I/O or Session mutation.
func (*Runtime) PromoteAgentDraft ¶
func (r *Runtime) PromoteAgentDraft( ctx context.Context, request PromoteAgentDraftRequest, ) (AgentDraftPromotion, error)
PromoteAgentDraft reparses and recompiles one exact process-local Draft, then creates its private Pips definition with exclusive no-overwrite semantics. It never mutates the currently published integration generation.
func (*Runtime) Prompt ¶
Prompt starts one new interaction. Iteration owns cancellation and cleanup.
func (*Runtime) ProposeTeam ¶
func (r *Runtime) ProposeTeam( ctx context.Context, request TeamProposalRequest, ) (TeamProposal, error)
ProposeTeam validates and previews a Team without creating any durable Team, Continuation, Session, Worktree, branch/ref, lease, or goroutine.
func (*Runtime) ReadPlanDocument ¶
func (r *Runtime) ReadPlanDocument(ctx context.Context) (PlanDocument, error)
ReadPlanDocument returns the current session plan-file content without disclosing more than the file itself.
func (*Runtime) ReadTeam ¶
ReadTeam returns one current safe Team snapshot plus bounded changes after the supplied exclusive cursors. It never reads full Team history.
func (*Runtime) RecoverTeamIntegration ¶
func (r *Runtime) RecoverTeamIntegration( ctx context.Context, request TeamIntegrationRecoveryRequest, ) (TeamIntegrationResult, error)
RecoverTeamIntegration explicitly completes or rolls back one journal.
func (*Runtime) RejectQuestion ¶
func (r *Runtime) RejectQuestion( ctx context.Context, requestID string, schemaDigest string, ) iter.Seq2[Event, error]
RejectQuestion records an explicit cancellation and lets the Agent decide whether it can continue without the requested input.
func (*Runtime) RejectSubagentQuestion ¶
func (r *Runtime) RejectSubagentQuestion( ctx context.Context, childSessionID string, requestID string, schemaDigest string, ) (ChildControlState, error)
RejectSubagentQuestion records an explicit cancellation on exactly one child-owned question controller.
func (*Runtime) RejectTeamIntegration ¶
func (r *Runtime) RejectTeamIntegration(ctx context.Context, approval TeamIntegrationApproval) error
RejectTeamIntegration consumes a preview token and retains its artifacts.
func (*Runtime) RejectTeamWorkerQuestion ¶
func (r *Runtime) RejectTeamWorkerQuestion( ctx context.Context, target TeamWorkerTarget, requestID string, schemaDigest string, ) (TeamControlReference, error)
RejectTeamWorkerQuestion records an exact user rejection for one paused Worker.
func (*Runtime) Reload ¶
Reload installs fresh resource, MCP, and Extension generations only at an idle safe boundary. Existing interactions retain their leased snapshot.
func (*Runtime) ReplacementPreflight ¶
ReplacementPreflight verifies that the Runtime can be replaced without interrupting an active interaction, approval, question, Plan review, or Team owner. It does not mutate Runtime state.
func (*Runtime) Resolve ¶
func (r *Runtime) Resolve( ctx context.Context, resolution approval.Resolution, ) iter.Seq2[Event, error]
Resolve applies one explicit approval decision and continues only when the durable pending suffix becomes ready.
func (*Runtime) ResolvePlanReview ¶
func (r *Runtime) ResolvePlanReview( ctx context.Context, resolution planreview.Resolution, ) iter.Seq2[Event, error]
ResolvePlanReview durably records one explicit Plan review decision and resumes the paused Plan interaction.
func (*Runtime) ResolveQuestion ¶
func (r *Runtime) ResolveQuestion( ctx context.Context, resolution question.Resolution, ) iter.Seq2[Event, error]
ResolveQuestion durably records one exact structured response and resumes the paused interaction.
func (*Runtime) ResolveSubagentApproval ¶
func (r *Runtime) ResolveSubagentApproval( ctx context.Context, childSessionID string, resolution approval.Resolution, ) (ChildControlState, error)
ResolveSubagentApproval routes a decision to exactly one child-owned approval journal/resolver. It never resolves the parent interaction.
func (*Runtime) ResolveSubagentQuestion ¶
func (r *Runtime) ResolveSubagentQuestion( ctx context.Context, childSessionID string, resolution question.Resolution, ) (ChildControlState, error)
ResolveSubagentQuestion routes a structured answer to exactly one child-owned question controller and resumes only that child when ready.
func (*Runtime) ResolveTeamWorkerApproval ¶
func (r *Runtime) ResolveTeamWorkerApproval( ctx context.Context, target TeamWorkerTarget, resolution approval.Resolution, ) (TeamControlReference, error)
ResolveTeamWorkerApproval records an exact user approval resolution. Lead tools cannot call this Runtime surface and therefore cannot approve a Worker.
func (*Runtime) ResolveTeamWorkerQuestion ¶
func (r *Runtime) ResolveTeamWorkerQuestion( ctx context.Context, target TeamWorkerTarget, resolution question.Resolution, ) (TeamControlReference, error)
ResolveTeamWorkerQuestion records exact structured answers for one paused Worker.
func (*Runtime) ResolveWorkspaceFile ¶
func (r *Runtime) ResolveWorkspaceFile( ctx context.Context, reference attachment.Reference, ) (attachment.Resolved, error)
ResolveWorkspaceFile reads one stable text or normalized image reference through the active Workspace tree.
func (*Runtime) ResumeGoal ¶ added in v0.1.5
ResumeGoal is the explicit activation boundary after pause or recovery. Interrupted Decisions reuse persisted Work; they never replay its tools.
func (*Runtime) ResumeTeam ¶
func (r *Runtime) ResumeTeam( ctx context.Context, teamID team.ID, decision TeamResumeDecision, ) (TeamReference, error)
ResumeTeam explicitly reacquires one retained Team and starts only its exact recoverable owners. Startup discovery itself never calls this method.
func (*Runtime) ReviseTeamProposal ¶
func (r *Runtime) ReviseTeamProposal( ctx context.Context, proposalID string, feedback string, ) (TeamProposal, error)
ReviseTeamProposal replaces one exact current proposal only after an isolated proposal run and a fresh preflight both succeed.
func (*Runtime) RunAgent ¶
RunAgent starts one user-selected foreground Agent and waits for its durable terminal result. It creates an ordinary, content-free parent interaction so the child has stable ownership and its lifecycle reaches Runs, but it never asks the parent language model to choose or launch the Agent.
A custom Agent must be enabled by the Alpha gate and have visibility.user. Builtin IDs remain available through the legacy-compatible manager path. This blocking API is non-interactive: a child approval or question is durably recorded, then returns its fail-closed error rather than being auto-resolved or waiting without a resolver. Interactive callers use RunAgentEvents and the targetable SubagentControlState APIs instead.
func (*Runtime) RunAgentEvents ¶
func (r *Runtime) RunAgentEvents( ctx context.Context, request AgentRunRequest, ) iter.Seq2[Event, error]
RunAgentEvents is the event-streaming counterpart of RunAgent. Interactive callers use it so a directly launched child appears in Runs immediately and can be independently approved or answered while the foreground call waits.
func (*Runtime) RunOneShotAgent ¶
func (r *Runtime) RunOneShotAgent( ctx context.Context, request OneShotAgentRunRequest, ) (subagent.Result, error)
RunOneShotAgent starts one explicitly supplied, non-persistent definition. It follows the same compiler, authority intersection, child controls, and durable plan audit as a discovered profile.
func (*Runtime) SetMode ¶
func (r *Runtime) SetMode(ctx context.Context, mode OperatingMode) error
SetMode applies one user-initiated plan-mode toggle. Entering plan mode waits for the next prompt (Pending); leaving it while a turn is in flight defers the exit until the turn completes (ExitPending).
func (*Runtime) SetSkillEnabled ¶
SetSkillEnabled persists one project-scoped Skill policy decision and publishes it atomically at an idle Runtime boundary.
func (*Runtime) Skills ¶
func (r *Runtime) Skills(ctx context.Context) (_ SkillSnapshot, returnErr error)
Skills returns the current resolved Skill generation without exposing full instructions or filesystem paths. A concurrent reload wins the Runtime operation lease, so callers never observe mixed resource generations.
func (*Runtime) StartGoal ¶ added in v0.1.5
StartGoal admits one session-bound Goal and drives bounded Coding Work. The iterator is the owner of cancellation, including assessment and verification.
func (*Runtime) SubagentControlState ¶
func (r *Runtime) SubagentControlState(childSessionID string) (ChildControlState, error)
SubagentControlState returns the independently owned approval/question state for a currently live custom child. Terminal and legacy children have no in-memory control target and therefore cannot be resumed through this path.
func (*Runtime) SubmitTeamControl ¶
func (r *Runtime) SubmitTeamControl( ctx context.Context, request TeamControlRequest, ) (TeamControlReference, error)
SubmitTeamControl durably records user intent and wakes the owning Team coordinator. Command IDs and timestamps are Runtime-owned and cannot be forged by model or extension input.
func (*Runtime) SubscribeEvents ¶
func (r *Runtime) SubscribeEvents(afterCursor uint64) (*EventSubscription, error)
SubscribeEvents replays Runtime events after cursor when they remain in the bounded hub. Callers receiving ErrEventGap must use Runtime.ObserveEvents.
func (*Runtime) TeamIntegrationRecoveries ¶
func (r *Runtime) TeamIntegrationRecoveries(ctx context.Context) ([]TeamIntegrationRecovery, error)
TeamIntegrationRecoveries discovers interrupted journals without mutation.
func (*Runtime) TeamRecoveryCandidates ¶
func (r *Runtime) TeamRecoveryCandidates() ([]TeamRecoveryCandidate, error)
TeamRecoveryCandidates returns the startup discovery snapshot. Call DiscoverTeamRecovery to refresh it after external state changes.
func (*Runtime) Tree ¶
func (r *Runtime) Tree(ctx context.Context) (SessionTree, error)
Tree returns a consistent, bounded Session tree snapshot. It is read-only and remains available while an interaction runs.
func (*Runtime) WaitSubagent ¶
func (r *Runtime) WaitSubagent( ctx context.Context, childSessionID string, ) (subagent.Result, error)
WaitSubagent waits for one owned child to become terminal without affecting any other child or the parent interaction.
func (*Runtime) WorkspaceStatus ¶
WorkspaceStatus returns bounded current Git worktree truth. It does not use or consume the interaction-attribution baseline.
type RuntimeError ¶
type RuntimeError struct {
Code string `json:"code"`
Message string `json:"message,omitempty"`
Fatal bool `json:"fatal"`
}
RuntimeError reports a stable user-visible runtime error classification.
type RuntimeStateError ¶
RuntimeStateError reports a stable rejected operation and the phase that rejected it. Cause supports errors.Is without exposing mutable internals.
func (*RuntimeStateError) Error ¶
func (e *RuntimeStateError) Error() string
func (*RuntimeStateError) Unwrap ¶
func (e *RuntimeStateError) Unwrap() error
Unwrap returns the stable state sentinel.
type SessionCloseReason ¶
type SessionCloseReason string
SessionCloseReason classifies why a Runtime stopped owning a session.
const ( SessionClosedNormally SessionCloseReason = "closed" SessionClosedFailed SessionCloseReason = "failed" SessionClosedCanceled SessionCloseReason = "canceled" )
Session close reasons.
type SessionClosed ¶
type SessionClosed struct {
Reason SessionCloseReason `json:"reason"`
}
SessionClosed carries the final session ownership outcome.
type SessionForked ¶
type SessionForked struct {
SourceSessionID string `json:"source_session_id"`
TargetSessionID string `json:"target_session_id"`
AtEntryID string `json:"at_entry_id,omitempty"`
}
SessionForked records lineage after a new durable Session is created.
type SessionNavigated ¶
type SessionNavigated struct {
}
SessionNavigated records one successful same-file leaf change.
type SessionNode ¶
type SessionNode struct {
ID string `json:"id"`
ParentID string `json:"parent_id,omitempty"`
Kind SessionNodeKind `json:"kind"`
CreatedAt time.Time `json:"created_at"`
Depth int `json:"depth"`
Label string `json:"label,omitempty"`
Current bool `json:"current"`
OnActivePath bool `json:"on_active_path"`
HasSummary bool `json:"has_summary"`
Compacted bool `json:"compacted"`
}
SessionNode is one flat, bounded Session tree node.
type SessionNodeKind ¶
type SessionNodeKind string
SessionNodeKind is the product-level kind of one durable Session tree node. It deliberately does not expose Harness types to frontends.
const ( SessionNodeMessage SessionNodeKind = "message" SessionNodeModelChange SessionNodeKind = "model_change" SessionNodeCompaction SessionNodeKind = "compaction" SessionNodeCheckpoint SessionNodeKind = "context_checkpoint" SessionNodeBranchSummary SessionNodeKind = "branch_summary" SessionNodeCustom SessionNodeKind = "custom" SessionNodeLabel SessionNodeKind = "label" SessionNodeName SessionNodeKind = "name" )
Session tree node kinds.
type SessionOpened ¶
type SessionOpened struct {
Resumed bool `json:"resumed"`
Provider ai.Provider `json:"provider,omitempty"`
ModelID string `json:"model_id,omitempty"`
ContextWindow int `json:"context_window"`
Mode OperatingMode `json:"mode"`
}
SessionOpened carries the initial durable session metadata.
type SessionTarget ¶
SessionTarget selects a new session when ID is empty or a durable session to reopen when ID is set.
type SessionTree ¶
type SessionTree struct {
SessionID string `json:"session_id"`
Name string `json:"name,omitempty"`
LeafID string `json:"leaf_id,omitempty"`
Nodes []SessionNode `json:"nodes"`
TotalNodes int `json:"total_nodes"`
MaxDepth int `json:"max_depth"`
Truncated bool `json:"truncated"`
}
SessionTree is the frontend-safe, flat projection of one durable Session.
func (SessionTree) Clone ¶
func (tree SessionTree) Clone() SessionTree
Clone returns a detached Session tree.
type SessionTreeChanged ¶
type SessionTreeChanged struct {
Tree SessionTree `json:"tree"`
Transcript ai.Messages `json:"transcript"`
ContextTokens int `json:"context_tokens"`
Tasks tasklist.Snapshot `json:"tasks"`
// Compaction carries the boundary the bounded transcript belongs to. A zero
// value means the active branch has no full checkpoint.
Compaction CompactionState `json:"compaction,omitzero"`
}
SessionTreeChanged replaces the reducer's bounded live tree/transcript projection. It is live-only: the transcript is authoritative, so the event is never written to the durable journal.
type SkillDiagnostic ¶
type SkillDiagnostic struct {
Code string `json:"code"`
Resource string `json:"resource,omitempty"`
Message string `json:"message,omitempty"`
}
SkillDiagnostic is a safe, non-fatal discovery or compatibility decision.
type SkillID ¶
type SkillID string
SkillID is an opaque, generation-stable identifier for a resolved Skill.
type SkillSnapshot ¶
type SkillSnapshot struct {
Skills []SkillSummary `json:"skills"`
Diagnostics []SkillDiagnostic `json:"diagnostics,omitempty"`
}
SkillSnapshot is an immutable point-in-time projection for frontends.
func (SkillSnapshot) Clone ¶
func (s SkillSnapshot) Clone() SkillSnapshot
Clone returns a defensive copy.
type SkillSource ¶
type SkillSource string
SkillSource is a safe, stable source label for a discovered Skill.
const ( SkillSourceProjectPips SkillSource = "project_pips" SkillSourceProjectAgents SkillSource = "project_agents" SkillSourceUserPips SkillSource = "user_pips" SkillSourceUserAgents SkillSource = "user_agents" SkillSourceExtension SkillSource = "extension" SkillSourceUnknown SkillSource = "unknown" )
Skill source labels exposed to product frontends.
type SkillSummary ¶
type SkillSummary struct {
ID SkillID `json:"id"`
Name string `json:"name"`
Description string `json:"description"`
Source SkillSource `json:"source"`
Enabled bool `json:"enabled"`
UserInvocable bool `json:"user_invocable"`
ModelInvocable bool `json:"model_invocable"`
ResourceCount int `json:"resource_count"`
}
SkillSummary is the content-free product projection of one Skill.
type State ¶
type State struct {
Goal GoalState `json:"goal"`
Sequence uint64 `json:"sequence"`
SessionID string `json:"session_id,omitempty"`
SessionOpen bool `json:"session_open"`
Provider ai.Provider `json:"provider,omitempty"`
ModelID string `json:"model_id,omitempty"`
ContextWindow int `json:"context_window"`
Mode OperatingMode `json:"mode"`
Phase Phase `json:"phase,omitempty"`
Interaction InteractionState `json:"interaction"`
Transcript ai.Messages `json:"transcript"`
// SyntheticMessages contains transcript indexes owned by Runtime-generated
// protocol input. Frontends render them as neutral activity, not user chat.
SyntheticMessages []int `json:"synthetic_messages,omitempty"`
// IncompleteReplies retains the text of provisional answers abandoned when
// a broken stream's recovery budget ran out. It is deliberately separate
// from Transcript: the text is shown as an explicitly incomplete reply and
// must never reach the Harness session or the next model request.
IncompleteReplies []IncompleteReply `json:"incomplete_replies,omitempty"`
Draft StreamDraft `json:"draft"`
DraftCandidate CandidateIdentity `json:"draft_candidate,omitzero"`
MessageCandidates []CandidateIdentity `json:"message_candidates,omitempty"`
Runs []RunState `json:"runs"`
Tools []ToolState `json:"tools"`
Subagents []SubagentState `json:"subagents"`
// BackgroundTasks is the live projection of the Runtime's registered
// background tasks. It is what the tasks pane lists under Watchers.
BackgroundTasks []BackgroundTaskLifecycle `json:"background_tasks,omitempty"`
Teams []TeamLifecycleState `json:"teams,omitempty"`
TeamControls []TeamControlLifecycleState `json:"team_controls,omitempty"`
TeamIntegrations []TeamIntegrationLifecycleState `json:"team_integrations,omitempty"`
Approval ApprovalState `json:"approval"`
Question QuestionState `json:"question"`
PlanReview PlanReviewState `json:"plan_review"`
PlanMode planmode.State `json:"plan_mode"`
Changes *WorkspaceChanged `json:"changes,omitempty"`
Diagnostics []IntegrationDiagnostic `json:"diagnostics"`
LastError *RuntimeError `json:"last_error,omitempty"`
Tree SessionTree `json:"tree"`
Compaction CompactionState `json:"compaction"`
// Retry is the live retry notice for the run in flight; the next event of
// any other kind clears it, because any of them ends the wait.
Retry RetryState `json:"retry,omitzero"`
ContextTokens int `json:"context_tokens"`
Tasks tasklist.Snapshot `json:"tasks"`
// contains filtered or unexported fields
}
State is the complete reducer projection used by interactive and non-interactive frontends. Use State.Clone when retaining a snapshot.
func Reduce ¶
Reduce applies one validated event to a copy-on-write view of state.
The returned State shares the immutable projections of the input (committed Transcript messages, completed Tool results and lifecycle projections) and privately owns everything [State.apply] writes, so neither State can observe the other's later transitions. Callers that retain a value across mutations of the Runtime use State.Clone instead.
func ReduceBatch ¶ added in v0.1.6
ReduceBatch applies one frame's worth of validated events as a single state transition. Runs of MessageDelta events are folded into one Draft append; every other event keeps its individual transition. The result is field-for-field identical to applying the events one at a time, and the first rejected event leaves no partial state behind.
func (State) Durable ¶
func (state State) Durable() DurableState
Durable returns the state subset reconstructed from Harness persistence.
func (State) IsSessionProvisional ¶
IsSessionProvisional reports whether the current Session has no accepted interaction or legacy durable conversation state yet.
type StatusChanged ¶
type StatusChanged struct {
Phase Phase `json:"phase"`
}
StatusChanged projects one Runtime phase transition.
type StreamDraft ¶ added in v0.1.8
type StreamDraft struct {
// contains filtered or unexported fields
}
StreamDraft is an immutable, chunked sequence of streaming MessageDelta records. It is the value stored in State.Draft.
Its zero value is a usable empty draft. An append returns a new value that shares every published chunk with its input, so a retained State or Snapshot is never rewritten. The block layout stays private: callers read the summary, aggregate text, or materialize a caller-owned copy. The summary (count, per-kind presence and UTF-8 byte totals) is part of the immutable value, so an activity query reads it without scanning the records.
It marshals as the field's legacy form: a JSON array of MessageDelta records, or null for an empty draft. See StreamDraft.MarshalJSON.
func NewStreamDraft ¶ added in v0.1.8
func NewStreamDraft(deltas ...MessageDelta) StreamDraft
NewStreamDraft builds a draft from records in order. It clones each record's mutable Usage pointer, so the caller keeps ownership of what it passes. With no records the result is the empty draft, which marshals as null.
func (StreamDraft) Append ¶ added in v0.1.8
func (draft StreamDraft) Append(delta MessageDelta) StreamDraft
Append returns a new draft with one record added. The input draft and every chunk it shares stay unchanged.
func (StreamDraft) AppendBatch ¶ added in v0.1.8
func (draft StreamDraft) AppendBatch(deltas []MessageDelta) StreamDraft
AppendBatch returns a new draft with the records added in order. It copies the published partial tail once and then fills canonical fixed-size blocks, so the resulting chunk boundaries never depend on the caller's batch boundaries. Every input record is preserved.
func (StreamDraft) Equal ¶ added in v0.1.8
func (draft StreamDraft) Equal(other StreamDraft) bool
Equal reports whether two drafts hold the same records and summary. It compares logical contents, not chunk pointer identity, so two drafts built by different batch splits compare equal.
func (StreamDraft) HasReasoningDelta ¶ added in v0.1.8
func (draft StreamDraft) HasReasoningDelta() bool
HasReasoningDelta reports whether any record is a reasoning delta.
func (StreamDraft) HasTextDelta ¶ added in v0.1.8
func (draft StreamDraft) HasTextDelta() bool
HasTextDelta reports whether any record is a text delta. Presence is not the same as nonempty text: an empty text delta still counts, matching the legacy per-record kind scan.
func (StreamDraft) Len ¶ added in v0.1.8
func (draft StreamDraft) Len() int
Len returns the number of records the draft holds.
func (StreamDraft) MarshalJSON ¶ added in v0.1.8
func (draft StreamDraft) MarshalJSON() ([]byte, error)
MarshalJSON writes the legacy JSON array of MessageDelta records. An empty draft writes null, matching the legacy nil []MessageDelta field, unless it was decoded from a non-nil empty array, which writes [] again.
func (StreamDraft) Materialize ¶ added in v0.1.8
func (draft StreamDraft) Materialize() []MessageDelta
Materialize returns a caller-owned copy of the records in order. Each record is copied (including its Usage pointer), so mutating the result cannot reach the draft or any State that shares it.
func (StreamDraft) ReasoningText ¶ added in v0.1.8
func (draft StreamDraft) ReasoningText() string
ReasoningText concatenates the Text of every reasoning delta in order. It grows its buffer from the draft's byte summary.
func (StreamDraft) Text ¶ added in v0.1.8
func (draft StreamDraft) Text() string
Text concatenates the Text of every text delta in order. It grows its buffer from the draft's byte summary and reads records in place.
func (*StreamDraft) UnmarshalJSON ¶ added in v0.1.8
func (draft *StreamDraft) UnmarshalJSON(data []byte) error
UnmarshalJSON decodes the legacy JSON array, or null. It builds into a temporary value and only assigns on success, so a rejected decode leaves the receiver unchanged.
type SubagentLifecycle ¶
type SubagentLifecycle struct {
Identity subagent.AgentIdentity `json:"identity,omitzero"`
Role subagent.Role `json:"role"`
State subagent.State `json:"state"`
ChildSessionID string `json:"child_session_id"`
ParentInteractionID string `json:"parent_interaction_id,omitempty"`
ParentRunID string `json:"parent_run_id"`
ParentToolCallID string `json:"parent_tool_call_id,omitempty"`
RootInteractionID string `json:"root_interaction_id,omitempty"`
Delivery subagent.Delivery `json:"delivery,omitempty"`
ChildRunID string `json:"child_run_id,omitempty"`
Model string `json:"model"`
TaskPreview string `json:"task_preview,omitempty"`
Activity subagent.ActivitySummary `json:"activity,omitzero"`
Code string `json:"code,omitempty"`
Stop agent.StopReason `json:"stop,omitempty"`
Turns int `json:"turns"`
ToolCalls int `json:"tool_calls"`
Usage TokenUsage `json:"usage"`
DurationMillis int64 `json:"duration_ms"`
}
SubagentLifecycle is one content-bounded specialist lifecycle projection. Child transcript, Tool arguments, paths, and structured results are loaded from the child Session only and never copied into this payload.
type SubagentState ¶
type SubagentState struct {
ChildSessionID string `json:"child_session_id"`
ParentInteractionID string `json:"parent_interaction_id,omitempty"`
ParentRunID string `json:"parent_run_id"`
ParentToolCallID string `json:"parent_tool_call_id,omitempty"`
RootInteractionID string `json:"root_interaction_id,omitempty"`
Delivery subagent.Delivery `json:"delivery,omitempty"`
ChildRunID string `json:"child_run_id,omitempty"`
Identity subagent.AgentIdentity `json:"identity,omitzero"`
Role subagent.Role `json:"role"`
State subagent.State `json:"state"`
TaskPreview string `json:"task_preview,omitempty"`
Activity subagent.ActivitySummary `json:"activity,omitzero"`
Model string `json:"model"`
Code string `json:"code,omitempty"`
Turns int `json:"turns"`
ToolCalls int `json:"tool_calls"`
Usage TokenUsage `json:"usage"`
DurationMillis int64 `json:"duration_ms"`
}
SubagentState is the bounded recent lifecycle projection used by live frontends. Durable list/detail data is loaded from child Sessions.
type TeamActivity ¶
type TeamActivity string
TeamActivity is a content-free summary of what an Attempt owner is doing.
const ( TeamActivityPreparing TeamActivity = "preparing" TeamActivityWorking TeamActivity = "working" TeamActivityAwaitingApproval TeamActivity = "awaiting_approval" TeamActivityAwaitingQuestion TeamActivity = "awaiting_question" TeamActivityCapturing TeamActivity = "capturing" )
Team activity values. They deliberately carry no Tool arguments, paths, or assistant text.
type TeamAdmissionMode ¶
type TeamAdmissionMode string
TeamAdmissionMode records which parent state the user explicitly admitted.
const ( TeamAdmissionClean TeamAdmissionMode = "clean" TeamAdmissionHEADOnly TeamAdmissionMode = "head_only" )
type TeamAttemptRecoveryCandidate ¶
type TeamAttemptRecoveryCandidate struct {
TaskID team.TaskID
AttemptID team.AttemptID
MemberID team.MemberID
ContinuationID continuation.ID
SessionID string
ResourceState teamstate.AttemptState
ContinuationState continuation.Status
ContinuationPhase continuation.Phase
RetryWork bool
Diagnostic string
}
TeamAttemptRecoveryCandidate is the bounded identity and durable state of a running Team Attempt discovered without opening its Worker Runtime.
type TeamAttemptView ¶
type TeamAttemptView struct {
Target TeamWorkerTarget `json:"target"`
Number int `json:"number"`
StartedAt time.Time `json:"started_at"`
DomainState team.AttemptStatus `json:"domain_state"`
ResourceState teamstate.AttemptState `json:"resource_state,omitempty"`
ChildSessionID string `json:"child_session_id,omitempty"`
Cleanup teamstate.CleanupClass `json:"cleanup,omitempty"`
LifecycleState TeamLifecycleStatus `json:"lifecycle_state,omitempty"`
Activity TeamActivity `json:"activity,omitempty"`
Turns int `json:"turns,omitempty"`
ToolCalls int `json:"tool_calls,omitempty"`
Usage TokenUsage `json:"usage,omitzero"`
DurationMillis int64 `json:"duration_ms,omitempty"`
Code string `json:"code,omitempty"`
}
TeamAttemptView binds one logical Attempt to its safe UI routing identity.
type TeamChangeView ¶
type TeamChangeView struct {
Revision team.Revision `json:"revision"`
At time.Time `json:"at"`
Cause team.Cause `json:"cause"`
MemberID team.MemberID `json:"member_id,omitempty"`
TaskID team.TaskID `json:"task_id,omitempty"`
AttemptID team.AttemptID `json:"attempt_id,omitempty"`
From team.Status `json:"from,omitempty"`
To team.Status `json:"to"`
}
TeamChangeView is a content-free Team transition after an exclusive revision.
type TeamCleanupRequest ¶
type TeamCleanupRequest struct {
TeamID team.ID
ExpectedResourceRevision team.Revision
CloseWithoutIntegration bool
}
TeamCleanupRequest binds one explicit cleanup decision to current durable resources.
type TeamCleanupResult ¶
TeamCleanupResult is a path-free cleanup projection suitable for frontends.
type TeamCleanupView ¶
type TeamCleanupView struct {
Class teamstate.CleanupClass `json:"class"`
Eligible int `json:"eligible"`
Pending int `json:"pending"`
Retained int `json:"retained"`
Complete int `json:"complete"`
}
TeamCleanupView summarizes retained resource classifications without paths or refs.
type TeamConfirmation ¶
type TeamConfirmation struct {
ProposalID string `json:"proposal_id"`
Admission TeamAdmissionMode `json:"admission"`
}
TeamConfirmation consumes one exact proposal.
type TeamControlAction ¶
type TeamControlAction string
TeamControlAction identifies one user-authorized Team operation.
const ( TeamControlMessage TeamControlAction = "message" TeamControlFollowUp TeamControlAction = "follow_up" TeamControlInterruptAttempt TeamControlAction = "interrupt_attempt" TeamControlCancelTask TeamControlAction = "cancel_task" TeamControlRetryTask TeamControlAction = "retry_task" TeamControlCancelTeam TeamControlAction = "cancel_team" TeamControlResolveApproval TeamControlAction = "resolve_approval" TeamControlResolveQuestion TeamControlAction = "resolve_question" TeamControlRejectQuestion TeamControlAction = "reject_question" )
Supported Team control actions.
type TeamControlLifecycle ¶
type TeamControlLifecycle struct {
TeamID team.ID `json:"team_id"`
Revision uint64 `json:"revision"`
CommandID team.CommandID `json:"command_id"`
Action TeamControlAction `json:"action"`
MemberID team.MemberID `json:"member_id,omitempty"`
TaskID team.TaskID `json:"task_id,omitempty"`
AttemptID team.AttemptID `json:"attempt_id,omitempty"`
OwnerGeneration uint64 `json:"owner_generation,omitempty"`
State TeamControlStatus `json:"state"`
Code string `json:"code,omitempty"`
}
TeamControlLifecycle is the content-free parent projection for one durable operator command. Command text, payloads, and resolved execution identities remain private to the Team control journal.
type TeamControlLifecycleState ¶
type TeamControlLifecycleState struct {
TeamControlLifecycle
}
TeamControlLifecycleState is the latest content-free projection for one durable operator command.
type TeamControlReference ¶
type TeamControlReference struct {
CommandID team.CommandID `json:"command_id"`
TeamID team.ID `json:"team_id"`
Action TeamControlAction `json:"action"`
CreatedAt time.Time `json:"created_at"`
}
TeamControlReference identifies one durable operator command.
type TeamControlRequest ¶
type TeamControlRequest struct {
TeamID team.ID `json:"team_id"`
Action TeamControlAction `json:"action"`
MemberID team.MemberID `json:"member_id,omitempty"`
TaskID team.TaskID `json:"task_id,omitempty"`
ExpectedAttemptID team.AttemptID `json:"expected_attempt_id,omitempty"`
OwnerGeneration uint64 `json:"owner_generation,omitempty"`
Text string `json:"text,omitempty"`
}
TeamControlRequest supplies stable logical identity. Runtime resolves it to an exact Attempt owner only after the intent has been durably submitted.
type TeamControlStatus ¶
type TeamControlStatus string
TeamControlStatus is the safe lifecycle of one operator command.
const ( TeamControlPending TeamControlStatus = "pending" TeamControlApplying TeamControlStatus = "applying" TeamControlApplied TeamControlStatus = "applied" TeamControlRejected TeamControlStatus = "rejected" TeamControlStale TeamControlStatus = "stale" TeamControlDeliveryUnknown TeamControlStatus = "delivery_unknown" )
Team operator control states.
type TeamControlView ¶
type TeamControlView struct {
Revision uint64 `json:"revision"`
CommandID team.CommandID `json:"command_id"`
Action TeamControlAction `json:"action"`
MemberID team.MemberID `json:"member_id,omitempty"`
TaskID team.TaskID `json:"task_id,omitempty"`
AttemptID team.AttemptID `json:"attempt_id,omitempty"`
OwnerGeneration uint64 `json:"owner_generation,omitempty"`
State TeamControlStatus `json:"state"`
Code string `json:"code,omitempty"`
CreatedAt time.Time `json:"created_at"`
UpdatedAt time.Time `json:"updated_at"`
}
TeamControlView omits operator text, resolution payloads and private resolved identities.
type TeamIntegrationApproval ¶
TeamIntegrationApproval binds Apply to the preview the user reviewed.
type TeamIntegrationLifecycle ¶
type TeamIntegrationLifecycle struct {
TeamID team.ID `json:"team_id"`
IntegrationID string `json:"integration_id"`
State TeamIntegrationStatus `json:"state"`
VerificationState string `json:"verification_state,omitempty"`
Attempts int `json:"attempts,omitempty"`
Files int `json:"files,omitempty"`
Added int `json:"added,omitempty"`
Changed int `json:"changed,omitempty"`
Deleted int `json:"deleted,omitempty"`
Binary int `json:"binary,omitempty"`
Code string `json:"code,omitempty"`
}
TeamIntegrationLifecycle is the content-free projection consumed by frontends and telemetry. Exact evidence remains available through the explicit preview and recovery APIs.
type TeamIntegrationLifecycleState ¶
type TeamIntegrationLifecycleState struct {
TeamIntegrationLifecycle
}
TeamIntegrationLifecycleState is the latest compact projection for one isolated Team result integration.
type TeamIntegrationPreview ¶
type TeamIntegrationPreview struct {
ID string
AttemptIDs []team.AttemptID
ResourceRevision team.Revision
CommitOID string
TreeOID string
Manifest teamintegration.Manifest
DiffDigest string
Verification teamintegration.Verification
ApprovalToken string
ApprovalTokenHash string
ExpiresAt time.Time
ProducesUnstagedChanges bool
}
TeamIntegrationPreview is UI-neutral approval evidence.
type TeamIntegrationRecovery ¶
type TeamIntegrationRecovery = teamintegration.RecoveryCandidate
TeamIntegrationRecovery is one read-only interrupted journal projection.
type TeamIntegrationRecoveryRequest ¶
type TeamIntegrationRecoveryRequest struct {
ID string
Action teamintegration.RecoveryAction
}
TeamIntegrationRecoveryRequest selects explicit recovery convergence.
type TeamIntegrationRequest ¶
type TeamIntegrationRequest struct {
TaskIDs []team.TaskID
Verification *execution.OperationSpec
}
TeamIntegrationRequest selects current captured results. Empty TaskIDs selects every completed Task. Verification is optional and runs in the isolated Worktree.
type TeamIntegrationResult ¶
TeamIntegrationResult reports a terminal integration transaction.
type TeamIntegrationStatus ¶
type TeamIntegrationStatus string
TeamIntegrationStatus is the bounded frontend-visible state of one isolated Team result integration. Private paths, refs, tokens, and journal contents never enter this event protocol.
const ( TeamIntegrationConflict TeamIntegrationStatus = "conflict" TeamIntegrationReady TeamIntegrationStatus = "ready" TeamIntegrationVerified TeamIntegrationStatus = "verified" TeamIntegrationVerificationFailed TeamIntegrationStatus = "verification_failed" TeamIntegrationApprovalRequired TeamIntegrationStatus = "approval_required" TeamIntegrationApplying TeamIntegrationStatus = "applying" TeamIntegrationApplied TeamIntegrationStatus = "applied" TeamIntegrationRejected TeamIntegrationStatus = "rejected" TeamIntegrationInterrupted TeamIntegrationStatus = "interrupted" TeamIntegrationRecoverable TeamIntegrationStatus = "recoverable" TeamIntegrationRolledBack TeamIntegrationStatus = "rolled_back" )
Team result integration lifecycle states.
type TeamLifecycle ¶
type TeamLifecycle struct {
TeamID team.ID `json:"team_id"`
MemberID team.MemberID `json:"member_id,omitempty"`
TaskID team.TaskID `json:"task_id,omitempty"`
AttemptID team.AttemptID `json:"attempt_id,omitempty"`
ChildSessionID string `json:"child_session_id,omitempty"`
State TeamLifecycleStatus `json:"state"`
Activity TeamActivity `json:"activity,omitempty"`
Turns int `json:"turns,omitempty"`
ToolCalls int `json:"tool_calls,omitempty"`
Usage TokenUsage `json:"usage"`
DurationMillis int64 `json:"duration_ms,omitempty"`
Code string `json:"code,omitempty"`
}
TeamLifecycle is the bounded parent projection for Team execution. Logical IDs are present for frontend routing but are excluded from Telemetry.
type TeamLifecycleState ¶
type TeamLifecycleState struct {
TeamLifecycle
}
TeamLifecycleState is the latest compact lifecycle projection for one Team or exact Task Attempt. Child Session transcript and Tool detail never enter this parent projection.
type TeamLifecycleStatus ¶
type TeamLifecycleStatus string
TeamLifecycleStatus is the compact parent-visible state of one Team or one exact Task Attempt. Full Worker output remains owned by the child Session.
const ( TeamLifecycleProposed TeamLifecycleStatus = "proposed" TeamLifecycleAdmitted TeamLifecycleStatus = "admitted" TeamLifecycleWaiting TeamLifecycleStatus = "waiting" TeamLifecycleRunning TeamLifecycleStatus = "running" TeamLifecyclePaused TeamLifecycleStatus = "paused" TeamLifecycleCapturing TeamLifecycleStatus = "capturing" TeamLifecycleCompleted TeamLifecycleStatus = "completed" TeamLifecycleFailed TeamLifecycleStatus = "failed" TeamLifecycleCancelled TeamLifecycleStatus = "cancelled" TeamLifecycleInterrupted TeamLifecycleStatus = "interrupted" TeamLifecycleRecoverable TeamLifecycleStatus = "recoverable" )
Team lifecycle states exposed to frontends and product telemetry.
type TeamMemberView ¶
type TeamMemberView struct {
ID team.MemberID `json:"id"`
Name string `json:"name"`
Role string `json:"role"`
Status team.MemberStatus `json:"status"`
}
TeamMemberView is the local user-visible identity and state of one Team member.
type TeamProposal ¶
type TeamProposal struct {
ID string `json:"id"`
Request TeamProposalRequest `json:"request"`
Dirty bool `json:"dirty"`
ExpiresAt time.Time `json:"expires_at"`
}
TeamProposal is a safe preview. The opaque ID binds repository and Runtime truth internally without disclosing local absolute paths.
func (TeamProposal) Clone ¶
func (value TeamProposal) Clone() TeamProposal
Clone returns a fully detached Team proposal preview.
type TeamProposalPrompt ¶
type TeamProposalPrompt struct {
Objective string `json:"objective"`
}
TeamProposalPrompt is the user-owned objective for one constrained, model-assisted Team proposal run.
type TeamProposalRequest ¶
type TeamProposalRequest struct {
Objective string `json:"objective"`
Workers []TeamWorkerSpec `json:"workers"`
Tasks []TeamTaskSpec `json:"tasks"`
}
TeamProposalRequest contains the complete model/user-controllable Team shape. It cannot carry approval, policy, repository, or credential data.
type TeamReadRequest ¶
type TeamReadRequest struct {
TeamID team.ID `json:"team_id"`
AfterRevision team.Revision `json:"after_revision,omitempty"`
AfterControlRevision uint64 `json:"after_control_revision,omitempty"`
}
TeamReadRequest selects one current Team and bounded changes after exclusive cursors. Zero cursors request a fresh snapshot without replaying historical transitions.
type TeamRecoveryCandidate ¶
type TeamRecoveryCandidate struct {
TeamID team.ID
ResourceRevision team.Revision
ResourceState teamstate.State
TeamStatus team.Status
Disposition TeamRecoveryDisposition
Attempts []TeamAttemptRecoveryCandidate
PendingControls int
InterruptedControl int
UpdatedAt time.Time
Diagnostics []TeamRecoveryDiagnostic
}
TeamRecoveryCandidate is the read-only startup projection for one retained Team owned by this Lead Session. It contains no filesystem paths or child transcript content.
type TeamRecoveryDiagnostic ¶
type TeamRecoveryDiagnostic struct {
Code string
}
TeamRecoveryDiagnostic is a content-free recovery classification. Code is stable for UI decisions; it deliberately carries no path or transcript.
type TeamRecoveryDisposition ¶
type TeamRecoveryDisposition string
TeamRecoveryDisposition is the safe action available for one retained Team.
const ( TeamRecoveryResume TeamRecoveryDisposition = "resume" TeamRecoveryBlockedIdentity TeamRecoveryDisposition = "blocked_identity" TeamRecoveryBlockedState TeamRecoveryDisposition = "blocked_state" )
Team recovery dispositions. Only TeamRecoveryResume may be passed to the explicit resume path; blocked candidates require external repair or review.
type TeamReference ¶
type TeamReference struct {
TeamID team.ID `json:"team_id"`
Admission TeamAdmissionMode `json:"admission"`
BaseOID string `json:"base_oid"`
LeadMember team.MemberID `json:"lead_member_id"`
}
TeamReference identifies the durable admitted Team without exposing its private control-plane paths.
type TeamResumeDecision ¶
TeamResumeDecision binds explicit recovery to the candidate the user reviewed. RetryInterruptedWork authorizes a new continuation Work attempt only when the previous process died during that Work stage.
type TeamTaskSpec ¶
type TeamTaskSpec struct {
ID string `json:"id"`
Title string `json:"title"`
Description string `json:"description,omitempty"`
AssignedWorker string `json:"assigned_worker"`
Dependencies []string `json:"dependencies,omitempty"`
}
TeamTaskSpec is one immutable task and its dependency/assignment edges.
type TeamTaskView ¶
type TeamTaskView struct {
ID team.TaskID `json:"id"`
Title string `json:"title"`
Description string `json:"description,omitempty"`
DependencyIDs []team.TaskID `json:"dependency_ids,omitempty"`
AssignedMemberID team.MemberID `json:"assigned_member_id,omitempty"`
Status team.TaskStatus `json:"status"`
AttemptLimit int `json:"attempt_limit"`
}
TeamTaskView is one bounded task definition and current coordination state.
type TeamView ¶
type TeamView struct {
TeamID team.ID `json:"team_id"`
LeadMemberID team.MemberID `json:"lead_member_id"`
Revision team.Revision `json:"revision"`
ChangeCursor team.Revision `json:"change_cursor"`
ChangesPending bool `json:"changes_pending"`
ResourceRevision team.Revision `json:"resource_revision"`
ControlRevision uint64 `json:"control_revision"`
ControlCursor uint64 `json:"control_cursor"`
ControlsPending bool `json:"controls_pending"`
Status team.Status `json:"status"`
ResourceState teamstate.State `json:"resource_state"`
Objective string `json:"objective"`
Members []TeamMemberView `json:"members"`
Tasks []TeamTaskView `json:"tasks"`
Attempts []TeamAttemptView `json:"attempts"`
Changes []TeamChangeView `json:"changes,omitempty"`
Controls []TeamControlView `json:"controls,omitempty"`
IntegrationPending bool `json:"integration_pending"`
Cleanup TeamCleanupView `json:"cleanup"`
}
TeamView is a detached UI-neutral current Team projection.
type TeamWorkerSpec ¶
TeamWorkerSpec is one user-visible logical Worker. Runtime policy, model, paths, credentials, and Git refs are intentionally absent.
type TeamWorkerTarget ¶
type TeamWorkerTarget struct {
TeamID team.ID `json:"team_id"`
MemberID team.MemberID `json:"member_id"`
TaskID team.TaskID `json:"task_id"`
AttemptID team.AttemptID `json:"attempt_id"`
OwnerGeneration uint64 `json:"owner_generation"`
}
TeamWorkerTarget binds a user response to one exact Worker owner generation.
type TelemetryEvent ¶
type TelemetryEvent struct {
Signal TelemetrySignal `json:"signal,omitempty"`
Type EventType `json:"type,omitempty"`
Time time.Time `json:"time"`
Provider ai.Provider `json:"provider,omitempty"`
ModelID string `json:"model_id,omitempty"`
Agent string `json:"agent,omitempty"`
SubagentRole string `json:"subagent_role,omitempty"`
SubagentState string `json:"subagent_state,omitempty"`
SubagentDelivery subagent.Delivery `json:"subagent_delivery,omitempty"`
SubagentDepth int `json:"subagent_depth,omitempty"`
AdmissionOutcome subagent.AdmissionOutcome `json:"admission_outcome,omitempty"`
AdmissionReason subagent.AdmissionReason `json:"admission_reason,omitempty"`
TeamScope string `json:"team_scope,omitempty"`
TeamState string `json:"team_state,omitempty"`
TeamActivity string `json:"team_activity,omitempty"`
TeamControlAction string `json:"team_control_action,omitempty"`
TeamControlState string `json:"team_control_state,omitempty"`
IntegrationState string `json:"integration_state,omitempty"`
IntegrationVerification string `json:"integration_verification,omitempty"`
BackgroundKind string `json:"background_kind,omitempty"`
BackgroundOutcome string `json:"background_outcome,omitempty"`
Tool string `json:"tool,omitempty"`
ToolCalls int `json:"tool_calls,omitempty"`
Stop agent.StopReason `json:"stop,omitempty"`
Phase Phase `json:"phase,omitempty"`
Mode OperatingMode `json:"mode,omitempty"`
Outcome InteractionOutcome `json:"outcome,omitempty"`
Component string `json:"component,omitempty"`
Code string `json:"code,omitempty"`
Turns int `json:"turns,omitempty"`
Changes int `json:"changes,omitempty"`
Attempts int `json:"attempts,omitempty"`
Files int `json:"files,omitempty"`
Nodes int `json:"nodes,omitempty"`
Questions int `json:"questions,omitempty"`
Answers int `json:"answers,omitempty"`
Chat bool `json:"chat,omitempty"`
PlanBytes int64 `json:"plan_bytes,omitempty"`
PlanDecision string `json:"plan_decision,omitempty"`
CompactionMode CompactionMode `json:"compaction_mode,omitempty"`
TokensBefore int `json:"tokens_before,omitempty"`
TokensAfter int `json:"tokens_after,omitempty"`
DurationMillis int64 `json:"duration_ms,omitempty"`
Usage TokenUsage `json:"usage"`
Resumed bool `json:"resumed,omitempty"`
Failed bool `json:"failed,omitempty"`
}
TelemetryEvent is a low-cardinality, content-free observation derived from one Coding event or an explicitly non-durable Runtime signal. It never contains session, interaction, run, request, or provider-response identifiers.
func Telemetry ¶
func Telemetry(event Event) (TelemetryEvent, error)
Telemetry projects one validated event into content-free observability data.
type TelemetryObserver ¶
type TelemetryObserver interface {
Observe(context.Context, TelemetryEvent) error
}
TelemetryObserver consumes the content-free product telemetry projection. Runtime invokes observers synchronously; implementations own any buffering, export scheduling, and shutdown needed by their backend.
type TelemetryObserverFunc ¶
type TelemetryObserverFunc func(context.Context, TelemetryEvent) error
TelemetryObserverFunc adapts a function to TelemetryObserver.
func (TelemetryObserverFunc) Observe ¶
func (f TelemetryObserverFunc) Observe(ctx context.Context, event TelemetryEvent) error
Observe calls the wrapped function.
type TelemetrySignal ¶
type TelemetrySignal string
TelemetrySignal identifies a content-free observation that has no durable Coding event, such as a rejection before child Session creation.
const ( // TelemetrySignalSubagentAdmission observes a shared-budget decision. TelemetrySignalSubagentAdmission TelemetrySignal = "subagent.admission" )
type TokenUsage ¶
type TokenUsage struct {
InputTokens int `json:"input_tokens"`
OutputTokens int `json:"output_tokens"`
ReasoningTokens int `json:"reasoning_tokens"`
CachedInputTokens int `json:"cached_input_tokens"`
CacheWriteTokens int `json:"cache_write_tokens"`
}
TokenUsage is stable provider-neutral token accounting for Coding events.
type ToolCall ¶
type ToolCall struct {
ID string `json:"id"`
Name string `json:"name"`
Arguments ai.JSON `json:"arguments,omitempty"`
}
ToolCall is the bounded model request projected into tool lifecycle events.
type ToolCompleted ¶
type ToolCompleted struct {
Turn int `json:"turn"`
Call ToolCall `json:"call"`
Result ai.ToolMessage `json:"result"`
}
ToolCompleted carries the final tool-result message for one call.
type ToolStarted ¶
ToolStarted announces a tool invocation before policy gating and execution.
type ToolState ¶
type ToolState struct {
RunID string `json:"run_id"`
Turn int `json:"turn"`
Call ToolCall `json:"call"`
Status ToolStatus `json:"status"`
Update []ai.Part `json:"update"`
Result ai.ToolMessage `json:"result"`
}
ToolState is one tool call and its latest bounded progress/result.
type ToolStatus ¶
type ToolStatus string
ToolStatus is one tool call's lifecycle status.
const ( ToolStatusRunning ToolStatus = "running" ToolStatusCompleted ToolStatus = "completed" )
Tool lifecycle states.
type ToolUpdated ¶
type ToolUpdated struct {
Turn int `json:"turn"`
Call ToolCall `json:"call"`
Update []ai.Part `json:"-"`
}
ToolUpdated carries best-effort progress for an active tool call.
func (ToolUpdated) MarshalJSON ¶
func (payload ToolUpdated) MarshalJSON() ([]byte, error)
MarshalJSON preserves the legacy durable update envelope whose role is "tool" even though progress is not a model ToolMessage.
func (*ToolUpdated) UnmarshalJSON ¶
func (payload *ToolUpdated) UnmarshalJSON(data []byte) error
UnmarshalJSON restores progress parts from the legacy durable tool-role envelope without admitting that envelope into the ai.Message union.
type TurnCompleted ¶
type TurnCompleted struct {
Turn int `json:"turn"`
Usage TokenUsage `json:"usage"`
// ContextTokens is an owner-produced current-context snapshot, not usage.
// Older event producers omit it and retain the cumulative-delta fallback.
ContextTokens *int `json:"context_tokens,omitempty"`
}
TurnCompleted closes one Agent model turn.
type TurnStarted ¶
type TurnStarted struct {
Turn int `json:"turn"`
}
TurnStarted opens one 1-based Agent model turn.
type WorkspaceChange ¶
type WorkspaceChange struct {
Path string `json:"path"`
PreviousPath string `json:"previous_path,omitempty"`
Kind changes.Kind `json:"kind"`
}
WorkspaceChange is one normalized workspace-relative path change.
type WorkspaceChanged ¶
type WorkspaceChanged struct {
Entries []WorkspaceChange `json:"entries"`
Diff string `json:"diff,omitempty"`
Files int `json:"files,omitempty"`
Additions int `json:"additions,omitempty"`
Deletions int `json:"deletions,omitempty"`
Truncated bool `json:"truncated"`
}
WorkspaceChanged carries a bounded change report for the completed interaction.
Source Files
¶
- agent_draft.go
- agent_draft_promotion.go
- agent_library.go
- attachments.go
- bootstrap.go
- child_change_audit.go
- child_control_scope.go
- child_hook_scope.go
- doc.go
- event.go
- event_clone.go
- event_codec.go
- event_hub.go
- event_journal_policy.go
- event_normalize.go
- event_projection.go
- event_publisher.go
- event_writer.go
- goal.go
- history.go
- integration_candidate.go
- integration_generation.go
- interaction.go
- interaction_changes.go
- interaction_journal.go
- media_gate.go
- mode.go
- prompt.go
- reducer.go
- reload.go
- runtime.go
- runtime_agent_invocation.go
- runtime_background.go
- runtime_close.go
- runtime_compaction_policy.go
- runtime_context_budget.go
- runtime_errors.go
- runtime_full_compaction.go
- runtime_goal.go
- runtime_goal_notification.go
- runtime_goal_store.go
- runtime_goal_transcript.go
- runtime_goal_verifier.go
- runtime_goal_work.go
- runtime_hook_generation.go
- runtime_hooks.go
- runtime_interaction.go
- runtime_mcp.go
- runtime_mode.go
- runtime_notification.go
- runtime_plan.go
- runtime_plan_gate.go
- runtime_profile.go
- runtime_scheduler.go
- runtime_session_store.go
- runtime_structure.go
- runtime_subagent.go
- runtime_task_output.go
- runtime_todo.go
- runtime_tool_failure.go
- runtime_worktree.go
- session_media.go
- session_structure.go
- skills.go
- stream_draft.go
- stream_recovery.go
- subagent_dispatch.go
- subagent_message_tool.go
- subagent_model.go
- subagent_worktree.go
- system_prompt.go
- system_reminder.go
- team_admission.go
- team_attempt_state.go
- team_cleanup.go
- team_control.go
- team_control_apply.go
- team_coordinator.go
- team_guard.go
- team_integration.go
- team_lifecycle.go
- team_proposal_agent.go
- team_recovery.go
- team_resume.go
- team_scheduler.go
- team_view.go
- team_worker.go
- team_worker_inspection.go
- telemetry_observer.go
- tool_suggest.go
- worker_admission.go
Directories
¶
| Path | Synopsis |
|---|---|
|
Package acp exposes the Coding Runtime through Agent Client Protocol v1.
|
Package acp exposes the Coding Runtime through Agent Client Protocol v1. |
|
Package agentplugin loads portable Agent Plugins 1.0.0 packages.
|
Package agentplugin loads portable Agent Plugins 1.0.0 packages. |
|
Package agentprofile loads immutable, declarative Coding subagent profiles.
|
Package agentprofile loads immutable, declarative Coding subagent profiles. |
|
Package approval binds durable user decisions to exact coding operations.
|
Package approval binds durable user decisions to exact coding operations. |
|
Package attachment owns bounded Workspace attachment discovery and resolution.
|
Package attachment owns bounded Workspace attachment discovery and resolution. |
|
Package background owns the process-local registry of background tasks that outlive the Tool call that started them.
|
Package background owns the process-local registry of background tasks that outlive the Tool call that started them. |
|
Package changes defines the application boundary for read-only workspace change attribution.
|
Package changes defines the application boundary for read-only workspace change attribution. |
|
git
Package git attributes workspace changes relative to an in-memory-owned baseline using fixed read-only Git commands.
|
Package git attributes workspace changes relative to an in-memory-owned baseline using fixed read-only Git commands. |
|
Package cli provides the Cobra command adapter for the coding application.
|
Package cli provides the Cobra command adapter for the coding application. |
|
Package clipboard isolates desktop clipboard initialization and image reads from the Coding TUI.
|
Package clipboard isolates desktop clipboard initialization and image reads from the Coding TUI. |
|
Package compaction owns bounded coding-session summary generation.
|
Package compaction owns bounded coding-session summary generation. |
|
Package config owns the typed, provenance-preserving configuration used by the coding application.
|
Package config owns the typed, provenance-preserving configuration used by the coding application. |
|
Package credential retrieves provider credentials without putting secrets in application configuration, sessions, logs, or events.
|
Package credential retrieves provider credentials without putting secrets in application configuration, sessions, logs, or events. |
|
Package execution defines validated coding operations, authorization policy, and platform command execution boundaries.
|
Package execution defines validated coding operations, authorization policy, and platform command execution boundaries. |
|
gitcontrol
Package gitcontrol runs the fixed Git plumbing operations required by the Coding Team Worktree control plane.
|
Package gitcontrol runs the fixed Git plumbing operations required by the Coding Team Worktree control plane. |
|
mcpstdio
Package mcpstdio constructs trusted, unsandboxed MCP stdio transports with the Coding Agent's minimal child environment and owned private directories.
|
Package mcpstdio constructs trusted, unsandboxed MCP stdio transports with the Coding Agent's minimal child environment and owned private directories. |
|
sshclient
Package sshclient owns the fixed system OpenSSH process, terminal proxy, and push-only local clipboard upload lifecycle for pips ssh.
|
Package sshclient owns the fixed system OpenSSH process, terminal proxy, and push-only local clipboard upload lifecycle for pips ssh. |
|
systemproxy
Package systemproxy reads the operating system's HTTPS proxy setting that Go's HTTP client ignores.
|
Package systemproxy reads the operating system's HTTPS proxy setting that Go's HTTP client ignores. |
|
Package generation compiles resolved model defaults into a fill-only Agent request policy.
|
Package generation compiles resolved model defaults into a fill-only Agent request policy. |
|
Package goalflow binds the neutral Goal policy to bounded Coding evidence.
|
Package goalflow binds the neutral Goal policy to bounded Coding evidence. |
|
Package hooks owns the Pips-native Coding lifecycle hook configuration, trust records, and reviewed command protocol.
|
Package hooks owns the Pips-native Coding lifecycle hook configuration, trust records, and reviewed command protocol. |
|
Package imagebridge transports bounded normalized images into one live remote Coding TUI without creating files or durable Runtime events.
|
Package imagebridge transports bounded normalized images into one live remote Coding TUI without creating files or durable Runtime events. |
|
Package instructions discovers and composes workspace project instructions.
|
Package instructions discovers and composes workspace project instructions. |
|
Package mcp loads, authorizes, and connects Coding Agent MCP integrations.
|
Package mcp loads, authorizes, and connects Coding Agent MCP integrations. |
|
Package media hydrates session-relative media references into provider bytes and keeps one assembled request inside its byte budget.
|
Package media hydrates session-relative media references into provider bytes and keeps one assembled request inside its byte budget. |
|
Package model composes a typed coding configuration and credential store into an existing provider-neutral language model.
|
Package model composes a typed coding configuration and credential store into an existing provider-neutral language model. |
|
Package modelcatalog resolves immutable provider/model snapshots from the local coding configuration.
|
Package modelcatalog resolves immutable provider/model snapshots from the local coding configuration. |
|
observability
|
|
|
otel
Package otel adapts content-free Coding events to OpenTelemetry traces and metrics.
|
Package otel adapts content-free Coding events to OpenTelemetry traces and metrics. |
|
Package paths defines the user-owned filesystem layout of the coding application without creating any files or directories.
|
Package paths defines the user-owned filesystem layout of the coding application without creating any files or directories. |
|
Package planmode owns the plan-mode state machine, the session-bound plan file, and the model-facing reminder text.
|
Package planmode owns the plan-mode state machine, the session-bound plan file, and the model-facing reminder text. |
|
Package planreview coordinates the explicit plan-mode decisions surfaced to the user: the enter approval and the exit review.
|
Package planreview coordinates the explicit plan-mode decisions surfaced to the user: the enter approval and the exit review. |
|
Package question defines provider-neutral structured user questions.
|
Package question defines provider-neutral structured user questions. |
|
Package resource loads declarative Coding Agent resources from user and trusted project scopes.
|
Package resource loads declarative Coding Agent resources from user and trusted project scopes. |
|
Package runtimecontrol owns replacement of one active Coding Runtime.
|
Package runtimecontrol owns replacement of one active Coding Runtime. |
|
Package scheduler owns the durable per-session scheduled-task list and the interval contract the model-facing scheduler Tools share.
|
Package scheduler owns the durable per-session scheduled-task list and the interval contract the model-facing scheduler Tools share. |
|
Package session adds coding-application identity and single-writer ownership to the durable Harness session repository.
|
Package session adds coding-application identity and single-writer ownership to the durable Harness session repository. |
|
Package skillsettings owns trusted project-local Skill enablement policy.
|
Package skillsettings owns trusted project-local Skill enablement policy. |
|
Package statusline owns the closed inventory and ordering contract for TUI status-line fields.
|
Package statusline owns the closed inventory and ordering contract for TUI status-line fields. |
|
Package subagent owns durable, read-only specialist executions for the Coding application.
|
Package subagent owns durable, read-only specialist executions for the Coding application. |
|
Package subagentprofile loads the declarative role and persona presets that parameterize a delegated child.
|
Package subagentprofile loads the declarative role and persona presets that parameterize a delegated child. |
|
Package tasklist owns the bounded todo_write contract and its durable projection from assistant tool calls.
|
Package tasklist owns the bounded todo_write contract and its durable projection from assistant tool calls. |
|
Package teamcontrol persists operator control intent for Coding Teams.
|
Package teamcontrol persists operator control intent for Coding Teams. |
|
Package teamintegration composes captured Coding Team results and applies an approved typed manifest without changing parent Git metadata.
|
Package teamintegration composes captured Coding Team results and applies an approved typed manifest without changing parent Git metadata. |
|
Package teamstate persists Coding Team application resource bindings.
|
Package teamstate persists Coding Team application resource bindings. |
|
Package teamworktree controls Coding Team Attempt Worktrees and durable Git result refs.
|
Package teamworktree controls Coding Team Attempt Worktrees and durable Git result refs. |
|
Package tools implements application-owned coding tools for one workspace.
|
Package tools implements application-owned coding tools for one workspace. |
|
patch
Package patch parses and applies the bounded, model-facing patch grammar used by the coding application.
|
Package patch parses and applies the bounded, model-facing patch grammar used by the coding application. |
|
Package tui presents the Coding Runtime as a terminal-first chat interface.
|
Package tui presents the Coding Runtime as a terminal-first chat interface. |
|
Package workspace identifies the filesystem root owned by a coding session and persists explicit user trust outside that root.
|
Package workspace identifies the filesystem root owned by a coding session and persists explicit user trust outside that root. |