The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
/**
* "What's in this update" for the updates overlay, read from public GitHub.
*
* Stable channel: the release's own notes (Highlights headlines, else its first
* bullet list). Main: the newest merged PR titles. Both are best-effort; the
* caller keeps the commit changelog when nothing comes back.
*/
const REPOSITORY = 'NousResearch/hermes-agent'
const API = `https://api.github.com/repos/${REPOSITORY}`
const SITE = `https://github.com/${REPOSITORY}`
const MAX_ITEMS = 5
// Recent merges move constantly; re-read them, but not on every dialog open.
const PULLS_TTL_MS = 10 * 60_000
export type UpdateNotesSource = { kind: 'release'; tag: null | string } | { kind: 'prs' }
interface NotesStatus {
branch?: string
channel?: string
commits?: readonly { sha?: string }[]
behind?: null | number
currentSha?: string
latestTag?: null | string
rollback?: boolean
sourceVersion?: string
targetSha?: string
}
interface PullRow {
title?: string
merged_at?: null | string
merge_commit_sha?: null | string
}
/** The release a stable update installs: packaged feeds name a tag, source checks a version. */
export function updateReleaseTag(status: NotesStatus): null | string {
return status.latestTag || (status.channel === 'stable' && status.sourceVersion ? `v${status.sourceVersion}` : null)
}
/** Which notes describe this update; null when neither fits (custom branch, canary, rollback). */
export function updateNotesSource(status: NotesStatus): null | UpdateNotesSource {
if (status.rollback) {
return null
}
if (status.channel === 'stable') {
return { kind: 'release', tag: updateReleaseTag(status) }
}
// A named branch decides on its own; only a branch-less status (packaged feed) goes by channel.
return (status.branch ?? status.channel) === 'main' ? { kind: 'prs' } : null
}
const isSha = (value?: string): value is string => Boolean(value && /^[0-9a-f]{7,40}$/i.test(value))
/** Where "more info" lives: the release page, or the compare view of exactly this update. */
export function updateNotesUrl(source: UpdateNotesSource, status: NotesStatus): string {
if (source.kind === 'release') {
return source.tag ? `${SITE}/releases/tag/${encodeURIComponent(source.tag)}` : `${SITE}/releases/latest`
}
return isSha(status.currentSha) && isSha(status.targetSha)
? `${SITE}/compare/${status.currentSha}...${status.targetSha}`
: `${SITE}/commits/main`
}
// Full text: the dialog clamps the display and keeps the whole item for hover.
function plain(markdown: string): string {
return markdown
.replace(/\s+/g, ' ')
.trim()
.replace(/!?\[([^\]]*)\]\([^)]*\)/g, '$1')
.replace(/\*\*|__|`/g, '')
.replace(/\s*\([^()]*#\d+[^()]*\)\s*$/, '')
.replace(/[\s.:;,]+$/, '')
}
// How-to-install and credits sections are not "what changed".
const SKIPPED_SECTION = /updating|upgrad|install|contributor|changelog/i
/** Up to five headlines: the Highlights section's bullets, else the body's first change list. */
export function extractReleaseHighlights(body: string, max = MAX_ITEMS): string[] {
const lines = body.split(/\r?\n/)
const start = lines.findIndex(line => /^#{1,6}\s.*highlights/i.test(line))
const items: string[] = []
let skipped = false
for (const line of start >= 0 ? lines.slice(start + 1) : lines) {
const heading = /^#{1,6}\s+(.*)$/.exec(line)
if (heading) {
if (start >= 0 || items.length > 0) {
break
}
skipped = SKIPPED_SECTION.test(heading[1])
continue
}
const bullet = skipped ? null : /^[-*]\s+(.+)$/.exec(line)
if (!bullet) {
continue
}
// A bold lead-in is the item's own headline; the prose after it is detail.
const text = plain(/^\*\*(.+?)\*\*/.exec(bullet[1])?.[1] ?? bullet[1])
if (text && items.push(text) >= max) {
break
}
}
return items
}
/**
* The newest merged PRs. A complete commit list pins them to this update exactly
* (a merged PR's merge_commit_sha is a commit on main); otherwise the newest
* merges stand in for it.
*/
export function latestMergedPrTitles(
pulls: readonly PullRow[],
commits: readonly { sha?: string }[],
behind: null | number | undefined,
max = MAX_ITEMS
): string[] {
const shas = commits.map(commit => commit.sha).filter(isSha)
const complete = shas.length > 0 && behind === shas.length
return pulls
.filter(pull => pull.merged_at && pull.title?.trim())
.filter(pull => !complete || shas.some(sha => pull.merge_commit_sha?.startsWith(sha)))
.sort((a, b) => String(b.merged_at).localeCompare(String(a.merged_at)))
.slice(0, max)
.map(pull => (pull.title ?? '').replace(/\s+/g, ' ').trim())
}
async function getJson(url: string): Promise<unknown> {
const response = await fetch(url, {
headers: { Accept: 'application/vnd.github+json' },
signal: AbortSignal.timeout(8000)
})
if (!response.ok) {
throw new Error(`GitHub answered ${response.status} for ${url}`)
}
return response.json()
}
const releases = new Map<string, Promise<string[]>>()
let pulls: null | { at: number; rows: Promise<readonly PullRow[]> } = null
function recentPulls(): Promise<readonly PullRow[]> {
if (!pulls || Date.now() - pulls.at > PULLS_TTL_MS) {
// Recently updated closed PRs hold the newest merges; one request, no auth.
const rows = getJson(`${API}/pulls?state=closed&base=main&sort=updated&direction=desc&per_page=100`).then(
(json): readonly PullRow[] => (Array.isArray(json) ? json : [])
)
pulls = { at: Date.now(), rows }
rows.catch(() => {
pulls = null
})
}
return pulls.rows
}
function releaseHighlights(tag: null | string): Promise<string[]> {
const key = tag ?? 'latest'
const cached = releases.get(key)
if (cached) {
return cached
}
const pending = getJson(tag ? `${API}/releases/tags/${encodeURIComponent(tag)}` : `${API}/releases/latest`).then(
release => extractReleaseHighlights(String((release as { body?: unknown })?.body ?? ''))
)
releases.set(key, pending)
pending.catch(() => releases.delete(key))
return pending
}
/** The notes' items; [] when GitHub is unreachable or has none. Merged PRs are filtered per status. */
export function fetchUpdateNoteItems(source: UpdateNotesSource, status: NotesStatus): Promise<string[]> {
const items =
source.kind === 'release'
? releaseHighlights(source.tag)
: recentPulls().then(rows => latestMergedPrTitles(rows, status.commits ?? [], status.behind))
return items.catch(() => [])
}