agents

package
v1.5.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jun 12, 2026 License: AGPL-3.0 Imports: 3 Imported by: 0

Documentation

Overview

Package agents defines shared types and helpers for LLM agent accounts.

Index

Constants

View Source 
const (
	// DroneWorkflowMetadataKey stores typed drone workflow state on the agent user row.
	DroneWorkflowMetadataKey = "drone_workflow"

	// DroneWorkflowPhaseRequest marks the request phase of the workflow.
	DroneWorkflowPhaseRequest = "request"
	// DroneWorkflowPhaseReview marks the review phase of the workflow.
	DroneWorkflowPhaseReview = "review"
	// DroneWorkflowPhaseDeclaration marks the declaration phase of the workflow.
	DroneWorkflowPhaseDeclaration = "declaration"
	// DroneWorkflowPhaseSigning marks the signing phase of the workflow.
	DroneWorkflowPhaseSigning = "signing"
	// DroneWorkflowPhaseGraduation marks the graduation phase of the workflow.
	DroneWorkflowPhaseGraduation = "graduation"
	// DroneWorkflowPhaseContinuity marks the continuity phase of the workflow.
	DroneWorkflowPhaseContinuity = "continuity"

	// DroneWorkflowStateRequestDraft marks a draft request state.
	DroneWorkflowStateRequestDraft = "request.draft"
	// DroneWorkflowStateRequestSubmitted marks a submitted request state.
	DroneWorkflowStateRequestSubmitted = "request.submitted"
	// DroneWorkflowStateReviewQueued marks a queued review state.
	DroneWorkflowStateReviewQueued = "review.queued"
	// DroneWorkflowStateReviewApproved marks an approved review state.
	DroneWorkflowStateReviewApproved = "review.approved"
	// DroneWorkflowStateReviewChangesRequested marks a changes-requested review state.
	DroneWorkflowStateReviewChangesRequested = "review.changes_requested"
	// DroneWorkflowStateReviewBlocked marks a blocked review state.
	DroneWorkflowStateReviewBlocked = "review.blocked"
	// DroneWorkflowStateDeclarationReady marks a ready declaration state.
	DroneWorkflowStateDeclarationReady = "declaration.ready"
	// DroneWorkflowStateSigningPending marks a pending signing state.
	DroneWorkflowStateSigningPending = "signing.pending"
	// DroneWorkflowStateGraduationReady marks a ready graduation state.
	DroneWorkflowStateGraduationReady = "graduation.ready"
	// DroneWorkflowStateGraduationHold marks a held graduation state.
	DroneWorkflowStateGraduationHold = "graduation.hold"
	// DroneWorkflowStateGraduationWatch marks a watch graduation state.
	DroneWorkflowStateGraduationWatch = "graduation.watch"
	// DroneWorkflowStateContinuityStable marks a stable continuity state.
	DroneWorkflowStateContinuityStable = "continuity.stable"
	// DroneWorkflowStateContinuityMonitoring marks a monitoring continuity state.
	DroneWorkflowStateContinuityMonitoring = "continuity.monitoring"
	// DroneWorkflowStateContinuityEscalated marks an escalated continuity state.
	DroneWorkflowStateContinuityEscalated = "continuity.escalated"
	// DroneIdentityStateDrone marks an unsouled drone identity state.
	DroneIdentityStateDrone = "drone"
	// DroneIdentityStateGraduating marks a graduating identity state.
	DroneIdentityStateGraduating = "graduating"
	// DroneIdentityStateSouled marks a souled identity state.
	DroneIdentityStateSouled = "souled"
	// DroneContinuityStatePlanned marks planned continuity semantics.
	DroneContinuityStatePlanned = "planned"
	// DroneContinuityStateStable marks stable continuity semantics.
	DroneContinuityStateStable = "stable"
	// DroneContinuityStateMonitoring marks monitored continuity semantics.
	DroneContinuityStateMonitoring = "monitoring"
	// DroneContinuityStateEscalated marks escalated continuity semantics.
	DroneContinuityStateEscalated = "escalated"
	// DroneLifecycleStatusUpcoming marks an upcoming lifecycle step.
	DroneLifecycleStatusUpcoming = "upcoming"
	// DroneLifecycleStatusActive marks an active lifecycle step.
	DroneLifecycleStatusActive = "active"
	// DroneLifecycleStatusComplete marks a completed lifecycle step.
	DroneLifecycleStatusComplete = "complete"
	// DroneLifecycleStatusBlocked marks a blocked lifecycle step.
	DroneLifecycleStatusBlocked = "blocked"
	// DroneReviewDecisionQueued marks a queued review decision.
	DroneReviewDecisionQueued = "queued"
	// DroneReviewDecisionApproved marks an approved review decision.
	DroneReviewDecisionApproved = "approved"
	// DroneReviewDecisionChangesRequested marks a changes-requested review decision.
	DroneReviewDecisionChangesRequested = "changes_requested"
	// DroneReviewDecisionBlocked marks a blocked review decision.
	DroneReviewDecisionBlocked = "blocked"
	// DroneGraduationReadinessReady marks a ready graduation decision.
	DroneGraduationReadinessReady = "ready"
	// DroneGraduationReadinessWatch marks a watch graduation decision.
	DroneGraduationReadinessWatch = "watch"
	// DroneGraduationReadinessHold marks a hold graduation decision.
	DroneGraduationReadinessHold = "hold"
	// DroneSignatureSignerStatusPending marks a pending signer status.
	DroneSignatureSignerStatusPending = "pending"
	// DroneSignatureSignerStatusApproved marks an approved signer status.
	DroneSignatureSignerStatusApproved = "approved"
	// DroneSignatureSignerStatusRejected marks a rejected signer status.
	DroneSignatureSignerStatusRejected = "rejected"
)
View Source 
const (
	// SoulBootstrapPhaseNotStarted marks a local body with no Host bootstrap state yet.
	SoulBootstrapPhaseNotStarted = "not_started"
	// SoulBootstrapPhaseBegin tracks Host registration begin.
	SoulBootstrapPhaseBegin = "begin"
	// SoulBootstrapPhaseWalletVerification tracks the wallet challenge verification step.
	SoulBootstrapPhaseWalletVerification = "wallet_verification"
	// SoulBootstrapPhasePrincipalDeclaration tracks the principal declaration signing step.
	SoulBootstrapPhasePrincipalDeclaration = "principal_declaration"
	// SoulBootstrapPhaseConversation tracks the Host mint conversation step.
	SoulBootstrapPhaseConversation = "conversation"
	// SoulBootstrapPhaseFinalize tracks Host finalize preflight/finalize.
	SoulBootstrapPhaseFinalize = "finalize"
	// SoulBootstrapPhaseComplete marks a locally bound soul/body identity.
	SoulBootstrapPhaseComplete = "complete"
	// SoulBootstrapPhaseError marks a typed bootstrap error.
	SoulBootstrapPhaseError = "error"

	// SoulBootstrapStateNotStarted is the default zero-state local bootstrap state.
	SoulBootstrapStateNotStarted = "not_started"
	// SoulBootstrapStateHostBridgeUnavailable is returned by M2.1 resolver skeletons.
	SoulBootstrapStateHostBridgeUnavailable = "error.host_bridge_unavailable"
	// SoulBootstrapStateHostTrustNotConfigured marks a missing effective Host trust base URL.
	SoulBootstrapStateHostTrustNotConfigured = "error.host_trust_not_configured"
	// SoulBootstrapStateHostInstanceKeyMissing marks a missing server-side Host instance key.
	SoulBootstrapStateHostInstanceKeyMissing = "error.host_instance_key_missing"
	// SoulBootstrapStateHostInstanceKeyUnavailable marks an unresolvable Host instance key.
	SoulBootstrapStateHostInstanceKeyUnavailable = "error.host_instance_key_unavailable"
	// SoulBootstrapStateHostUnavailable marks a bounded Host/network failure.
	SoulBootstrapStateHostUnavailable = "error.host_unavailable"
	// SoulBootstrapStateHostSigningPayloadUnsupported marks unsupported Host signing metadata.
	SoulBootstrapStateHostSigningPayloadUnsupported = "error.host_signing_payload_unsupported"
	// SoulBootstrapStateConversationInProgress marks an active Host mint conversation.
	SoulBootstrapStateConversationInProgress = "conversation.in_progress"
	// SoulBootstrapStateConversationCompleted marks a completed Host mint conversation.
	SoulBootstrapStateConversationCompleted = "conversation.completed"
	// SoulBootstrapStateFinalizeReady marks Host finalize preflight signing material readiness.
	SoulBootstrapStateFinalizeReady = "finalize.ready"
	// SoulBootstrapStateFinalizePublished marks Host publication before local binding completes.
	SoulBootstrapStateFinalizePublished = "finalize.published"
	// SoulBootstrapStateCorrelationMismatch marks a local replay/correlation mismatch.
	SoulBootstrapStateCorrelationMismatch = "error.correlation_mismatch"
	// SoulBootstrapStateBindingConflict marks a safe local soul/body binding conflict.
	SoulBootstrapStateBindingConflict = "error.binding_conflict"
	// SoulBootstrapStateSoulNotAvailable marks Host publication evidence that cannot be bound locally.
	SoulBootstrapStateSoulNotAvailable = "error.soul_not_available"
	// SoulBootstrapStateCompleteBound marks an existing soul/body binding projection.
	SoulBootstrapStateCompleteBound = "complete.bound"

	// SoulBootstrapErrorHostBridgeUnavailable is the typed M2.1 not-yet-executable error.
	SoulBootstrapErrorHostBridgeUnavailable = "HOST_BRIDGE_UNAVAILABLE"
	// SoulBootstrapErrorHostTrustNotConfigured is exposed when effective Host trust config is missing.
	SoulBootstrapErrorHostTrustNotConfigured = "HOST_TRUST_NOT_CONFIGURED"
	// SoulBootstrapErrorHostInstanceKeyMissing is exposed when the server-side Host instance key is absent.
	SoulBootstrapErrorHostInstanceKeyMissing = "HOST_INSTANCE_KEY_MISSING"
	// SoulBootstrapErrorHostInstanceKeyUnavailable is exposed when the Host instance key secret cannot be resolved.
	SoulBootstrapErrorHostInstanceKeyUnavailable = "HOST_INSTANCE_KEY_UNAVAILABLE"
	// SoulBootstrapErrorHostUnavailable is exposed for Host network/availability failures.
	SoulBootstrapErrorHostUnavailable = "HOST_UNAVAILABLE"
	// SoulBootstrapErrorHostSigningPayloadUnsupported is exposed for unsupported Host signing metadata.
	SoulBootstrapErrorHostSigningPayloadUnsupported = "HOST_SIGNING_PAYLOAD_UNSUPPORTED"
	// SoulBootstrapErrorHostRegistrationIDRequired is exposed when no Host registration id is available.
	SoulBootstrapErrorHostRegistrationIDRequired = "HOST_REGISTRATION_ID_REQUIRED"
	// SoulBootstrapErrorHostConversationIDRequired is exposed when no Host conversation id is available.
	SoulBootstrapErrorHostConversationIDRequired = "HOST_CONVERSATION_ID_REQUIRED"
	// SoulBootstrapErrorHostBootstrapReplayRejected is exposed when caller ids do not match local bootstrap state.
	SoulBootstrapErrorHostBootstrapReplayRejected = "HOST_BOOTSTRAP_REPLAY_REJECTED"
	// SoulBootstrapErrorSoulBindingConflict is exposed when local binding uniqueness rejects finalization.
	SoulBootstrapErrorSoulBindingConflict = "SOUL_BINDING_CONFLICT"
	// SoulBootstrapErrorSoulNotAvailable is exposed when Host-published soul identity is not locally bindable.
	SoulBootstrapErrorSoulNotAvailable = "SOUL_NOT_AVAILABLE"
)

Variables

This section is empty.

Functions

func SetDroneWorkflowMetadata added in v1.2.0 

func SetDroneWorkflowMetadata(metadata map[string]interface{}, workflow *DroneWorkflowState) (map[string]interface{}, error)

SetDroneWorkflowMetadata stores typed drone workflow state back into user metadata.

Types

type Capabilities 

type Capabilities struct {
	CanPost   bool `json:"can_post"`
	CanReply  bool `json:"can_reply"`
	CanBoost  bool `json:"can_boost"`
	CanFollow bool `json:"can_follow"`
	CanDM     bool `json:"can_dm"`

	RestrictedDomains []string `json:"restricted_domains,omitempty"`
	MaxPostsPerHour   int      `json:"max_posts_per_hour"`
	RequiresApproval  bool     `json:"requires_approval"`
}

Capabilities describe what an agent account is permitted to do at a high level.

This is intentionally coarse-grained; operational enforcement (rate limits, quarantine, circuit breakers, and per-endpoint policy) is handled elsewhere.

type DroneActor added in v1.2.0 

type DroneActor struct {
	ID          string `json:"id"`
	Name        string `json:"name"`
	Role        string `json:"role"`
	Handle      string `json:"handle,omitempty"`
	AvatarLabel string `json:"avatar_label,omitempty"`
	StatusLabel string `json:"status_label,omitempty"`
}

DroneActor describes one person or system represented in the workflow.

type DroneArtifact added in v1.2.0 

type DroneArtifact struct {
	ID          string `json:"id"`
	Title       string `json:"title"`
	Description string `json:"description,omitempty"`
	Href        string `json:"href,omitempty"`
	Emphasis    string `json:"emphasis,omitempty"`
}

DroneArtifact describes one machine-readable or user-visible workflow artifact.

type DroneContinuityFollowUp added in v1.2.0 

type DroneContinuityFollowUp struct {
	ID      string     `json:"id"`
	Title   string     `json:"title"`
	Summary string     `json:"summary"`
	Owner   DroneActor `json:"owner"`
	Cadence string     `json:"cadence,omitempty"`
}

DroneContinuityFollowUp captures one continuity follow-up action.

type DroneContinuityPanel added in v1.2.0 

type DroneContinuityPanel struct {
	ID           string                    `json:"id"`
	Title        string                    `json:"title"`
	Objective    string                    `json:"objective"`
	Owner        DroneActor                `json:"owner"`
	FeedbackLoop string                    `json:"feedback_loop"`
	Metrics      []DroneMetric             `json:"metrics,omitempty"`
	FollowUps    []DroneContinuityFollowUp `json:"follow_ups,omitempty"`
}

DroneContinuityPanel describes the continuity plan after graduation.

type DroneConversationState added in v1.2.0 

type DroneConversationState struct {
	ConversationID  string     `json:"conversation_id"`
	Folder          string     `json:"folder,omitempty"`
	RequestState    string     `json:"request_state,omitempty"`
	Unread          bool       `json:"unread"`
	PreviewStatusID string     `json:"preview_status_id,omitempty"`
	RequestedAt     *time.Time `json:"requested_at,omitempty"`
	AcceptedAt      *time.Time `json:"accepted_at,omitempty"`
	DeclinedAt      *time.Time `json:"declined_at,omitempty"`
	UpdatedAt       *time.Time `json:"updated_at,omitempty"`
}

DroneConversationState captures related conversation progress for the workflow.

type DroneDeclarationCard added in v1.2.0 

type DroneDeclarationCard struct {
	ID                  string          `json:"id"`
	Title               string          `json:"title"`
	Statement           string          `json:"statement"`
	Confidence          string          `json:"confidence"`
	Owner               *DroneActor     `json:"owner,omitempty"`
	DeclaredScope       []string        `json:"declared_scope,omitempty"`
	Risks               []string        `json:"risks,omitempty"`
	SupportingArtifacts []DroneArtifact `json:"supporting_artifacts,omitempty"`
}

DroneDeclarationCard captures the declaration artifacts used for promotion.

type DroneGraduationSummaryCard added in v1.2.0 

type DroneGraduationSummaryCard struct {
	ID                  string        `json:"id"`
	Title               string        `json:"title"`
	Readiness           string        `json:"readiness"`
	Summary             string        `json:"summary"`
	LaunchOwner         *DroneActor   `json:"launch_owner,omitempty"`
	CompletedMilestones []string      `json:"completed_milestones,omitempty"`
	ExitCriteria        []string      `json:"exit_criteria,omitempty"`
	NextStep            string        `json:"next_step,omitempty"`
	Metrics             []DroneMetric `json:"metrics,omitempty"`
}

DroneGraduationSummaryCard captures the graduation summary for the workflow.

type DroneIdentityCard added in v1.2.0 

type DroneIdentityCard struct {
	ID           string        `json:"id"`
	Name         string        `json:"name"`
	Handle       string        `json:"handle,omitempty"`
	Summary      string        `json:"summary"`
	CurrentPhase string        `json:"current_phase"`
	CurrentState string        `json:"current_state,omitempty"`
	Steward      *DroneActor   `json:"steward,omitempty"`
	Tags         []string      `json:"tags,omitempty"`
	Metrics      []DroneMetric `json:"metrics,omitempty"`
}

DroneIdentityCard summarizes the current identity panel for a drone workflow.

type DroneIdentitySemantics added in v1.2.0 

type DroneIdentitySemantics struct {
	IdentityState             string `json:"identity_state"`
	IdentityLabel             string `json:"identity_label"`
	LifecycleState            string `json:"lifecycle_state"`
	SoulBindingState          string `json:"soul_binding_state"`
	SoulAgentID               string `json:"soul_agent_id,omitempty"`
	ContinuityState           string `json:"continuity_state"`
	ContinuitySummary         string `json:"continuity_summary"`
	BodyIdentityPreserved     bool   `json:"body_identity_preserved"`
	TimelinePresencePreserved bool   `json:"timeline_presence_preserved"`
	MemoryReferencesPreserved bool   `json:"memory_references_preserved"`
	AttributionLabel          string `json:"attribution_label"`
	ModerationLabel           string `json:"moderation_label"`
}

DroneIdentitySemantics describes identity and continuity semantics for a drone.

func DeriveDroneIdentitySemantics added in v1.2.0 

func DeriveDroneIdentitySemantics(username string, workflow *DroneWorkflowState, soulBound bool, soulAgentID string) DroneIdentitySemantics

DeriveDroneIdentitySemantics derives identity semantics from workflow and soul state.

type DroneLifecycleStep added in v1.2.0 

type DroneLifecycleStep struct {
	Phase   string `json:"phase"`
	Title   string `json:"title,omitempty"`
	Summary string `json:"summary,omitempty"`
	State   string `json:"state,omitempty"`
	Status  string `json:"status"`
}

DroneLifecycleStep describes one lifecycle phase in the workflow timeline.

func BuildDroneLifecycle added in v1.2.0 

func BuildDroneLifecycle(currentPhase string, currentState string) []DroneLifecycleStep

BuildDroneLifecycle derives lifecycle steps for the current workflow phase and state.

type DroneMetric added in v1.2.0 

type DroneMetric struct {
	Label  string `json:"label"`
	Value  string `json:"value"`
	Detail string `json:"detail,omitempty"`
}

DroneMetric describes one labeled workflow metric.

type DroneRequestCard added in v1.2.0 

type DroneRequestCard struct {
	ID            string          `json:"id"`
	Title         string          `json:"title"`
	Summary       string          `json:"summary"`
	RequestedBy   DroneActor      `json:"requested_by"`
	SubmittedAt   *time.Time      `json:"submitted_at,omitempty"`
	Constraints   []string        `json:"constraints,omitempty"`
	Artifacts     []DroneArtifact `json:"artifacts,omitempty"`
	RouteDecision string          `json:"route_decision,omitempty"`
	CurrentState  string          `json:"current_state,omitempty"`
}

DroneRequestCard captures the request stage of a drone workflow.

type DroneReviewCard added in v1.2.0 

type DroneReviewCard struct {
	ID              string               `json:"id"`
	Title           string               `json:"title"`
	Decision        string               `json:"decision"`
	Reviewer        DroneActor           `json:"reviewer"`
	DecisionSummary string               `json:"decision_summary"`
	Findings        []DroneReviewFinding `json:"findings,omitempty"`
	Evidence        []DroneArtifact      `json:"evidence,omitempty"`
}

DroneReviewCard captures the review stage of a drone workflow.

type DroneReviewFinding added in v1.2.0 

type DroneReviewFinding struct {
	ID       string `json:"id"`
	Title    string `json:"title"`
	Detail   string `json:"detail"`
	Severity string `json:"severity,omitempty"`
}

DroneReviewFinding captures one review finding attached to a workflow review.

type DroneSignatureCheckpoint added in v1.2.0 

type DroneSignatureCheckpoint struct {
	ID             string                 `json:"id"`
	Title          string                 `json:"title"`
	ReadinessLabel string                 `json:"readiness_label"`
	ApprovalMemo   string                 `json:"approval_memo,omitempty"`
	DueAt          *time.Time             `json:"due_at,omitempty"`
	Signers        []DroneSignatureSigner `json:"signers,omitempty"`
}

DroneSignatureCheckpoint captures the approval checkpoint for promotion.

type DroneSignatureSigner added in v1.2.0 

type DroneSignatureSigner struct {
	ID     string `json:"id"`
	Name   string `json:"name"`
	Role   string `json:"role"`
	Status string `json:"status"`
	Note   string `json:"note,omitempty"`
}

DroneSignatureSigner describes one signer in a workflow checkpoint.

type DroneWorkflowState added in v1.2.0 

type DroneWorkflowState struct {
	CurrentPhase string `json:"current_phase,omitempty"`
	CurrentState string `json:"current_state,omitempty"`
	SoulAgentID  string `json:"soul_agent_id,omitempty"`

	Request       *DroneRequestCard           `json:"request,omitempty"`
	Review        *DroneReviewCard            `json:"review,omitempty"`
	Declaration   *DroneDeclarationCard       `json:"declaration,omitempty"`
	Checkpoint    *DroneSignatureCheckpoint   `json:"checkpoint,omitempty"`
	Graduation    *DroneGraduationSummaryCard `json:"graduation,omitempty"`
	Continuity    *DroneContinuityPanel       `json:"continuity,omitempty"`
	Conversation  *DroneConversationState     `json:"conversation,omitempty"`
	SoulBootstrap *SoulBootstrapState         `json:"soul_bootstrap,omitempty"`
	Lifecycle     []DroneLifecycleStep        `json:"lifecycle,omitempty"`
	UpdatedAt     *time.Time                  `json:"updated_at,omitempty"`
}

DroneWorkflowState stores the typed agent-first workflow metadata published to clients.

func NormalizeDroneWorkflow added in v1.2.0 

func NormalizeDroneWorkflow(workflow *DroneWorkflowState) *DroneWorkflowState

NormalizeDroneWorkflow fills default fields for an incomplete workflow state.

func ParseDroneWorkflowMetadata added in v1.2.0 

func ParseDroneWorkflowMetadata(metadata map[string]interface{}) (*DroneWorkflowState, error)

ParseDroneWorkflowMetadata decodes typed drone workflow state from user metadata.

func (*DroneWorkflowState) Clone added in v1.2.0 

func (w *DroneWorkflowState) Clone() *DroneWorkflowState

Clone returns a deep copy of the workflow state.

type SoulBootstrapCorrelationState added in v1.5.0 

type SoulBootstrapCorrelationState struct {
	CorrelationKey                     string `json:"correlation_key,omitempty"`
	BeginIdempotencyKey                string `json:"begin_idempotency_key,omitempty"`
	WalletVerificationIdempotencyKey   string `json:"wallet_verification_idempotency_key,omitempty"`
	PrincipalDeclarationIdempotencyKey string `json:"principal_declaration_idempotency_key,omitempty"`
	ConversationIdempotencyKey         string `json:"conversation_idempotency_key,omitempty"`
	FinalizeIdempotencyKey             string `json:"finalize_idempotency_key,omitempty"`
	LastHostRequestID                  string `json:"last_host_request_id,omitempty"`
}

SoulBootstrapCorrelationState stores caller-provided correlation keys and idempotency-key hints. Host M1.5 does not expose idempotency headers for the instance-key route family, so these values remain Lesser-local until a future Host contract supports them.

type SoulBootstrapErrorState added in v1.5.0 

type SoulBootstrapErrorState struct {
	Code          string     `json:"code,omitempty"`
	Message       string     `json:"message,omitempty"`
	Source        string     `json:"source,omitempty"`
	StatusCode    int        `json:"status_code,omitempty"`
	HostRequestID string     `json:"host_request_id,omitempty"`
	At            *time.Time `json:"at,omitempty"`
}

SoulBootstrapErrorState stores a typed, client-safe bootstrap error.

type SoulBootstrapPublicationEvidence added in v1.5.0 

type SoulBootstrapPublicationEvidence struct {
	AgentID                    string     `json:"agent_id,omitempty"`
	PublishedVersion           int        `json:"published_version,omitempty"`
	RegistrationURI            string     `json:"registration_uri,omitempty"`
	RegistrationS3Key          string     `json:"registration_s3_key,omitempty"`
	VersionedRegistrationURI   string     `json:"versioned_registration_uri,omitempty"`
	VersionedRegistrationS3Key string     `json:"versioned_registration_s3_key,omitempty"`
	AnchorState                string     `json:"anchor_state,omitempty"`
	PublishedAt                *time.Time `json:"published_at,omitempty"`
}

SoulBootstrapPublicationEvidence records Host publication evidence without storing any Host instance key or browser credential material.

type SoulBootstrapSigningCheckpoint added in v1.5.0 

type SoulBootstrapSigningCheckpoint struct {
	Version                     string     `json:"version,omitempty"`
	Name                        string     `json:"name,omitempty"`
	Status                      string     `json:"status,omitempty"`
	PrincipalAddress            string     `json:"principal_address,omitempty"`
	SignerAddress               string     `json:"signer_address,omitempty"`
	SigningMethod               string     `json:"signing_method,omitempty"`
	MessageEncoding             string     `json:"message_encoding,omitempty"`
	Message                     string     `json:"message,omitempty"`
	MessageHex                  string     `json:"message_hex,omitempty"`
	DigestHex                   string     `json:"digest_hex,omitempty"`
	CanonicalJSON               string     `json:"canonical_json,omitempty"`
	ExpectedVersion             int        `json:"expected_version,omitempty"`
	NextVersion                 int        `json:"next_version,omitempty"`
	BoundaryRequirementsJSON    string     `json:"boundary_requirements_json,omitempty"`
	FinalizeRequestTemplateJSON string     `json:"finalize_request_template_json,omitempty"`
	RegistrationPreviewJSON     string     `json:"registration_preview_json,omitempty"`
	HostRequestID               string     `json:"host_request_id,omitempty"`
	IssuedAt                    *time.Time `json:"issued_at,omitempty"`
	DeclaredAt                  *time.Time `json:"declared_at,omitempty"`
	CompletedAt                 *time.Time `json:"completed_at,omitempty"`
}

SoulBootstrapSigningCheckpoint records non-secret signing material metadata returned by Host preflight endpoints.

func (SoulBootstrapSigningCheckpoint) Clone added in v1.5.0 

func (c SoulBootstrapSigningCheckpoint) Clone() SoulBootstrapSigningCheckpoint

Clone returns a deep copy of the signing checkpoint.

type SoulBootstrapState added in v1.5.0 

type SoulBootstrapState struct {
	Username           string                            `json:"username,omitempty"`
	BodyID             string                            `json:"body_id,omitempty"`
	HostRegistrationID string                            `json:"host_registration_id,omitempty"`
	HostConversationID string                            `json:"host_conversation_id,omitempty"`
	HostSoulAgentID    string                            `json:"host_soul_agent_id,omitempty"`
	WalletAddress      string                            `json:"wallet_address,omitempty"`
	PrincipalAddress   string                            `json:"principal_address,omitempty"`
	Phase              string                            `json:"phase,omitempty"`
	State              string                            `json:"state,omitempty"`
	SigningCheckpoints []SoulBootstrapSigningCheckpoint  `json:"signing_checkpoints,omitempty"`
	Publication        *SoulBootstrapPublicationEvidence `json:"publication,omitempty"`
	Error              *SoulBootstrapErrorState          `json:"error,omitempty"`
	Correlation        *SoulBootstrapCorrelationState    `json:"correlation,omitempty"`
	UpdatedAt          *time.Time                        `json:"updated_at,omitempty"`
}

SoulBootstrapState stores local correlation state for zero-state soul creation.

It is nested inside DroneWorkflowState metadata so the bootstrap workflow remains visible through the existing body/drone workflow path. Host instance keys are not represented here; only Host-issued identifiers, signing checkpoint metadata, and client-safe error/correlation values are persisted.

func NewSoulBootstrapErrorState added in v1.5.0 

func NewSoulBootstrapErrorState(username string, correlation *SoulBootstrapCorrelationState, code string, message string, source string, statusCode int, hostRequestID string, now time.Time) *SoulBootstrapState

NewSoulBootstrapErrorState builds a typed, client-safe error state.

func NewSoulBootstrapHostBridgeUnavailableState added in v1.5.0 

func NewSoulBootstrapHostBridgeUnavailableState(username string, correlation *SoulBootstrapCorrelationState, now time.Time) *SoulBootstrapState

NewSoulBootstrapHostBridgeUnavailableState builds the typed M2.1 skeleton state.

func NormalizeSoulBootstrap added in v1.5.0 

func NormalizeSoulBootstrap(state *SoulBootstrapState, username string) *SoulBootstrapState

NormalizeSoulBootstrap fills defaults and canonical string forms for a bootstrap state. The returned value is a clone and can be mutated by callers.

func (*SoulBootstrapState) Clone added in v1.5.0 

func (s *SoulBootstrapState) Clone() *SoulBootstrapState

Clone returns a deep copy of the bootstrap state.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.