@capybara-hq/kernel 0.1.0-rc.1 → 0.1.0-rc.2

package/dist/catalog/plugin-upgrade.d.ts

@@ -1,10 +1,20 @@
 import type { AgentTemplate, ConnectorTemplateFile, PluginManifest } from "@capybara-hq/plugin-sdk";
 import type { SourceFormat } from "../db/kernel-schema.js";
+import { OrgExtensionConfigs } from "../extensions/org-config.js";
+import { ExtensionRegistry } from "../extensions/registry.js";
+import { KernelDb } from "../infra/database/kernel-db.js";
+import { TransactionHost } from "../infra/database/transaction-host.js";
+import type { KernelLogger } from "../log.js";
+import { OrgLock } from "../orgs/org-lock.js";
 import type { OrgAction } from "../orgs/roles.js";
+import { SkillsService } from "../skills/skills.service.js";
+import { StorageService } from "../storage/storage.service.js";
 import type { CreateConnectorInput, TemplateUpdateInput } from "../tools/connectors.service.js";
+import { ConnectorsService } from "../tools/connectors.service.js";
 import type { ConnectorAuth } from "../tools/credentials.js";
-import { type CatalogVersionFiles, type OrgCatalogTemplate } from "./org-catalog.service.js";
-import { type ComponentKind, type InstallPlan, type PluginInstaller, type PluginInstallInput, type PluginInstallView, type ResolvedDependency } from "./plugin-install.js";
+import { type CatalogVersionFiles, type OrgCatalogTemplate } from "./catalog-content.js";
+import { type ComponentKind, type InstallPlan, PluginInstaller, type PluginInstallInput, type PluginInstallView, type ResolvedDependency } from "./plugin-install.js";
+import { CatalogRequestsService } from "./requests.service.js";
 /** How a component differs between the installed and the target version. */
 export type UpgradeChange = "added" | "changed" | "removed" | "unchanged";
 /**
@@ -158,11 +168,33 @@ export interface UpgradeDiff {
  * state.
  */
 export declare class PluginUpgrader {
+    /** Planning, installs, the ledger and the uninstall rules are the installer's. */
     private readonly installer;
-    private readonly d;
-    constructor(installer: PluginInstaller);
+    private readonly kdb;
+    /** The org row lock (orgs/org-lock.ts): joins the caller's transaction. */
+    private readonly orgLock;
+    private readonly storage;
+    private readonly registry;
+    private readonly skills;
+    private readonly orgConfigs;
+    private readonly requests;
+    /** Org connectors: installs create, upgrade and remove them. */
+    private readonly connectors;
+    private readonly log;
+    readonly txHost: TransactionHost;
+    constructor(
+    /** Planning, installs, the ledger and the uninstall rules are the installer's. */
+    installer: PluginInstaller, kdb: KernelDb, 
+    /** The org row lock (orgs/org-lock.ts): joins the caller's transaction. */
+    orgLock: OrgLock, storage: StorageService, registry: ExtensionRegistry, skills: SkillsService, orgConfigs: OrgExtensionConfigs, requests: CatalogRequestsService, 
+    /** Org connectors: installs create, upgrade and remove them. */
+    connectors: ConnectorsService, log: KernelLogger, txHost: TransactionHost);
+    /** The kernel-schema handle of the current context (the transaction, else the pool). */
+    private get db();
     /** The upgrade preview (see the class comment). */
     preview(orgId: string, actor: string, installId: string, version: string): Promise<UpgradePreview>;
+    /** Re-checks the actor's org actions under the org row lock (a transaction of its own). */
+    private authorizeActions;
     /**
      * The checks of {@link upgrade} before an approval request (the org catalog service creates one
      * for a needs_approval item without a grant): the diff with the input, the `diffHash`. Returns
@@ -197,6 +229,29 @@ export declare class PluginUpgrader {
      * `interrupted`), audit `plugin.org_upgrade_failed`. Nothing to do otherwise.
      */
     private recoverInterrupted;
+    /** The upgrade's start: the install `upgrading` with an empty journal (a transaction of its own). */
+    private start;
+    /** A skill step's ledger and journal rows, in a transaction of their own. */
+    private journalSkill;
+    /**
+     * An agent template step: the new version (or template) and its ledger and journal rows, under
+     * the org row lock, in a transaction of their own.
+     */
+    private upgradeAgentTemplate;
+    /** One ledger record (and its journal row) in a transaction of its own. */
+    private recordStep;
+    /** A component's ledger row and its journal step, in the transaction of the context. */
+    private recordIn;
+    /**
+     * The upgrade's last transaction (under the org row lock): the changed connectors, the removals,
+     * the pinned suggestions and the version switch, `plugin.org_upgraded`. `onFinish` marks the step
+     * once the connectors are applied.
+     */
+    private finish;
+    /** Undoes a failed upgrade's journal (see {@link failed}) in a transaction of its own. */
+    private undoFailed;
+    /** Undoes an interrupted upgrade (see {@link recoverInterrupted}) in a transaction of its own. */
+    private undoInterrupted;
     /**
      * The removals of an upgrade, in the final transaction, by the uninstall rules
      * (`decideRemovalIn`): only components this install created are removed, and only when nothing