Documentation
¶
Overview ¶
Package events owns canonical runtime event names and metadata shared by producers, logs, notifications, and contract tests.
Index ¶
- Constants
- func AllowsGlobalScope(name string) bool
- func ComponentFor(name string) string
- func NamesForComponent(component string) []string
- func NamesForOutcomes(outcomes ...Outcome) []string
- func ValidComponent(component string) bool
- func ValidOutcome(value string) bool
- func ValidatePublicName(name string) error
- type Metadata
- type Outcome
Constants ¶
const ( ComponentAutomation = "automation" ComponentCmdPalette = "cmd_palette" ComponentConfig = "config" ComponentExtension = "extension" ComponentGateway = "gateway" ComponentHarness = "harness" ComponentHook = "hook" ComponentMarketplace = "marketplace" ComponentMCP = "mcp" ComponentNotification = "notification" ComponentProvider = "provider" ComponentProfile = "profile" ComponentReliability = "reliability" ComponentRole = "role" ComponentScheduler = "scheduler" ComponentSession = "session" ComponentSkill = "skill" ComponentTask = "task" ComponentTools = "tools" ComponentTranscript = "transcript" ComponentWorkspace = "workspace" ComponentWorktree = "worktree" )
const ( ExtensionInstallCompleted = "extension.install.completed" ExtensionInstallFailed = "extension.install.failed" ExtensionUpdateCompleted = "extension.update.completed" ExtensionUpdateFailed = "extension.update.failed" ExtensionRemoved = "extension.removed" ExtensionEnabled = "extension.enabled" ExtensionDisabled = "extension.disabled" ExtensionEnablementChanged = "extension.enablement_changed" ExtensionProfileCreated = "extension.profile_created" ExtensionGatewayConfirmed = "extension.gateway.confirmed" ExtensionSecretsUpdated = "extension.secrets.updated" ExtensionSecretsUpdateFailed = "extension.secrets.update_failed" ExtensionDigestVerify = "extension.digest.verify" ExtensionDevLinked = "extension.dev.linked" ExtensionDevUnlinked = "extension.dev.unlinked" ExtensionReloadCompleted = "extension.reload.completed" ExtensionReloadFailed = "extension.reload.failed" ExtensionPublishCompleted = "extension.publish.completed" ExtensionPublishFailed = "extension.publish.failed" ExtensionCrashLoopBackoff = "extension.crash_loop.backoff" )
const ( GatewayExposureChanged = "gateway.exposure.changed" GatewayConsentRecorded = "gateway.consent.recorded" GatewayDevicePaired = "gateway.device.paired" GatewayDeviceRevoked = "gateway.device.revoked" GatewayProviderStateChanged = "gateway.provider.state_changed" GatewayEndpointVerified = "gateway.endpoint.verified" GatewayEndpointRejected = "gateway.endpoint.rejected" GatewayIngressBound = "gateway.ingress.bound" GatewayIngressUnbound = "gateway.ingress.unbound" GatewayAuditRun = "gateway.audit.run" )
const ( MarketplaceCatalogRefresh = "marketplace.catalog.refresh" MarketplaceInstall = "marketplace.install" )
const ( MCPAuthBegin = "mcp.auth.begin" MCPAuthExchange = "mcp.auth.exchange" MCPAuthLogout = "mcp.auth.logout" )
const ( ACPUserMessage = "user_message" ACPSyntheticReentry = "synthetic_reentry" ACPAgentMessage = "agent_message" ACPThought = "thought" ACPToolCall = "tool_call" ACPToolResult = "tool_result" ACPPlan = "plan" ACPPermission = "permission" ACPUsage = "usage" ACPSystem = "system" ACPRuntimeProgress = "runtime_progress" ACPRuntimeWarning = "runtime_warning" ACPDone = "done" ACPError = "error" SchedulerCapacityWaitingEscalated = "scheduler.capacity_waiting_escalated" SessionSupervisionWarning = "session.supervision_warning" SessionSupervisionStopped = "session.supervision_stopped" SessionSupervisionSourceError = "session.supervision_source_error" SessionStopped = "session_stopped" SessionTurnQuiesced = "session.turn_quiesced" SessionStopEscalated = "session.stop_escalated" SessionStopVerificationFailed = "session.stop_verification_failed" SessionQueueCleared = "session.queue_cleared" StreamConsumerDegraded = "stream.consumer_degraded" SessionQueueClearFailed = "session.queue_clear_failed" SessionUnhealthy = "session.unhealthy" SessionHung = "session.hung" SessionRecovered = "session.recovered" SessionCompactionFired = "session.compaction_fired" SessionConversationRewound = "session.conversation_rewound" TaskCreated = "task.created" TaskUpdated = "task.updated" TaskPublished = "task.published" TaskApproved = "task.approved" TaskRejected = "task.rejected" TaskCanceled = "task.canceled" TaskChildCreated = "task.child_created" TaskDependencyAdded = "task.dependency_added" TaskDependencyRemoved = "task.dependency_removed" TaskPaused = "task.paused" TaskResumed = "task.resumed" TaskBlockCreated = "task.block.created" TaskBlockCleared = "task.block.cleared" TaskBlockExpired = "task.block.expired" TaskNeedsAttention = "task.needs_attention" TaskRecovered = "task.recovered" TaskRunEnqueued = "task.run_enqueued" TaskRunClaimed = "task.run_claimed" TaskRunStarting = "task.run_starting" TaskRunSessionBound = "task.run_session_bound" TaskRunStarted = "task.run_started" TaskRunCompleted = "task.run_completed" TaskRunFailed = "task.run_failed" TaskRunCanceled = "task.run_canceled" TaskRunForceStopped = "task.run_force_stopped" TaskRunRecovered = "task.run_recovered" TaskRunRejected = "task.run_rejected" TaskRunLeaseExtended = "task.run_lease_extended" TaskRunLeaseExpired = "task.run_lease_expired" TaskRunReleased = "task.run_released" TaskRunOperatorForcedFail = "task.run_operator_forced_fail" TaskRunOperatorRetry = "task.run_operator_retry" TaskRunRecoveredFromAttention = "task.run_recovered_from_attention" TaskRunStarved = "task.run_starved" TaskRunNeedsAttention = "task.run_needs_attention" TaskExecutionProfileUpdated = "task.execution_profile_updated" TaskExecutionProfileDeleted = "task.execution_profile_deleted" TaskRunReviewRequested = "task.run_review_requested" TaskRunReviewBound = "task.run_review_bound" TaskRunReviewRecorded = "task.run_review_recorded" TaskRunReviewApproved = "task.run_review_approved" TaskRunReviewRejected = "task.run_review_rejected" TaskRunReviewBlocked = "task.run_review_blocked" TaskRunReviewError = "task.run_review_error" TaskRunReviewTimeout = "task.run_review_timeout" TaskRunReviewInvalidOutput = "task.run_review_invalid_output" TaskRunReviewRetryEnqueued = "task.run_review_retry_enqueued" TaskAutoEnqueueTriggered = "task.auto_enqueue.triggered" TaskCompletionHallucinationBlocked = "task.completion.hallucination_blocked" TaskCompletionHallucinationSuspected = "task.completion.hallucination_suspected" TaskWakeDelivered = "task.wake.delivered" TaskWakeSuppressed = "task.wake.suppressed" SettingsChanged = "settings.changed" RoleFallbackUsed = "role.fallback.used" // SessionFallbackUsed records a session-owned fallback attempt before it starts. SessionFallbackUsed = "session.fallback.used" // SessionDerived records a continued or forked child after its commit. SessionDerived = "session.derived" RoleResolveError = "role.resolve.error" ProfileCreated = "profile.created" ProfileRenamed = "profile.renamed" ProfileIdentityUpdated = "profile.identity_updated" ProfileArchived = "profile.archived" ProfileUnarchived = "profile.unarchived" ProfileDeleted = "profile.deleted" ProfileSelectionChanged = "profile.selection_changed" ProfilePlanStale = "profile.plan_stale" ProfileLifecycleOpRecovered = "profile.lifecycle_op_recovered" ProfileLifecycleOpFailed = "profile.lifecycle_op_failed" SkillShadowed = "skill.shadowed" SkillLoadFailed = "skills.load_failed" SkillSourcesApplied = "skills.sources.applied" SkillSourcesSuperseded = "skills.sources.superseded" SkillSourcesApplyFailed = "skills.sources.apply_failed" SkillScanTruncated = "skills.scan.truncated" SkillScanLinkSkipped = "skills.scan.link_skipped" SkillExposureCreated = "skills.exposure.created" SkillExposureRemoved = "skills.exposure.removed" SkillExposureOperationFailed = "skills.exposure.operation_failed" SkillExposureBrokenDetected = "skills.exposure.broken_detected" SkillExposureCleanupFailed = "skills.exposure.cleanup_failed" HookDispatchStart = "hook.dispatch.start" HookDispatchComplete = "hook.dispatch.complete" CoordinatorSpawned = "coordinator.spawned" CoordinatorDecision = "coordinator.decision" CoordinatorStopped = "coordinator.stopped" CoordinatorFailed = "coordinator.failed" HarnessContextResolved = "harness.context_resolved" HarnessSectionSelected = "harness.section_selected" HarnessAugmenterApplied = "harness.augmenter_applied" HarnessAugmenterFailed = "harness.augmenter_failed" HarnessDetachedRunCompleted = "harness.detached_run_completed" HarnessSyntheticReentryEmitted = "harness.synthetic_reentry_emitted" HarnessSyntheticReentryDropped = "harness.synthetic_reentry_dropped" SchedulerPaused = "scheduler.paused" SchedulerResumed = "scheduler.resumed" SchedulerDrainStarted = "scheduler.drain_started" SchedulerDrainCompleted = "scheduler.drain_completed" AutomationSuggestionAccepted = "automation.suggestion.accepted" AutomationSuggestionDismissed = "automation.suggestion.dismissed" TranscriptMarkerCreated = "transcript_marker.created" TranscriptMarkerRedacted = "transcript_marker.redacted" SessionTranscriptCacheRebuilt = "session_transcript_cache_rebuilt" SessionStreamSnapshotServed = "session_stream_snapshot_served" SessionStreamSubscribed = "session_stream_subscribed" SessionStreamOverflowFallback = "session_stream_overflow_fallback" ToolCallStarted = "tool.call_started" ToolCallCompleted = "tool.call_completed" ToolCallFailed = "tool.call_failed" ToolCallDenied = "tool.call_denied" ToolResultTruncated = "tool.result_truncated" ToolApprovalGrantPut = "tool.approval_grant_put" ToolApprovalGrantRevoked = "tool.approval_grant_revoked" CmdPaletteCatalogChanged = "cmd_palette.catalog.changed" CmdPaletteCommandInvoked = "cmd_palette.command.invoked" CmdPalettePinChanged = "cmd_palette.pin.changed" CmdPaletteBindingChanged = "cmd_palette.binding.changed" CmdPaletteAliasChanged = "cmd_palette.alias.changed" CmdPalettePersonalizationReset = "cmd_palette.personalization.reset" CmdPaletteViewSessionOpened = "cmd_palette.view_session.opened" CmdPaletteViewSessionClosed = "cmd_palette.view_session.closed" CmdPaletteViewSessionDegraded = "cmd_palette.view_session.degraded" CmdPaletteViewSessionCircuitBroken = "cmd_palette.view_session.circuit_broken" GlobalHotkeyRegistrationFailed = "global_hotkey.registration_failed" ProviderAuthRequired = "provider.auth_required" ProviderAuthRecovered = "provider.auth_recovered" ProviderRateLimited = "provider.rate_limited" ProviderPermissionDenied = "provider.permission_denied" ProviderModelCatalogRefreshed = "provider.model_catalog_refreshed" DeadEntityMarked = "reliability.dead_entity_marked" DeadEntityCleared = "reliability.dead_entity_cleared" NotificationPresetCreated = "notification.preset_created" NotificationPresetUpdated = "notification.preset_updated" NotificationPresetDeleted = "notification.preset_deleted" NotificationPresetDispatchFailed = "notification.preset_dispatch_failed" NotificationPresetEnablementChanged = "notification_preset.enablement_changed" WorktreeCreated = "worktree.created" WorktreeAdopted = "worktree.adopted" WorktreeRemoved = "worktree.removed" WorktreeMissing = "worktree.missing" WorktreeDismissed = "worktree.dismissed" WorktreeCreationCanceled = "worktree.creation_canceled" WorktreeSetupFailed = "worktree.setup_failed" WorktreeStatusRefreshed = "worktree.status_refreshed" WorktreeBranchReclaimed = "worktree.branch_reclaimed" WorktreeExitActionStarted = "worktree.exit_action_started" WorktreeExitActionStep = "worktree.exit_action_step" WorktreeExitHookOutput = "worktree.exit_hook_output" WorktreeExitActionCompleted = "worktree.exit_action_completed" WorktreeExitActionFailed = "worktree.exit_action_failed" WorktreeExitActionCanceled = "worktree.exit_action_canceled" )
const ( WorkspaceAccessDenied = "workspace.access_denied" WorkspaceAccessGranted = "workspace.access_granted" )
Variables ¶
This section is empty.
Functions ¶
func AllowsGlobalScope ¶
AllowsGlobalScope reports whether a summary event may be emitted without a session.
func ComponentFor ¶
ComponentFor returns the registered component for an event name.
func NamesForComponent ¶
NamesForComponent returns canonical event names registered for component.
func NamesForOutcomes ¶
NamesForOutcomes returns canonical event names matching any requested outcome.
func ValidComponent ¶
ValidComponent reports whether component is present in the registry.
func ValidOutcome ¶
ValidOutcome reports whether value is one of the canonical event outcomes.
func ValidatePublicName ¶
ValidatePublicName rejects deleted or unsupported public event families.
Types ¶
type Metadata ¶
type Metadata struct {
Name string
Family string
Component string
Outcome Outcome
EmitsToLogs bool
NotificationEligible bool
GlobalScope bool
}
Metadata is the canonical registry entry for one event name.
type Outcome ¶
type Outcome string
Outcome classifies an event for log filtering and notification policy.
func OutcomeFor ¶
OutcomeFor returns the registered outcome for an event name, defaulting to info.