internal/

Package httpapi is the HTTP adapter over app.App, mounted on the webhook listener's loopback server, which also hosts the optional pprof handler (ADR pprof-debug-endpoint).

Package mcpsrv is the agent-facing MCP adapter over app.App: the desktop's capabilities as MCP tools, served over Streamable HTTP on the same loopback server that hosts the webhook listener (ADR agent-http-api).

Package wailsui is the Wails driving adapter: the service structs the frontend calls over RPC, the native shell (window, tray, updater, notifications), and the event signals it emits.

Package actions implements the desktop pipeline's actions.yml schema: the output/action layer a flow's terminal `action` node targets (see cmd/desktop/internal/app/flow's ActionConfig) and the source for the desktop detail pane's action buttons.

Package activity is the desktop app's user-facing audit log.

Package agentws owns the on-disk agent-workspace root: the directory tree holding mcps.yaml, .shared/, and one directory per workspace (spec §4).

Package canvas renders canvas documents for the desktop: the html sanitizer the pane and the export run through, and the markdown export.

Package configmigrate upgrades an older on-disk config document to the version the running build expects, forward-only and one step per version.

Package queries is the desktop app's dedicated SQLite store: the event log (event_log/consumer_offset), durable inbox substrate (inbox_item/inbox_event), feed membership claims, output commands, activity events and jobs, and per-node run metrics.

Package dirwatch runs a debounced callback when matching files in a directory change.

Package events is the core's typed publish/subscribe bus.

Package flow implements the flows/*.yaml config schema for the desktop pipeline's Node-RED-style graph: a strict decoder, a per-node-type registry, cross-file reference validation, and directory loaders.

Package fonts enumerates the font families installed on this machine so the app's chrome and its terminals can be pointed at one of them.

Package hiveconf reads the hive config file the `hive` binary shares.

Package hivewatch observes hive.db state that another process writes.

Package icons holds the curated glyph set feed rows and sidebar entries draw from.

Package ingest is the pipeline's producer side: the poll loop that turns configured source connectors into event_log rows, and the resolver that turns the current flow set into the connector instances it drives.

Package jobs is the desktop app's live action-run lifecycle.

Package mcpcatalog is the shipped MCP server catalogue: the vocabulary one entry is declared in (Stability, Transport, Server, Descriptor) and the registry that holds every entry.

Package perf records UI performance spans to a size-capped JSONL file for offline analysis.

Package procstats samples what this install is costing the machine: the desktop process, the processes it parents (a terminal's shell, an agent), and the Go runtime's own view of itself.

Package profileimg stores a profile's (flow's) avatar as a normalized square PNG under the app data dir — one file per flow id.

Package prompts owns every paste-ready LLM prompt Hive Desktop offers, and the templates they are composed from.

Package ptyterm runs ephemeral terminals: this process owns a PTY and the process on the far end of it, with no terminal multiplexer in between.

Package report builds the two halves of a bug report, which are deliberately not one artifact.

Package runtime is the flow engine: it executes one flow over one batch of event-log messages and produces the CommitBatch that batch is worth.

Package js implements the engine's ScriptRuntime port with goja, a pure-Go ECMAScript interpreter.

Package schedule launches recurring agent chats.

Package settings resolves the desktop app's typed settings and on-disk locations.

Package skills renders Hive Desktop's paste-ready prompts in the Agent Skills format: a SKILL.md with YAML frontmatter (name, description) over the prompt text.

Package slug is the id rule the flow and action schemas share.

Package sourcemark stores a source node's custom feed mark as a normalized square PNG under the app data dir, content-addressed by hash.

Package sources is the source connector registry: the one place every connector type is declared, and the lookups the rest of the app resolves a connector through.

Package bindingstore persists each connected account's non-secret binding — the host, stack, or project a credential was connected to — keyed by credential ref.

Package canonical is the item contract a connector uses when its payload is the canonical item shape itself (ADR canonical-item-contract) rather than a provider's own: the top-level `state` vocabulary, the classifier that maps it to lifecycle, and the rewrite an authoritative snapshot mints for an item that left it.

Package connector is the vocabulary a source connector is declared in: the Descriptor that describes one, the Config it parses, and the Instance the app constructs per use.

Package exec is the command source connector: it runs the user's own command on the poll tick and ingests its stdout as an authoritative snapshot, so a CLI is a first-party source with no external scheduler, no webhook bridge, and no hand-rolled state file.

Package gitea is the Gitea source connector: the config a gitea source node carries, the descriptor declaring what the connector supports, and the instance the producer drains on a tick.

Package giteaclient is the desktop's Gitea/Forgejo REST client: token validation, the issue/PR search, the notification inbox, and the single-issue lookup absence confirmation needs.

Package github is the GitHub source connector: the config a github source node carries, the descriptor declaring what the connector supports, and the instance the producer drains on a tick.

Package feed is the desktop's GitHub fetch layer: the wire Item type and a cached, coalesced LiveProvider the pipeline producer uses to turn a source into event_log rows.

Package ghclient is the desktop's own GitHub REST/GraphQL client: in-app authentication (OAuth device flow, PAT validation via User) and the typed API calls the connector needs (batched search, notifications, single-issue hydration).

Package grafana is the Grafana source connector: the metrics and alerts source nodes and the stack auth that connects a stack.

Package client is the desktop's Grafana HTTP client: token validation, a PromQL query through the datasource proxy, the firing-alerts list, and the IRM/OnCall alert groups.

Package itemtext derives the session text an inbox item suggests: the branch name a session on it would use, and the default prompt the launch dialog opens with.

Package posthog is the PostHog source connector: the error-tracking and insight-alert source nodes and the project auth that connects a project.

Package client is the desktop's PostHog HTTP client: project listing (which doubles as token validation), the error-tracking issue query, and the insight-alert list.

Package rss is the feed source connector: it fetches one RSS, Atom, or JSON Feed URL on the poll tick and ingests its entries as items, so a blog, a release feed, or a status page is a first-party source with no bridge in between.

Package sourcehttp is the HTTP toolkit a pull connector's API client is built over: the failure taxonomy, status and rate-limit mapping, conditional requests, and a logging transport.

Package webhook is the webhook source connector: the config a webhook source node carries, the descriptor declaring what the connector supports, and the local HTTP listener deliveries arrive on.

Package telemetry configures the OpenTelemetry and Pyroscope SDKs, registers the OTel providers globally, and owns their shutdown (ADR continuous-profiles-are-pushed-directly-with-pyroscope).