config

type AgentConfig struct {
	// Backend selects the agent backend: "claude" (default, direct CLI) or "acp".
	// When "acp", the agent is launched as an ACP subprocess using the Name field.
	Backend *string `json:"backend,omitempty"`

	// Name is the ACP agent name (e.g., "claude", "codex", "gemini").
	// Only used when Backend is "acp". Defaults to "claude".
	Name *string `json:"name,omitempty"`

	// Command overrides the default ACP launch command for the agent.
	// Only used when Backend is "acp". Example: ["npx", "my-custom-acp-agent"].
	Command []string `json:"command,omitempty"`
}

type Config struct {
	Version      int                 `json:"version"`
	IDLength     int                 `json:"id_length"`
	Agent        *AgentConfig        `json:"agent,omitempty"`
	Verification *VerificationConfig `json:"verification,omitempty"`
	Context      *ContextConfig      `json:"context,omitempty"`
	Policy       *PolicyConfig       `json:"policy,omitempty"`
}

type ContextConfig struct {
	// Enabled controls whether context generation runs (default true).
	Enabled *bool `json:"enabled,omitempty"`

	// MaxTokens is the target size for context documents (default 4000).
	MaxTokens *int `json:"max_tokens,omitempty"`

	// AutoRefreshDays is how many days until auto-refresh (default 0 = never).
	AutoRefreshDays *int `json:"auto_refresh_days,omitempty"`

	// GenerationTimeout is the max duration for generation as a string (default "5m").
	GenerationTimeout *string `json:"generation_timeout,omitempty"`

	// GenerationModel overrides the model used for generation (default "" = use default agent).
	GenerationModel *string `json:"generation_model,omitempty"`
}

type PolicyConfig struct {
	// MaxAttempts is the maximum number of attempts per task (default 3).
	// After this many attempts, the task is marked as stuck.
	MaxAttempts *int `json:"max_attempts,omitempty"`

	// MaxNoProgressAttempts is how many consecutive attempts without
	// measurable progress before the task is marked stuck (default 2).
	MaxNoProgressAttempts *int `json:"max_no_progress_attempts,omitempty"`

	// MaxSameVerifierFailures is how many times the same verifier command
	// can fail before the task is escalated (default 2).
	MaxSameVerifierFailures *int `json:"max_same_verifier_failures,omitempty"`

	// RequireCommit controls whether the agent must produce at least one
	// git commit for a task to be considered complete (default false).
	RequireCommit *bool `json:"require_commit,omitempty"`

	// RequireVerifiersForPriority is the minimum priority level (1=highest)
	// at or above which verifier commands must pass for task closure.
	// 0 means disabled (default). Example: 2 means P1 and P2 tasks require
	// passing verifiers.
	RequireVerifiersForPriority *int `json:"require_verifiers_for_priority,omitempty"`

	// Sandbox controls whether agents run in a sandboxed environment
	// (default false). When true, filesystem and network access may be
	// restricted.
	Sandbox *bool `json:"sandbox,omitempty"`

	// AutonomousMode controls whether the run is fully autonomous (default
	// false). When true, a project-checkpoint boundary (a tick whose only
	// reason to be gated is awaiting: checkpoint) no longer halts continuation
	// — the orchestrator flows through the project boundary without waiting for
	// a human. It NEVER bypasses any other awaiting type: approval, input,
	// review, content, escalation, and work always gate.
	AutonomousMode *bool `json:"autonomous_mode,omitempty"`

	// SecretsExposure controls how secrets are made available to agents
	// (default "none"). Valid values: "none", "env", "file".
	SecretsExposure *SecretsExposure `json:"secrets_exposure,omitempty"`
}

type SecretsExposure string

type VerificationConfig struct {
	// Enabled controls whether verification runs (default true).
	Enabled *bool `json:"enabled,omitempty"`
}