kami
ed593efb71
Execution events (started/failed/succeeded) never carried the correlation/causation IDs from the ExecuteRequest, even though the fields existed on Execution. Added CausationID to ExecuteRequest and Execution, and split emitEvent into a correlated variant used throughout the execution lifecycle. handleExecute falls back to X-Correlation-ID/X-Causation-ID headers when the body omits them. Also add X-Hexis-Version negotiation on /api/v1/*, matching Nexus. Part of Vikunja #273. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018ghELqYhZNLub2TXGMazqA
98 lines
4.5 KiB
Go
98 lines
4.5 KiB
Go
package domain
|
|
|
|
import "time"
|
|
|
|
type ExecuteRequest struct {
|
|
CapabilityID string `json:"capability_id"`
|
|
TargetEntityID string `json:"target_entity_id"`
|
|
EntityVersion int64 `json:"entity_version,omitempty"`
|
|
Arguments map[string]any `json:"arguments,omitempty"`
|
|
RequestedBy map[string]string `json:"requested_by,omitempty"`
|
|
Origin map[string]string `json:"origin,omitempty"`
|
|
IdempotencyKey string `json:"idempotency_key,omitempty"`
|
|
CorrelationID string `json:"correlation_id,omitempty"`
|
|
CausationID string `json:"causation_id,omitempty"`
|
|
ResolutionEvidence []map[string]any `json:"resolution_evidence,omitempty"`
|
|
ConfirmationID string `json:"confirmation_id,omitempty"`
|
|
}
|
|
|
|
type Capability struct {
|
|
ID string `json:"id"`
|
|
Name string `json:"name"`
|
|
Description string `json:"description,omitempty"`
|
|
TargetTypes []string `json:"target_types"`
|
|
TargetEntityID string `json:"target_entity_id,omitempty"`
|
|
Provider string `json:"provider"`
|
|
Operation string `json:"operation"`
|
|
Risk string `json:"risk,omitempty"`
|
|
ReadOnly bool `json:"read_only"`
|
|
ExpectedSideEffects string `json:"expected_side_effects,omitempty"`
|
|
RequiresConfirmation bool `json:"requires_confirmation"`
|
|
Enabled bool `json:"enabled"`
|
|
TimeoutSeconds int `json:"timeout_seconds,omitempty"`
|
|
Attributes map[string]any `json:"attributes,omitempty"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
Version int64 `json:"version"`
|
|
}
|
|
|
|
// IsDestructive reports whether the capability's risk tier requires it to be
|
|
// disabled by default per ECOSYSTEM-SPEC.md §4.3.
|
|
func (c *Capability) IsDestructive() bool {
|
|
return c.Risk == "destructive"
|
|
}
|
|
|
|
type ExecutionStatus string
|
|
|
|
const (
|
|
ExecutionStarted ExecutionStatus = "started"
|
|
ExecutionSucceeded ExecutionStatus = "succeeded"
|
|
ExecutionFailed ExecutionStatus = "failed"
|
|
ExecutionDenied ExecutionStatus = "denied"
|
|
// ExecutionUnknown marks a wall-clock timeout: the executor may or may not
|
|
// have completed the side effect. Never retried automatically.
|
|
ExecutionUnknown ExecutionStatus = "unknown"
|
|
)
|
|
|
|
type Execution struct {
|
|
ID string `json:"id"`
|
|
CapabilityID string `json:"capability_id"`
|
|
TargetEntityID string `json:"target_entity_id"`
|
|
EntityVersion int64 `json:"entity_version,omitempty"`
|
|
Arguments map[string]any `json:"arguments,omitempty"`
|
|
RequestedBy map[string]string `json:"requested_by,omitempty"`
|
|
Origin map[string]string `json:"origin,omitempty"`
|
|
IdempotencyKey string `json:"idempotency_key,omitempty"`
|
|
ConfirmationID string `json:"confirmation_id,omitempty"`
|
|
Status ExecutionStatus `json:"status"`
|
|
Result map[string]any `json:"result,omitempty"`
|
|
Error string `json:"error,omitempty"`
|
|
ResolutionEvidence []map[string]any `json:"resolution_evidence,omitempty"`
|
|
CorrelationID string `json:"correlation_id,omitempty"`
|
|
CausationID string `json:"causation_id,omitempty"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
}
|
|
|
|
type HexisEventType string
|
|
|
|
const (
|
|
EventCapabilityRegistered HexisEventType = "hexis.capability.registered"
|
|
EventCapabilityUnavailable HexisEventType = "hexis.capability.unavailable"
|
|
EventExecutionStarted HexisEventType = "hexis.execution.started"
|
|
EventExecutionSucceeded HexisEventType = "hexis.execution.succeeded"
|
|
EventExecutionFailed HexisEventType = "hexis.execution.failed"
|
|
EventExecutionDenied HexisEventType = "hexis.execution.denied"
|
|
)
|
|
|
|
type Event struct {
|
|
ID string `json:"id"`
|
|
Sequence int64 `json:"sequence"`
|
|
Type HexisEventType `json:"type"`
|
|
Timestamp time.Time `json:"timestamp"`
|
|
Actor string `json:"actor,omitempty"`
|
|
CorrelationID string `json:"correlation_id,omitempty"`
|
|
CausationID string `json:"causation_id,omitempty"`
|
|
Payload map[string]any `json:"payload,omitempty"`
|
|
}
|