agent

type Adapter interface {
	// Name is the stable identifier used in tool calls ("claude", "cursor").
	Name() string

	// Available reports whether the agent looks usable on this machine, with a
	// human-readable detail (resolved binary path or the reason it is missing).
	Available() (ok bool, detail string)

	// Command builds the exec.Cmd for a run. It must NOT set Dir or Env; the
	// task manager owns those. Env is inherited from the server process, so
	// whatever the host machine can reach (VPN routes, SSH agent, credentials)
	// is available to the child with no extra wiring.
	Command(ctx context.Context, spec RunSpec) (*exec.Cmd, error)

	// ParseLine interprets one line of stdout.
	ParseLine(line string) Event
}

type AdapterDiag struct {
	Name      string `json:"name"`
	Available bool   `json:"available"`
	Detail    string `json:"detail"`
	Launcher  string `json:"launcher,omitempty"` // what PATH resolution found
	RunsAs    string `json:"runs_as,omitempty"`  // what we would actually execute
	ShimFixed bool   `json:"shim_resolved,omitempty"`
}

type ClaudeAdapter struct {
	Bin             string   // launcher; defaults handled by caller ("claude")
	PermissionMode  string   // --permission-mode value
	AllowedTools    string   // --allowedTools value (patterns, e.g. "Bash(git *),Edit")
	DisallowedTools string   // --disallowedTools value
	AppendPrompt    string   // --append-system-prompt value (standing guidance)
	ExtraArgs       []string // appended verbatim
}

type CursorAdapter struct {
	Bin       string   // fallback launcher when detection fails ("cursor-agent")
	ExtraArgs []string // appended verbatim
	// contains filtered or unexported fields
}

type CustomAdapter struct {
	Bin          string
	ArgsTemplate []string
	// contains filtered or unexported fields
}

type DiagnosticReport struct {
	OS            string        `json:"os"`
	Arch          string        `json:"arch"`
	Executable    string        `json:"executable"`
	Packaged      bool          `json:"packaged_app"`
	PackageName   string        `json:"package_name,omitempty"`
	SpawnProbes   []SpawnProbe  `json:"spawn_probes"`
	Adapters      []AdapterDiag `json:"adapters"`
	EnvRepaired   []string      `json:"env_repaired,omitempty"`
	Notes         []string      `json:"notes,omitempty"`
	SpawnWorks    bool          `json:"spawn_works"`
	SilentFailure bool          `json:"silent_failure_detected"`

	// InteractivePermission says whether a worker can put a permission request
	// to the person driving this client, and when it cannot, why. It belongs
	// here because the symptom of it being off is a task that quietly does less
	// than it was asked to, with nothing in the transcript pointing at the cause.
	InteractivePermission bool   `json:"interactive_permission"`
	PermissionDetail      string `json:"interactive_permission_detail,omitempty"`
}

type Event struct {
	Raw        string // the original line, always kept
	SessionID  string // non-empty when this line revealed the session id
	Text       string // human-facing text extracted from this line, if any
	Final      bool   // true when this is the terminal result event
	FinalError bool   // for a final event: whether the run reported an error
	FinalText  string // for a final event: the summarized result text
	ToolName   string // when the worker invoked a tool, its name (for the audit trail)
	ToolInput  string // the tool's input, compact JSON, truncated (for the audit trail)

	IsToolResult    bool // this line is a tool's result coming back
	ToolResultError bool // for a tool result: whether the tool reported failure

	// Model is the model the agent reported it is actually using, which is the
	// only way to learn it when no override was requested.
	Model string

	// Usage is non-nil on a line that carried accounting.
	Usage *Usage
}

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

type PlanCapable interface {
	SupportsPlanOnly() bool
}

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

type ResultFromOutput interface {
	UseOutputAsResult() bool
}

type RunSpec struct {
	Prompt       string   // the instruction/task text
	Cwd          string   // working directory for the child process
	Model        string   // optional model override
	SessionID    string   // when set, resume this session instead of starting fresh
	ExtraArgs    []string // extra flags appended verbatim
	AllowedTools []string // per-run tools to pre-approve (merged with server policy)
	PlanOnly     bool     // propose a plan without executing anything

	// MaxCostUSD, when > 0, is what this ONE turn may spend. The manager passes
	// the budget the task has left rather than the configured total, so a task
	// driven through several turns cannot be handed the whole allowance again on
	// each of them.
	MaxCostUSD float64

	// MCPConfigPath and PermissionTool wire the agent to an approval endpoint,
	// so a tool call it would otherwise stall on becomes a question asked of
	// the human upstream. Both are set together or not at all.
	MCPConfigPath  string
	PermissionTool string
}

type SpawnProbe struct {
	Name     string `json:"name"`
	Command  string `json:"command"`
	OK       bool   `json:"ok"`
	ExitCode int    `json:"exit_code"`
	Output   string `json:"output,omitempty"`
	Err      string `json:"error,omitempty"`
	Silent   bool   `json:"silent,omitempty"` // failed AND produced no output at all
}

type Usage struct {
	CostUSD          float64 `json:"cost_usd,omitempty"`
	DurationMS       int64   `json:"duration_ms,omitempty"`
	APIDurationMS    int64   `json:"api_duration_ms,omitempty"`
	NumTurns         int     `json:"num_turns,omitempty"`
	InputTokens      int     `json:"input_tokens,omitempty"`
	OutputTokens     int     `json:"output_tokens,omitempty"`
	CacheReadTokens  int     `json:"cache_read_tokens,omitempty"`
	CacheWriteTokens int     `json:"cache_write_tokens,omitempty"`
}