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
	// ManifestPublicKey, when set, enables Ed25519 detached-signature
	// verification on manifest + all fetched repo files. The daemon
	// fetches <url>.sig alongside each resource and verifies before
	// accepting. Nil (default) preserves the pre-verification behavior.
	ManifestPublicKey ed25519.PublicKey
}

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            *ManifestPlugin `json:"plugin,omitempty"`
}

type ModeFlag struct {
	Mode string `json:"mode,omitempty"`
}

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 Removal struct {
	Tool   string      `json:"tool"`
	Kind   FileKind    `json:"kind"`
	Path   string      `json:"path"`
	Action RemovalKind `json:"action"`
	Err    string      `json:"err,omitempty"`
}

type RemovalKind string

type RemovalReport struct {
	At              time.Time `json:"at"`
	Removals        []Removal `json:"removals"`
	ManifestOffline bool      `json:"manifest_offline,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 Service struct {
	// contains filtered or unexported fields
}

type State string

type UpdateConfig struct {
	// Auto controls whether the updater checks for and applies new
	// versions. True (default) = auto-update enabled.
	Auto *bool `json:"auto,omitempty"`
	// Pin locks the updater to a specific release tag (e.g. "v1.10.5").
	// Empty string (default) means no pin — follow latest stable.
	Pin string `json:"pin,omitempty"`
	// Interval is the minimum time between update checks, in Go duration
	// string format ("15m", "1h"). Empty string (default) means use the
	// updater's built-in default check interval.
	Interval string `json:"interval,omitempty"`
}