@capybara-hq/kernel 0.1.0-rc.26 → 0.1.0-rc.27

package/dist/catalog/catalog-content.d.ts

@@ -77,6 +77,11 @@ export interface OrgCatalogTemplate {
      * install wizard does not ask for it (an org admin sets it up when switching it on).
      */
     defaultOff: boolean;
+    /**
+     * The template is on in this org right now (a default-off one an admin switched on): the install
+     * asks for its input too, since the install is what creates its connector.
+     */
+    on: boolean;
     /**
      * The template's setup guide in the item's latest version (`GET …/catalog/:itemId/guides/
      * :guideId`), null without one (spec 2026-11-09-setup-guides-v2-design.md §9.3).
@@ -118,7 +123,7 @@ export interface OrgCatalogDetail {
  * A connector template as an org sees it (the install wizard and the upgrade preview's inputs):
  * presets and editable paths, no credentials.
  */
-export declare function orgTemplateView(id: string, file: ConnectorTemplateFile, guide?: OrgCatalogTemplate["guide"]): OrgCatalogTemplate;
+export declare function orgTemplateView(id: string, file: ConnectorTemplateFile, guide?: OrgCatalogTemplate["guide"], on?: boolean): OrgCatalogTemplate;
 /** An item's icon (the latest version's plugin icon). */
 export interface CatalogIcon {
     data: Uint8Array;

package/dist/catalog/catalog-content.js

@@ -16,7 +16,7 @@ import { satisfiesRange } from "./versions.js";
  * A connector template as an org sees it (the install wizard and the upgrade preview's inputs):
  * presets and editable paths, no credentials.
  */
-export function orgTemplateView(id, file, guide = null) {
+export function orgTemplateView(id, file, guide = null, on = true) {
     const t = file.template;
     return {
         id,
@@ -30,6 +30,7 @@ export function orgTemplateView(id, file, guide = null) {
         ownership: t.ownership ??
             (typeof t.auth.ownership === "string" ? t.auth.ownership : null),
         defaultOff: file.defaultEnabled === false,
+        on,
         guide,
     };
 }

package/dist/catalog/org-catalog.service.js

@@ -273,6 +273,9 @@ let OrgCatalogService = class OrgCatalogService {
             throw itemNotFound();
         const m = v.manifest;
         const templates = await readCatalogTemplates(this.storage, v);
+        // Which templates are on in this org now: the install asks for the input of those, a
+        // default-off one an admin switched on included
+        const on = await connectorTemplatesOn(this.db, orgId, itemId, templates.map((t) => t.id));
         // where each template's page finds its setup guide (spec 2026-11-09-setup-guides-v2 §9.3)
         const guideOf = (templateId) => {
             const g = templateGuideOf(m, templateId);
@@ -290,7 +293,7 @@ let OrgCatalogService = class OrgCatalogService {
             item,
             hasIcon: m.icon !== undefined,
             extension: m.extension ? m.name : null,
-            templates: templates.map((t) => orgTemplateView(t.id, t.file, guideOf(t.id))),
+            templates: templates.map((t) => orgTemplateView(t.id, t.file, guideOf(t.id), on.has(t.id))),
             dependencies: [
                 ...(m.dependencies ?? []).map((d) => ({ name: d.name, range: d.version })),
                 ...implied.map((d) => ({ name: d.name, range: d.range, implied: true })),
@@ -298,7 +301,7 @@ let OrgCatalogService = class OrgCatalogService {
             skills: (m.skills ?? []).map((s) => packagePath(s.path)),
             agents: (m.agents ?? []).map((a) => packagePath(a.path)),
             missingTemplates: item.installed !== null && item.state === "needs_config"
-                ? ((await this.pluginInstaller.missingConnectors(orgId, itemId))?.templates ?? []).map((t) => orgTemplateView(t.id, t.file, guideOf(t.id)))
+                ? ((await this.pluginInstaller.missingConnectors(orgId, itemId))?.templates ?? []).map((t) => orgTemplateView(t.id, t.file, guideOf(t.id), true))
                 : [],
         };
     }

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

@@ -540,6 +540,11 @@ export declare class PluginInstaller {
             file: ConnectorTemplateFile;
         }[];
     } | undefined>;
+    /**
+     * The org's live connector made from one of the plugin's connector templates, if any: an
+     * uninstall keeps a connector its agents use, and the plugin's next switch-on reuses it.
+     */
+    private liveTemplateConnector;
     /**
      * Creates the connectors an installed plugin is missing (ruling P2-10, `POST …/catalog/:itemId/
      * connectors`): `input.connectors` names some of {@link missingConnectors}' templates with the

package/dist/catalog/plugin-install.js

@@ -484,6 +484,10 @@ let PluginInstaller = class PluginInstaller {
                 // The kernel installs only what needs no org input (the scope sync's `needs_config` rule)
                 if (actor === null)
                     throw systemNeedsInput(manifest.name);
+                // An earlier switch-off kept this template's connector: the install takes it back, so its
+                // input is not asked for here (the connector keeps its endpoint and credentials)
+                if ((await this.liveTemplateConnector(orgId, itemId, ct.id)) !== undefined)
+                    continue;
                 connectors.set(ct.id, this.planConnector(actor, { itemId, version, name: manifest.name }, ct, input, at, approvedBy));
             }
         }
@@ -743,9 +747,24 @@ let PluginInstaller = class PluginInstaller {
             }
             step = "connectors";
             for (const ct of plan.templates) {
+                // An earlier switch-off kept this template's connector (its agents use it): the plugin
+                // takes it back instead of creating a second one, whose default slug the first holds
+                const existing = await this.liveTemplateConnector(orgId, itemId, ct.id);
+                if (existing !== undefined) {
+                    await record({
+                        kind: "connector",
+                        ref: existing,
+                        created: false,
+                        skillVersion: null,
+                        templateId: ct.id,
+                    });
+                    continue;
+                }
                 const ci = plan.connectors.get(ct.id);
+                // No input was needed (a live connector was taken back above, or the template was skipped
+                // at plan time): nothing to create
                 if (!ci)
-                    throw new ApiError("internal", `Connector template ${ct.id} was not planned`);
+                    continue;
                 if (actor === null)
                     throw systemNeedsInput(manifest.name);
                 const r = await this.connectors.create(orgId, actor, ci, opts.actorTokenId);
@@ -1657,6 +1676,23 @@ let PluginInstaller = class PluginInstaller {
             templates: all.filter((t) => on.has(t.id) && !made.has(t.id)),
         };
     }
+    /**
+     * The org's live connector made from one of the plugin's connector templates, if any: an
+     * uninstall keeps a connector its agents use, and the plugin's next switch-on reuses it.
+     */
+    async liveTemplateConnector(orgId, itemId, templateId) {
+        const row = await this.db
+            .selectFrom("connectors as c")
+            .innerJoin("platform_connector_templates as p", "p.id", "c.platform_template_id")
+            .select("c.id")
+            .where("c.org_id", "=", orgId)
+            .where("c.deleted_at", "is", null)
+            .where("p.catalog_item_id", "=", itemId)
+            .where("p.template_id", "=", templateId)
+            .orderBy("c.created_at")
+            .executeTakeFirst();
+        return row?.id;
+    }
     /**
      * Creates the connectors an installed plugin is missing (ruling P2-10, `POST …/catalog/:itemId/
      * connectors`): `input.connectors` names some of {@link missingConnectors}' templates with the

package/dist/tools/connectors.service.js

@@ -287,10 +287,6 @@ let ConnectorsService = class ConnectorsService {
     checkCreateInput(actorAccountId, input) {
         const slug = this.resolveSlug(input);
         const endpoint = this.parseEndpoint(input.connector, input.endpoint);
-        // a defaulted slug skips plugin names itself (`freeName`)
-        if (!input.slugDefault && this.extensions.manifests().some((m) => m.name === slug)) {
-            throw fail("slug", `Slug "${slug}" is the name of an installed plugin; choose another`);
-        }
         const auth = input.auth;
         const credential = input.credential ?? undefined;
         if (!isOAuth(auth)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capybara-hq/kernel",
-  "version": "0.1.0-rc.26",
+  "version": "0.1.0-rc.27",
   "description": "Capybara kernel: config, database, plugin host and HTTP API of the Capybara agent platform",
   "license": "Apache-2.0",
   "repository": {