skillinject

type Action string

type Config struct {
	// Home overrides the user home dir (test hook).
	Home string
	// Interval between scan ticks after the initial startup tick.
	Interval time.Duration
	// ManifestURL overrides the canonical raw GitHub URL for inject-manifest.json.
	ManifestURL string
	// RepoBaseURL overrides the prefix used to resolve relative paths in
	// the manifest (skills/<name>/SKILL.md, heartbeats/<tool>.md).
	RepoBaseURL string
	// HTTPClient overrides the HTTP client used for fetching.
	HTTPClient *http.Client
}

type EnabledFlag struct {
	Enabled bool `json:"enabled"`
}

type FileKind string

type Manifest struct {
	Version     int              `json:"version"`
	Entrypoint  string           `json:"entrypoint"`
	Description string           `json:"description,omitempty"`
	Tools       []ManifestTool   `json:"tools"`
	Helpers     []ManifestHelper `json:"helpers,omitempty"`
}

type ManifestHelper struct {
	Name string `json:"name"`
	// Src is a repo-relative path fetched via fetchRepoFile, e.g.
	// "workflow-injection/pilot-ask".
	Src string `json:"src"`
	// Dst is the absolute install target. Supports ~/ expansion, e.g.
	// "~/.pilot/bin/pilot-ask".
	Dst string `json:"dst"`
	// Mode is the file mode in octal string form, e.g. "0755". Empty
	// defaults to 0755 (helpers are executables).
	Mode string `json:"mode,omitempty"`
}

type ManifestPlugin struct {
	// ID matches openclaw.plugin.json's "id" field. Used as the
	// allow-list key + directory name.
	ID string `json:"id"`
	// InstallPath is where the plugin directory is written
	// (e.g. "~/.openclaw/extensions/pilotprotocol-prompt-injector").
	InstallPath string `json:"installPath"`
	// Files lists the plugin source files the daemon copies in.
	// Order doesn't matter — each file is reconciled independently.
	Files []ManifestPluginFile `json:"files"`
	// AllowList, if set, tells the daemon to ensure the plugin id
	// appears in the tool's plugin allow-list + entries map. Nil
	// disables the JSON-merge step (e.g. for tools without an
	// explicit allow-list concept).
	AllowList *ManifestPluginAllowList `json:"allowList,omitempty"`
}

type ManifestPluginAllowList struct {
	// ConfigPath is the JSON file the daemon merges into
	// (e.g. "~/.openclaw/openclaw.json").
	ConfigPath string `json:"configPath"`
	// AllowListJsonPath is a dotted path to the trust array. Created
	// if absent. Daemon appends the plugin id iff not already present.
	AllowListJsonPath string `json:"allowListJsonPath"`
	// EntriesJsonPath is a dotted path to the per-plugin entries
	// object (e.g. "plugins.entries"). The daemon ensures
	// `entries.<id>.enabled` is `true`.
	EntriesJsonPath string `json:"entriesJsonPath"`
}

type ManifestPluginFile struct {
	// Name is the filename relative to InstallPath (e.g.
	// "openclaw.plugin.json", "index.mjs").
	Name string `json:"name"`
	// Src is a repo-relative path fetched via fetchRepoFile
	// (e.g. "workflow-injection/openclaw-plugin/index.mjs").
	Src string `json:"src"`
}

type ManifestTool struct {
	Name              string `json:"name"`
	RootDir           string `json:"rootDir"`
	SkillsDir         string `json:"skillsDir"`
	HeartbeatPath     string `json:"heartbeatPath,omitempty"`
	HeartbeatTemplate string `json:"heartbeatTemplate,omitempty"`
	SkillNaming       string `json:"skillNaming,omitempty"` // "" = "directory" (default), "flat" = single-file
	SelfHeartbeat     bool   `json:"selfHeartbeat,omitempty"`
	// Plugin is the single-plugin slot. Kept for backwards compat with
	// pre-multi-plugin manifests. Prefer Plugins for new entries.
	Plugin *ManifestPlugin `json:"plugin,omitempty"`
	// Plugins is the multi-plugin slot — one tool can install N plugins
	// (e.g. openclaw gets both pilotprotocol-prompt-injector and
	// pilotprotocol-webhook-receiver). Each entry reconciles identically
	// to a single Plugin block. If both Plugin and Plugins are set, the
	// daemon reconciles Plugin first then iterates Plugins.
	Plugins []ManifestPlugin `json:"plugins,omitempty"`
	// WebhookRoutes is the per-tool list of routes the daemon merges
	// into a YAML config (today hermes — see ManifestWebhookRoute). One
	// tool can declare any number; each reconciles independently.
	WebhookRoutes []ManifestWebhookRoute `json:"webhookRoutes,omitempty"`
	// WebhookURL, if set, tells the daemon to write this URL into
	// ~/.pilot/webhook_url so its webhook plugin POSTs events to the
	// tool's receiver. Set per-tool with the canonical default port and
	// path (e.g. openclaw → http://127.0.0.1:18789/pilot-webhook).
	// When multiple tools declare a URL, the daemon picks the first one
	// whose RootDir exists on disk — manifest order is the tiebreaker.
	// Operators wanting multi-tool delivery can run pilotctl set-webhook
	// explicitly.
	WebhookURL string `json:"webhookURL,omitempty"`
}

type ManifestWebhookRoute struct {
	// ConfigPath is the YAML file the daemon merges into
	// (e.g. "~/.hermes/config.yaml").
	ConfigPath string `json:"configPath"`
	// RoutesYamlPath is the dotted path to the routes map. Created if
	// absent; intermediate maps are materialized.
	// e.g. "platforms.webhook.extra.routes".
	RoutesYamlPath string `json:"routesYamlPath"`
	// RouteName is the key under RoutesYamlPath where our entry goes
	// (e.g. "pilot-events"). The daemon owns this key.
	RouteName string `json:"routeName"`
	// Route is the YAML body to assign at RoutesYamlPath.RouteName.
	// Free-form so future schema additions don't require a Go change —
	// the daemon passes it through verbatim.
	Route map[string]interface{} `json:"route"`
}

type Outcome struct {
	Tool   string   `json:"tool"`
	Kind   FileKind `json:"kind"`
	Path   string   `json:"path"`
	State  State    `json:"state"`
	Action Action   `json:"action"`
	Hash   string   `json:"hash,omitempty"`
	Err    string   `json:"err,omitempty"`
}

type Report struct {
	At       time.Time `json:"at"`
	Outcomes []Outcome `json:"outcomes"`
	Skipped  []string  `json:"skipped,omitempty"`
	// Disabled is true if the tick was a no-op because the user has
	// `pilotctl skills disable`'d injection.
	Disabled bool `json:"disabled,omitempty"`
}

type State string