@cat-factory/kernel 0.57.0 → 0.58.0

package/dist/ports/environment-repositories.d.ts

@@ -1,39 +1,58 @@
 import type { EnvironmentStatus } from '../domain/types.js';
 /**
- * A workspace's binding to an environment provider: the validated manifest and
- * the encrypted per-tenant secret bundle (the management-API credentials). The
- * bundle is decrypted only in-memory, at call time, by the provisioning path.
+ * A workspace's per-provision-type infra HANDLER: how a service's declared provision type
+ * (the "what + where") is stood up (the "how"). Keyed by `(workspaceId, provisionType,
+ * manifestId)` — a workspace declares one handler per type, plus one per pinned custom
+ * `manifestId`. The serialized {@link handlerJson} (the engine connection, sans secrets) and
+ * the encrypted secret bundle are decrypted/built only in-memory, at provision time. See
+ * docs/initiatives/per-service-provision-types.md.
+ *
+ * `manifestId` is `null` for the non-custom types; on SQLite/Postgres it sits in the
+ * composite primary key as the `''` sentinel (the repos map `'' ⇄ null`), exactly like
+ * {@link EnvironmentUserHandlerRecord}.
  */
 export interface EnvironmentConnectionRecord {
     workspaceId: string;
+    /** The provision type this handler serves (`kubernetes` | `docker-compose` | `custom`). */
+    provisionType: string;
+    /** For `custom`: which manifest id this handler is keyed to; `null` otherwise. */
+    manifestId: string | null;
+    /** The engine that handles the type (`local-docker` | `local-k3s` | `remote-kubernetes` | `remote-custom`). */
+    engine: string;
     /**
-     * Which backend kind interprets this connection (`manifest` | `kubernetes` | …).
-     * Selects the registered environment-backend provider; absent rows default to
-     * `manifest`. Mirrors `RunnerPoolConnectionRecord.kind`.
+     * The environment-backend REGISTRY kind that builds this handler's provider (`manifest` |
+     * `kubernetes` | `compose` | a custom kind). Distinct from {@link engine}: several backends
+     * can serve the same engine (e.g. a custom backend riding `remote-custom`), so the engine
+     * alone can't recover the exact provider — the registry is keyed by this kind.
      */
-    kind: string;
+    backendKind: string;
     providerId: string;
     label: string;
     baseUrl: string;
     /**
-     * The stored manifest, serialized as JSON. For a native backend (e.g. `kubernetes`)
-     * the per-workspace settings ride the manifest's `providerConfig` bag — the backend
-     * registry builds + reads it. See `backend/docs/native-environment-adapter.md`.
+     * The serialized handler config (an `InfraHandlerConfig` — the engine connection, sans
+     * secrets), as JSON. A native engine (`local-k3s`/`remote-kubernetes`) carries only the
+     * apiserver/sizing here; the manifests to apply come from the SERVICE at provision time
+     * (the deployer merges the two). Renamed from the pre-reshape `manifestJson`.
      */
-    manifestJson: string;
+    handlerJson: string;
+    /** For a `remote-custom` engine: the custom manifest id this provider accepts; `null` otherwise. */
+    acceptsManifestId: string | null;
     /** Ciphertext of the `{ key: value }` secret bundle (SecretCipher envelope). */
     secretsCipher: string;
     createdAt: number;
-    /** Set when the workspace unregisters (tombstone). */
+    /** Set when the workspace unregisters this handler (tombstone). */
     deletedAt: number | null;
 }
 export interface EnvironmentConnectionRepository {
-    /** The workspace's live connection, or null if not registered. */
-    getByWorkspace(workspaceId: string): Promise<EnvironmentConnectionRecord | null>;
-    /** Create or replace the live connection for a workspace. */
+    /** Every live handler the workspace has registered (batched — no per-type point reads). */
+    listByWorkspace(workspaceId: string): Promise<EnvironmentConnectionRecord[]>;
+    /** The live handler for one provision type (+ custom manifest id), or null. */
+    getByWorkspaceAndType(workspaceId: string, provisionType: string, manifestId: string | null): Promise<EnvironmentConnectionRecord | null>;
+    /** Create or replace one handler (keyed by workspace + provisionType + manifestId). */
     upsert(record: EnvironmentConnectionRecord): Promise<void>;
-    /** Tombstone the workspace's connection. */
-    softDelete(workspaceId: string, at: number): Promise<void>;
+    /** Tombstone one handler. */
+    softDelete(workspaceId: string, provisionType: string, manifestId: string | null, at: number): Promise<void>;
 }
 /** A user's override of how a provision type is handled, for a given workspace. */
 export interface EnvironmentUserHandlerRecord {

package/dist/ports/environment-repositories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"environment-repositories.d.ts","sourceRoot":"","sources":["../../src/ports/environment-repositories.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"environment-repositories.d.ts","sourceRoot":"","sources":["../../src/ports/environment-repositories.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/kernel",
-  "version": "0.57.0",
+  "version": "0.58.0",
   "description": "Shared vocabulary, pure logic, and port interfaces for the Agent Architecture Board.",
   "repository": {
     "type": "git",
@@ -24,8 +24,8 @@
     "access": "public"
   },
   "dependencies": {
-    "ai": "^6.0.209",
-    "@cat-factory/contracts": "0.59.0"
+    "ai": "^6.0.214",
+    "@cat-factory/contracts": "0.60.0"
   },
   "devDependencies": {
     "typescript": "7.0.1-rc"