contract

type AliasDefinition struct {
	Name        string `json:"name"`
	Description string `json:"description"`
}

type AppDefinitions struct {
	Editors   []string `json:"editors"`
	Terminals []string `json:"terminals"`
}

type ChatMessagePayload struct {
	Text               string `json:"text"`
	Type               string `json:"type"`                           // e.g., "regular"
	Visibility         string `json:"visibility"`                     // e.g., "human-public", "human-only"
	NoConfirmation     bool   `json:"no_confirmation"`                // If true, bypass the UI confirmation modal
	ReferenceMessageID int64  `json:"reference_message_id,omitempty"` // The ID of the message to target for operations
	Replace            bool   `json:"replace,omitempty"`              // If true, replace the reference message
	InsertBefore       bool   `json:"insert_before,omitempty"`        // If true, insert before the reference message
	InsertAfter        bool   `json:"insert_after,omitempty"`         // If true, insert after the reference message
	MessageID          int64  `json:"message_id,omitempty"`           // The ID of the message inserted by the backend (for 'chat_message_posted')
}

type ContractChangePayload struct {
	Status    string `json:"status"`               // The new status (e.g., "cancelled", "done", "active")
	ExpiresAt string `json:"expires_at,omitempty"` // ISO 8601 timestamp, present if renewed
}

type ContractError struct {
	Code    int
	Message string
}

type ContractInfoResult struct {
	UUID              string                  `json:"uuid"`
	Description       string                  `json:"description"`
	PrimaryWorkdir    string                  `json:"primary_workdir"`
	Workdirs          []contract.WorkdirEntry `json:"workdirs"`
	Status            string                  `json:"status"`
	CreatedAt         time.Time               `json:"created_at"`
	ExpiresAt         time.Time               `json:"expires_at"`
	Authcode          string                  `json:"authcode"`
	ExecTimeout       int                     `json:"exec_timeout"`
	Whitelist         []string                `json:"whitelist"`
	NoWhitelist       bool                    `json:"no_whitelist"`
	PreferredEditor   string                  `json:"preferred_editor"`
	PreferredTerminal string                  `json:"preferred_terminal"`
	PreferredReview   string                  `json:"preferred_review"`
}

type ContractMetadata struct {
	// Embed the core data structure. This handles UnmarshalJSON automatically.
	contract.ContractData

	// Contract-specific fields not stored in the DB message
	ChatID            int64     `json:"chat_id"`
	ChatUUID          string    `json:"chat_uuid"`
	ContractMessageID int64     `json:"contract_message_id"`
	CreatedAt         time.Time `json:"created_at"`

	// Workspace Registry
	// Maps Workspace ID (Composite Hash) -> Workspace Entry
	Workspaces map[string]WorkspaceEntry `json:"workspaces"`
}

type ContractTestResult struct {
	ContractInfoResult // Embedded: Includes UUID, Status, ExpiresAt, etc.

	// Test Specific Fields
	Success      bool   `json:"success"`       // Overall success/failure
	ErrorCode    string `json:"error_code"`    // Specific error code if failed
	Message      string `json:"message"`       // Human-readable status message
	RelativePath string `json:"relative_path"` // Path relative to workdir (if parent found)
	DiffHTML     string `json:"diff_html"`     // HTML fragment of the diff (if parent found)
	DiffUnified  string `json:"diff_unified"`  // Unified diff text (if parent found)
	BlockUUID    string `json:"block_uuid"`    // The UUID from the source file
	ParentUUID   string `json:"parent_uuid"`   // The parent UUID from the source file
	IsUnique     bool   `json:"is_unique"`     // Whether the Block-UUID is unique
}

type DumpError struct {
	Code    string `json:"code"`    // e.g., "INVALID_MESSAGE_ID"
	Message string `json:"message"` // Human-readable description
}

type DumpWriter interface {
	// Prepare initializes the output directory (e.g., wiping old data).
	Prepare(outputDir string) error

	// GetMessageDir returns the relative path for a specific message's artifacts.
	// This allows different writers to structure the hierarchy differently.
	GetMessageDir(chat db.Chat, msg db.Message, position int) string

	// WriteMessage handles the persistence of the raw message content (message.md).
	WriteMessage(msgDir string, msg db.Message) error

	// WriteProvenance persists the chat metadata (provenance) for a message.
	// This is used by the 'merged' type to create the <n>_chats.md file.
	WriteProvenance(msgDir string, chats []db.Chat) error

	// WriteBlock handles the persistence of a code block.
	// The trim flag determines if smart trimming should be applied.
	WriteBlock(msgDir string, block markdown.CodeBlock, trim bool) error

	// WritePatch handles the persistence of a patch block.
	// The trim flag determines if smart trimming should be applied.
	WritePatch(msgDir string, patch markdown.PatchBlock, trim bool) error

	// WritePatchedFile persists the result of a successful patch application.
	// The header is prepended to the content to maintain traceability.
	WritePatchedFile(msgDir string, patch markdown.PatchBlock, header string, content string) error

	// WriteSourceFile copies the original source file from the workdir to the dump directory.
	// This is used by the 'mapped' type to create the 'source.<ext>' file in the shadow workspace.
	WriteSourceFile(msgDir string, relPath string, content string) error

	// WriteProvenanceJSON persists the structured provenance data for a specific file.
	// This is used by the 'mapped' type to create the 'provenance.json' sidecar.
	WriteProvenanceJSON(msgDir string, data Provenance) error
}

type EventStatus string

type LaunchCapabilities struct {
	Aliases  []AliasDefinition `json:"aliases"`
	Apps     AppDefinitions    `json:"apps"`
	Commands []string          `json:"commands"`
}

type LaunchRequest struct {
	ContractUUID string `json:"contract_uuid"`
	Authcode     string `json:"authcode"`
	Alias        string `json:"alias"` // "review", "terminal", "editor", "exec", "dump"
	BlockUUID    string `json:"block_uuid,omitempty"`
	ParentUUID   string `json:"parent_uuid,omitempty"`
	Action       string `json:"action,omitempty"`       // "source", "patch" (review) or "tree", "text", "mapped" (dump)
	AppOverride  string `json:"app_override,omitempty"` // Overrides preferred app (e.g., "zed", "iterm2")
	Cmd          string `json:"cmd,omitempty"`
	Sort         string `json:"sort,omitempty"`        // Sort mode for 'merged' dump type
	DebugPatch   bool   `json:"debug_patch,omitempty"` // Enable patch debugging artifacts
	ActiveChatID int64  `json:"active_chat_id"`        // The ID of the chat the user is currently viewing (for forks)
	Hash         string `json:"hash,omitempty"`        // The message hash for shadow workspace resolution
	Position     int    `json:"position"`              // The 0-indexed position of the code block (-1 for root)
}

type LaunchResult struct {
	Success        bool   `json:"success"`
	Message        string `json:"message"`
	Alias          string `json:"alias"`
	PrimaryWorkdir string `json:"primary_workdir"`
	StagedPath     string `json:"staged_path,omitempty"`
	Command        string `json:"command,omitempty"`
}

type MappedDumpResult struct {
	Success   bool              `json:"success"`
	Exists    bool              `json:"exists"`     // True if the workspace directory was found (validation mode)
	Valid     bool              `json:"valid"`      // True if the workspace is not expired (validation mode)
	Hash      string            `json:"hash"`       // The message hash (directory name)
	RootDir   string            `json:"root_dir"`   // Absolute path to the dump directory
	ExpiresAt string            `json:"expires_at"` // ISO 8601 expiration timestamp
	Stats     MappedDumpStats   `json:"stats"`
	Files     []MappedFileEntry `json:"files"`
	Error     *DumpError        `json:"error,omitempty"` // Present if Success is false
}

type MappedDumpStats struct {
	Mappable   int `json:"mappable"`   // Count of successfully mapped files
	Unmappable int `json:"unmappable"` // Count of unmapped files
}

type MappedFileEntry struct {
	Path         string           `json:"path"`                    // Relative path in the project (or component name)
	OriginalPath string           `json:"original_path,omitempty"` // Original component name before sanitization
	FullRelPath  string           `json:"full_rel_path"`           // Full relative path from workspace root (e.g., mapped/... or unmapped/components/...)
	GenFileName  string           `json:"gen_file_name"`           // The generated filename (e.g., "generated.go", "generated.diff")
	Status       MappedFileStatus `json:"status"`                  // "mapped" or "unmapped"
	BlockUUID    string           `json:"block_uuid"`              // The UUID of the code block
	Reason       string           `json:"reason,omitempty"`        // Why it was unmapped (e.g., "no_parent_uuid")
	Position     int              `json:"position"`                // 0-indexed position of the code block in the original message
	Language     string           `json:"language"`                // The programming language (e.g., "go", "javascript")
}

type MappedFileStatus string

type MappedWriter struct {
	// PathMap maps Block-UUIDs to their resolved relative paths in the project.
	// This is populated by the orchestrator (dumper.go) during the discovery pass.
	PathMap map[string]string
}

type MergedNode struct {
	Message        db.Message
	Hash           string
	Chats          []db.Chat
	Children       []*MergedNode
	ChatCount      int
	MaxSubtreeTime time.Time
}

type MergedWriter struct {
	// contains filtered or unexported fields
}

type PatchError struct {
	Err          error
	Phase1Diff   string // The diff string used in Phase 1
	Phase2Diff   string // The diff string used in Phase 2 (empty if not reached)
	Phase2Offset int    // The offset calculated for Phase 2
}

type Provenance struct {
	FilePath     string   `json:"file_path"`     // Relative path in the project
	BlockUUID    string   `json:"block_uuid"`    // The UUID of the code block
	ParentUUID   string   `json:"parent_uuid"`   // The UUID of the parent block
	Version      string   `json:"version"`       // The version string
	ChatID       int64    `json:"chat_id"`       // The ID of the chat
	MessageID    int64    `json:"message_id"`    // The ID of the message
	ContractUUID string   `json:"contract_uuid"` // The contract UUID
	Model        string   `json:"model"`         // The AI model name
	Timestamp    string   `json:"timestamp"`     // ISO 8601 timestamp
	Action       string   `json:"action"`        // e.g., "patch_applied", "full_code"
	Authors      []string `json:"authors"`       // List of authors
}

type ProvenanceEntry struct {
	Timestamp     time.Time        `json:"timestamp"`
	Status        ProvenanceStatus `json:"status"`
	Action        string           `json:"action"`          // "update-file" or "create-file"
	FilePath      string           `json:"file_path"`       // Relative to repo root
	BlockUUID     string           `json:"block_uuid"`      // The New Block-UUID
	ParentUUID    string           `json:"parent_uuid"`     // The UUID of the code being replaced
	SourceVersion string           `json:"source_version"`  // The version being replaced
	TargetVersion string           `json:"target_version"`  // The version of the new code
	Author        string           `json:"author"`          // The LLM that generated the code
	ContractUUID  string           `json:"contract_uuid"`   // Link to the global contract
	Error         string           `json:"error,omitempty"` // Error message if status is failed
	Description   string           `json:"description"`     // User-defined intent for the change
}

type ProvenanceStatus string

type ShadowWorkspace struct {
	Hash         string            `json:"hash"`          // The Workspace ID (Composite Hash)
	MessageID    int64             `json:"message_id"`    // The ID of the message
	ContractUUID string            `json:"contract_uuid"` // The contract UUID
	CreatedAt    string            `json:"created_at"`    // ISO 8601 timestamp
	ExpiresAt    string            `json:"expires_at"`    // ISO 8601 timestamp
	Stats        MappedDumpStats   `json:"stats"`         // Summary statistics for the dump
	Files        []MappedFileEntry `json:"files"`         // Cached list of files for the UI
}

type TreeWriter struct{}

type WorkspaceEntry struct {
	MessageHash string `json:"message_hash"` // The original 8-char message hash
	MessageID   int64  `json:"message_id"`   // The DB message ID
	CreatedAt   string `json:"created_at"`   // ISO 8601 timestamp of dump creation
}