mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-11-17 04:11:35 +00:00
The merge landed main's `minimize-to-tray` and `hud-modifier-types` modules next to ours, leaving two `perfectionist/sort-imports` errors — the only blocking failures in the `JS & TS checks` job (`apps/desktop :: check:lint`): electron/main.ts:321 ./minimize-to-tray before ./native-auth-decisions src/global.d.ts:6 ../electron/hud-modifier-types before ../electron/machine-profile Resolved with the workspace's own `npm run fix` (eslint --fix + prettier), which also pads the `padding-line-between-statements` warnings it can. Lint is 0 errors after.
135 lines
4.9 KiB
TypeScript
135 lines
4.9 KiB
TypeScript
// install-stamp.ts — the typed build-time install stamp.
|
|
//
|
|
// scripts/write-build-stamp.mjs writes build/install-stamp.json during
|
|
// `npm run build`.
|
|
// bundle-electron-main.mjs bakes that file into the
|
|
// production bundle by defining the __HERMES_INSTALL_STAMP__ global as
|
|
// the stamp. The stamp is a constant of the artifact.
|
|
// It cannot be missing, stale, or edited after signing.
|
|
//
|
|
// Dev bundles and test runs define nothing; the typeof guard makes the
|
|
// stamp null there (a dev run has no artifact to be truthful about).
|
|
|
|
/**
|
|
* The desktop artifact kind — which runtime story this artifact tells:
|
|
* - 'bootstrap': no runtime in the artifact; first launch bootstraps a
|
|
* local install (the default; also what non-desktop stamps carry).
|
|
* - 'bundled': the agent runtime ships inside the artifact resources.
|
|
* - 'light': no runtime at all; remote connections only.
|
|
* Selected at build time by HERMES_DESKTOP_VARIANT (unset = bootstrap).
|
|
*/
|
|
export type ArtifactKind = 'bootstrap' | 'bundled' | 'light'
|
|
|
|
/** Relative paths declared by the PM bundle builder, below agent-payload. */
|
|
export interface PayloadRuntime {
|
|
repoDir: string
|
|
toolsDir: string
|
|
storePython: string
|
|
sitePackages: string
|
|
commands: Record<string, string>
|
|
}
|
|
|
|
/** Immutable admitted channel build. Native names come from R2, never the slug. */
|
|
export interface ChannelBuildRequest {
|
|
schema: 1
|
|
buildId: string
|
|
channel: string
|
|
sequence: number
|
|
repository: string
|
|
commit: string
|
|
controllerCommit?: string
|
|
sourceVersion: string
|
|
/** Build-only official receiver rehearsal, admitted under a disposable authority. */
|
|
receiverCandidate?: true
|
|
releaseTag?: string
|
|
version: string
|
|
windowsVersion: string
|
|
identity: {
|
|
token: string
|
|
displayName: string
|
|
appId: string
|
|
appNamePascal: string
|
|
artifactNamePascal: string
|
|
cliName: string
|
|
windowsExecutableName: string
|
|
msixAppIdWithOrg: string
|
|
}
|
|
bundleEnv: Record<string, string | null>
|
|
publicBase: string
|
|
}
|
|
|
|
/** Mirrors the build stamp with the PM builder's completed launch contract. */
|
|
export interface InstallStamp {
|
|
schemaVersion: number
|
|
commit: string | null
|
|
commitDate: number | null
|
|
branch: string | null
|
|
builtAt: string | null
|
|
dirty: boolean
|
|
/** Build provenance: where the stamp's facts came from. */
|
|
source:
|
|
| 'build'
|
|
| 'commit-build'
|
|
| 'channel-build'
|
|
| 'ci'
|
|
| 'docker'
|
|
| 'fallback'
|
|
| 'git'
|
|
| 'local'
|
|
| 'nix'
|
|
| 'unknown'
|
|
| null
|
|
/** The steward of a sealed tree ('desktop-app' | 'docker' | 'nix'), when packaged. */
|
|
distribution: string | null
|
|
/** Who applies the next update. Required in every stamp. */
|
|
updateMechanism: 'self' | 'app-installer' | 'electron-updater' | 'external' | 'microsoft-store'
|
|
baseVersion: string | null
|
|
displayVersion: string | null
|
|
distance: number | null
|
|
payload: ArtifactKind
|
|
/** Present on bundled artifacts. Validated at build time, never discovered at boot. */
|
|
runtime?: PayloadRuntime
|
|
/** Complete channel inputs, absent on legacy releases and one-off builds. */
|
|
channelBuild?: Readonly<ChannelBuildRequest>
|
|
/** Cross-application receiver shipped in this artifact, absent on older builds. */
|
|
receiverProtocol?: 1
|
|
/** Pinned release tag; null for channel builds, one-offs and bootstrap. */
|
|
tag: string | null
|
|
}
|
|
|
|
declare const __HERMES_INSTALL_STAMP__: InstallStamp
|
|
|
|
/** The baked request is immutable as well as its containing artifact stamp. */
|
|
function freezeStamp(stamp: InstallStamp): Readonly<InstallStamp> {
|
|
if (stamp.channelBuild) {
|
|
Object.freeze(stamp.channelBuild.identity)
|
|
Object.freeze(stamp.channelBuild.bundleEnv)
|
|
Object.freeze(stamp.channelBuild)
|
|
}
|
|
|
|
return Object.freeze(stamp)
|
|
}
|
|
|
|
/** The baked stamp of this artifact, or null on dev bundles. */
|
|
export const INSTALL_STAMP: Readonly<InstallStamp> | null =
|
|
typeof __HERMES_INSTALL_STAMP__ === 'undefined' ? null : freezeStamp(__HERMES_INSTALL_STAMP__)
|
|
|
|
/**
|
|
* The install shape this process runs as — THE single split every
|
|
* lifecycle decision gates on (mirror of Python's runtime_tree()):
|
|
* - 'bundled': the runtime ships inside the artifact. Venv machinery,
|
|
* installers, repair-reinstall escalation and update checkouts must
|
|
* never run; drift means rebuild, updates mean the steward.
|
|
* - 'checkout': a git tree with venv machinery, provisioner-on-demand
|
|
* and `hermes update`.
|
|
*
|
|
* Derived from the stamp CONSTANT, never from filesystem probes: a
|
|
* payload/venv/marker probe answers "is this artifact intact?", not
|
|
* "which shape am I?". PM and the bundle builder own payload integrity.
|
|
* A backend launch failure must not quietly turn a bundle into a checkout. Dev runs
|
|
* (null stamp) and bootstrap artifacts are 'checkout': their runtime
|
|
* is a local install the app bootstraps and maintains.
|
|
*/
|
|
export function installShape(stamp: Readonly<InstallStamp> | null = INSTALL_STAMP): 'bundled' | 'checkout' {
|
|
return stamp?.payload === 'bundled' ? 'bundled' : 'checkout'
|
|
}
|