hooks

type Action struct {
	ID      string `yaml:"id"`      // stable identifier, unique within the plugin
	Label   string `yaml:"label"`   // human-facing label; defaults to ID if empty
	Command string `yaml:"command"` // script path, relative to the plugin dir
}

type Host struct {
	// Name is what the user sees — the inventory's name for the machine.
	Name string `json:"name"`
	// Target is the SSH destination to record as the placement. Empty means
	// "same as Name", which is what an inventory without an ssh field implies.
	Target string `json:"target"`
	// WorkDir is the project's checkout on that host, which a placement needs
	// and a user should not have to look up.
	WorkDir string `json:"workdir"`
	// Detail is an optional one-liner shown beside the name (why this host is a
	// candidate, what it is provisioned for).
	Detail string `json:"detail"`
}

type InstallRequest struct {
	// ID is the catalog entry ID, when the install came from the catalog.
	ID string
	// Source is the git URL or local path to clone.
	Source string
	// Subdir is the plugin's path inside Source. When set, only that
	// subdirectory is installed, so a user can take one plugin out of a
	// collection instead of all of them.
	Subdir string
	// Name overrides the directory name to install under.
	Name string
	// Entry is the catalog entry this request came from, for display.
	Entry *registry.Entry
}

type InstallResult struct {
	// Dir is the installed directory.
	Dir string
	// Name is that directory's base name.
	Name string
	// Plugins are the manifest names that became active.
	Plugins []string
	// Updated is true when an existing install was refreshed rather than created.
	Updated bool
}

type InstalledSource struct {
	// ID is the catalog entry this came from, when it was installed by ID.
	ID string `json:"id,omitempty"`
	// Source is the git URL (or local path) it was cloned from.
	Source string `json:"source"`
	// Subdir is the path inside Source that was copied out, if any.
	Subdir string `json:"subdir,omitempty"`
	// InstalledAt is an RFC3339 timestamp of the last install or update.
	InstalledAt string `json:"installed_at,omitempty"`
}

type Placement struct {
	// Target names the host to run on. Empty means local.
	Target      string `json:"target"`
	Unavailable bool   `json:"unavailable,omitempty"`
	// WorkDir is the task's directory ON THAT HOST. It is a remote path, so a
	// leading "~" is left alone for the remote shell to expand.
	WorkDir string `json:"workdir"`
	// Reason explains the choice in the user's words. Always surfaced, so that a
	// surprising placement can be understood without digging.
	Reason string `json:"reason"`

	// Handler is the plugin that answered, or "" when no handler is installed.
	// Not part of the wire contract — ty fills it in.
	Handler string `json:"-"`
}

type PlacementTaskInfo struct {
	ID             int64  `json:"id"`
	Title          string `json:"title"`
	Project        string `json:"project"`
	RepoPath       string `json:"repo_path"`
	Executor       string `json:"executor"`
	RemoteRequired bool   `json:"remote_required,omitempty"`
}

type Plugin struct {
	Name        string `yaml:"name"`
	Version     string `yaml:"version"`
	Description string `yaml:"description"`
	// Hooks maps a task event name (e.g. "task.done") to a script path,
	// resolved relative to the plugin directory. Hooks fire automatically.
	Hooks map[string]string `yaml:"hooks"`
	// Actions are user-invoked commands (from `ty plugins run`, the detail-view
	// picker, or the command palette), each backed by a script in the plugin dir.
	Actions []Action `yaml:"actions"`
	// Services are long-running processes the daemon supervises for the plugin's
	// lifetime — a sidecar/service an extension used to run on its own (e.g. an MCP
	// proxy, a sync loop). Started when the daemon comes up, stopped when it exits.
	Services []Service `yaml:"services"`

	// Dir is the absolute path to the plugin directory (not from the manifest).
	Dir string `yaml:"-"`
	// Workflows holds the names (filename stems) of the workflow definitions this
	// plugin ships in its workflows/ subdir. Discovered by convention at load time,
	// not declared in the manifest — a plugin is workflow cargo the moment it has a
	// workflows/*.yaml. Populated for display; the definitions themselves are loaded
	// by the pipeline registry via PluginWorkflowDirs.
	Workflows []string `yaml:"-"`
	// Routines holds the names of the routine definitions this plugin ships in its
	// routines/ subdir (each a <name>/prompt.md). Discovered by convention, like
	// workflows. Populated for display; the routine package resolves the definitions
	// via PluginRoutineDirs. A routine is the right home for a plugin's periodic job
	// (a poller, a digest): the daemon-supervised alternative, a service, is for
	// processes that must stay up, not run-to-completion on a schedule.
	Routines []string `yaml:"-"`
}

type RouteDecision struct {
	// Plugin is the name of the plugin that answered, for logging.
	Plugin string
	// ClaudeConfigDir routes the task to a particular Claude profile. Empty
	// leaves the task's existing (project or per-task) config dir alone.
	ClaudeConfigDir string
	// Hold asks the caller not to start this task yet — every candidate profile
	// is out of headroom, and running now would only burn a session on a 429.
	// The task stays queued and is reconsidered on the next tick.
	Hold bool
	// Reason explains a Hold (or annotates a routing choice) for the task log.
	Reason string
}

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

type Service struct {
	Name    string   `yaml:"name"`    // stable label, unique within the plugin
	Command string   `yaml:"command"` // shell command to run (sh -c); the long-running process
	Cwd     string   `yaml:"cwd"`     // working dir relative to the plugin dir ("" = the plugin dir)
	Env     []string `yaml:"env"`     // extra KEY=VALUE env entries for the process
}

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