import path from 'node:path'; import fs from 'node:fs'; import { Provider } from './provider.mjs'; import { Runtime } from './runtime.mjs'; import { Store, atomicJson, readJson } from './store.mjs'; import { ArtifactStore } from '../core/storage/artifact-store.mjs'; import { ModelHub } from '../core/models/model-hub.mjs'; import { ModelCatalog } from '../core/models/model-catalog.mjs'; import { ConfigImporter } from '../core/models/config-import.mjs'; import { createRequestHandler, createSessionPublisher } from './app.mjs'; import { APP_VERSION } from './diagnostics.mjs'; import { hostAuthority } from '../core/desktop/host-authority.mjs'; import { CredentialVault } from '../core/models/credential-vault.mjs'; import { NetworkDiagnostics } from '../core/models/network-diagnostics.mjs'; // Keep the existing objects and their in-memory connection. No credential is // extracted, transferred, returned, or persisted by this operation. export function installUpgrade(context, { appDirectory, updateServiceInfo = true }) { const { server, store, provider, runtime, token, clients, started, exampleProject, shutdown } = context; if (!server?.listening || !store || !provider || !runtime || !clients || !token) throw new Error('The existing Workbench context is incomplete.'); if (server.workbenchHostAuthority?.stopping) throw new Error('Wait for the original host stop operation before upgrading.'); if (server.workbenchCompanion?.server || server.workbenchCompanion?.busy) throw new Error('Close the mobile companion gateway before upgrading; original tasks remain on the host.'); if (server.workbenchHostAuthority?.desktopWindows?.().count) throw new Error('Close the registered desktop windows before upgrading; the execution host remains running.'); if (runtime.filePreviews?.active.size || runtime.filePreviews?.pending) throw new Error('Close local HTML previews before upgrading.'); if (runtime.browsing?.active.size || runtime.previews?.active.size || runtime.evaluations?.active.size || runtime.environments?.active.size || runtime.active.size || runtime.waiters.size || runtime.workers?.active.size || runtime.controlledEngines?.drivers.size || runtime.mcp?.active.size || runtime.checks?.active.size || runtime.deliveries?.active.size || runtime.changeSets?.projects.size || runtime.workspaces?.projects.size || runtime.workspaces?.pending.size || runtime.research?.active.size || runtime.engines?.active.size || runtime.browser?.active.size || runtime.taskPlans?.active.size) throw new Error('Wait for active evaluations, environments, tasks, workers, controlled engines, MCP operations, checks, Git deliveries, file batches, workspaces, research, engines, browsers, task plans and approvals to finish before upgrading.'); if (provider.activeRequests || provider.hub?.waiting || [...(provider.hub?.leases.values() ?? [])].some(count => count > 0)) throw new Error('Wait for active model requests and probes before upgrading.'); if (provider.hub?.networkChecks?.active.size) throw new Error('Wait for active connection diagnostics before upgrading.'); if (provider.hub?.catalog?.active.size || provider.hub?.probing) throw new Error('Wait for active model catalogs and probes before upgrading.'); const root = fs.realpathSync.native(path.resolve(appDirectory)); if (!fs.existsSync(path.join(root, 'dist-client', 'index.html'))) throw new Error('The new client bundle is missing.'); const oldHandlers = server.listeners('request'); const oldCompanion = server.workbenchCompanion; const oldAuthority = server.workbenchHostAuthority, oldAuthorityProperties = oldAuthority ? { ...oldAuthority } : null; const oldAuthorityPrototype = oldAuthority ? Object.getPrototypeOf(oldAuthority) : null; const oldPrototypes = [Object.getPrototypeOf(store), Object.getPrototypeOf(provider), Object.getPrototypeOf(runtime)]; const oldModelPrototypes = { hub: provider.hub ? Object.getPrototypeOf(provider.hub) : null, importer: provider.hub?.importer ? Object.getPrototypeOf(provider.hub.importer) : null, vault: provider.hub?.credentialVault ? Object.getPrototypeOf(provider.hub.credentialVault) : null, network: provider.hub?.networkChecks ? Object.getPrototypeOf(provider.hub.networkChecks) : null, catalog: provider.hub?.catalog ? Object.getPrototypeOf(provider.hub.catalog) : null }; const oldStoreProperties = { ...store }; const oldRuntimeProperties = { filePreviews: runtime.filePreviews, browsing: runtime.browsing, previews: runtime.previews, evaluations:runtime.evaluations, environments: runtime.environments, appDirectory: runtime.appDirectory, workers: runtime.workers, controlledEngines: runtime.controlledEngines, checks: runtime.checks, deliveries: runtime.deliveries, codeIndex: runtime.codeIndex, changeSets: runtime.changeSets, contextPlans: runtime.contextPlans, workspaces: runtime.workspaces, research: runtime.research, engines: runtime.engines, browser: runtime.browser, taskPlans: runtime.taskPlans, projectMemories: runtime.projectMemories, taskCheckpoints: runtime.taskCheckpoints, skills: runtime.skills, mcp: runtime.mcp }; const oldUpdates = store.listeners('update'); const oldInputs = runtime.inputs; const oldResumes = runtime.resumes; const closeStorage = () => store.close(); if (oldUpdates.length > 1) throw new Error('Unexpected Store observers; preserve their ownership before upgrading.'); const handler = createRequestHandler({ appDirectory: root, server, store, provider, runtime, token, clients, started, exampleProject, shutdown, getPort: () => server.address().port }); try { Object.setPrototypeOf(store, Store.prototype); Object.setPrototypeOf(provider, Provider.prototype); Object.setPrototypeOf(runtime, Runtime.prototype); if (provider.hub) { Object.setPrototypeOf(provider.hub, ModelHub.prototype); if (provider.hub.importer) Object.setPrototypeOf(provider.hub.importer, ConfigImporter.prototype); if (provider.hub.credentialVault) Object.setPrototypeOf(provider.hub.credentialVault, CredentialVault.prototype); if (provider.hub.networkChecks) Object.setPrototypeOf(provider.hub.networkChecks, NetworkDiagnostics.prototype); if (provider.hub.catalog) Object.setPrototypeOf(provider.hub.catalog, ModelCatalog.prototype); } runtime.filePreviews = null; runtime.appDirectory = root; runtime.previews = null; runtime.browsing = null; runtime.evaluations = null; runtime.environments = null; runtime.workers = null; runtime.controlledEngines = null; runtime.checks = null; runtime.deliveries = null; runtime.codeIndex = null; runtime.changeSets = null; runtime.contextPlans = null; runtime.workspaces = null; runtime.research = null; runtime.engines = null; runtime.browser = null; runtime.taskPlans = null; runtime.projectMemories = null; runtime.taskCheckpoints = null; runtime.skills = null; runtime.mcp = null; delete server.workbenchCompanion; runtime.inputs = null; runtime.results = null; runtime.resumes = null; store.ensureStorage(); // A SQLite host can retain an artifact object from an earlier bundle. // Reopen the same blobs through the new API without mutating that object; // oldStoreProperties restores it if installing this handler fails. store.artifactStore = new ArtifactStore(store.directory); store.claimRuntime(); store.removeAllListeners('update'); store.on('update', createSessionPublisher(clients)); server.removeAllListeners('request'); server.on('request', handler); server.prependOnceListener('close', closeStorage); if (updateServiceInfo) { const authority = hostAuthority({ appDirectory: root, server, store, provider, runtime }); authority.initialize(); authority.refreshInstallation(); } void oldRuntimeProperties.filePreviews?.stopAll(); return { version: APP_VERSION, pid: process.pid, hasKey: provider.hasKey(), projects: store.projects.length, sessions: store.sessions.size, appDirectory: root }; } catch (error) { if (oldCompanion) server.workbenchCompanion = oldCompanion; else delete server.workbenchCompanion; if (oldAuthority) { for (const key of Object.keys(oldAuthority)) if (!Object.hasOwn(oldAuthorityProperties, key)) delete oldAuthority[key]; Object.assign(oldAuthority, oldAuthorityProperties); Object.setPrototypeOf(oldAuthority, oldAuthorityPrototype); server.workbenchHostAuthority = oldAuthority; } else delete server.workbenchHostAuthority; server.removeListener('close', closeStorage); if (store.storage && store.storage !== oldStoreProperties.storage) { const filename = store.storage.filename; store.close(); if (path.resolve(filename) !== path.join(path.resolve(oldStoreProperties.directory), 'workbench.sqlite')) throw new Error('Upgrade rollback database path is invalid.'); for (const suffix of ['', '-wal', '-shm']) if (fs.existsSync(filename + suffix)) fs.renameSync(filename + suffix, filename + '.rolledback-' + Date.now() + suffix); } for (const key of Object.keys(store)) if (!Object.hasOwn(oldStoreProperties, key)) delete store[key]; Object.assign(store, oldStoreProperties); Object.assign(runtime, oldRuntimeProperties); if (oldInputs === undefined) delete runtime.inputs; else runtime.inputs = oldInputs; if (oldResumes === undefined) delete runtime.resumes; else runtime.resumes = oldResumes; Object.setPrototypeOf(store, oldPrototypes[0]); Object.setPrototypeOf(provider, oldPrototypes[1]); Object.setPrototypeOf(runtime, oldPrototypes[2]); if (oldModelPrototypes.hub) Object.setPrototypeOf(provider.hub, oldModelPrototypes.hub); if (oldModelPrototypes.importer) Object.setPrototypeOf(provider.hub.importer, oldModelPrototypes.importer); if (oldModelPrototypes.vault) Object.setPrototypeOf(provider.hub.credentialVault, oldModelPrototypes.vault); if (oldModelPrototypes.network) Object.setPrototypeOf(provider.hub.networkChecks, oldModelPrototypes.network); if (oldModelPrototypes.catalog) Object.setPrototypeOf(provider.hub.catalog, oldModelPrototypes.catalog); store.removeAllListeners('update'); for (const observer of oldUpdates) store.on('update', observer); server.removeAllListeners('request'); for (const previous of oldHandlers) server.on('request', previous); throw error; } }