cogblock

type BlockArtifact struct {
	Kind string `json:"kind"`
	Ref  string `json:"ref"`
}

type BlockProvenance struct {
	OriginSession string    `json:"origin_session,omitempty"`
	OriginChannel string    `json:"origin_channel,omitempty"`
	IngestedAt    time.Time `json:"ingested_at"`
	NormalizedBy  string    `json:"normalized_by"`
}

type CogBlock struct {
	ID        string    `json:"id"`
	Timestamp time.Time `json:"timestamp"`
	SessionID string    `json:"session_id,omitempty"`
	ThreadID  string    `json:"thread_id,omitempty"`

	// Source identification.
	SourceChannel   string `json:"source_channel"`
	SourceTransport string `json:"source_transport"`
	SourceIdentity  string `json:"source_identity,omitempty"`

	// Target.
	TargetIdentity string `json:"target_identity,omitempty"`
	WorkspaceID    string `json:"workspace_id,omitempty"`

	// Content.
	Kind         CogBlockKind    `json:"kind"`
	RawPayload   json.RawMessage `json:"raw_payload,omitempty"`
	SystemPrompt string          `json:"system_prompt,omitempty"`

	// Messages is kept as raw JSON to avoid coupling to any specific
	// provider message format. The kernel decodes this into its own
	// ProviderMessage type; external consumers can decode as needed.
	Messages json.RawMessage `json:"messages,omitempty"`

	// Provenance.
	Provenance   BlockProvenance `json:"provenance"`
	TrustContext TrustContext    `json:"trust_context"`

	// Ledger linkage.
	LedgerRef string `json:"ledger_ref,omitempty"`

	// Artifacts produced from processing this block.
	Artifacts []BlockArtifact `json:"artifacts,omitempty"`
}

type CogBlockKind string

type EventEnvelope struct {
	// HashedPayload contains the canonical JSON that gets hashed.
	HashedPayload EventPayload `json:"hashed_payload"`

	// Metadata is NOT included in the hash (for extensibility).
	Metadata EventMetadata `json:"metadata,omitempty"`
}

type EventMetadata struct {
	// Hash of the canonical hashed_payload (computed during append).
	Hash string `json:"hash,omitempty"`

	// Seq is the sequence number within the session (computed during append).
	Seq int64 `json:"seq,omitempty"`

	// Source identifies what produced the event (e.g., "kernel", "hook", "cog-chat").
	Source string `json:"source,omitempty"`
}

type EventPayload struct {
	// Type of event (e.g., "workspace.genesis", "tool.call", "validation.success").
	Type string `json:"type"`

	// Timestamp when the event occurred (RFC3339 format).
	Timestamp string `json:"timestamp"`

	// SessionID that produced this event.
	SessionID string `json:"session_id"`

	// PriorHash chains to the previous event (empty for genesis).
	PriorHash string `json:"prior_hash,omitempty"`

	// Data contains type-specific payload (optional).
	Data map[string]interface{} `json:"data,omitempty"`
}

type TrustContext struct {
	Authenticated bool    `json:"authenticated"`
	TrustScore    float64 `json:"trust_score"`
	Scope         string  `json:"scope"`
}